Braintrust Claude Code Marketplace
A Claude Code plugin marketplace for Braintrust integration - LLM evaluation, logging, observability, and session tracing.
Prerequisites
Installation
Add the marketplace:
claude plugin marketplace add braintrustdata/braintrust-claude-plugin
Then install the plugins you need:
Plugins
braintrust
Enables AI agents to use Braintrust for LLM evaluation, logging, and observability.
- Query Braintrust projects, experiments, datasets, and logs
- Instrument your code with the Braintrust SDK and write evals
claude plugin install braintrust@braintrust-claude-plugin
trace-claude-code
Automatically traces Claude Code conversations to Braintrust. Captures sessions, conversation turns, and tool calls as hierarchical traces.
claude plugin install trace-claude-code@braintrust-claude-plugin
# run the setup script to confgure tracing
$HOME/.claude/plugins/marketplaces/braintrust-claude-plugin/plugins/trace-claude-code/setup.sh
Traces are sent to the claude-code project by default.
manual configuration
Instead of running setup.sh, you can manually edit ~/.claude/settings.json or your project's .claude/settings.local.json:
{
"env": {
"TRACE_TO_BRAINTRUST": "true",
"BRAINTRUST_CC_PROJECT": "project-name-to-send-cc-traces-to",
"BRAINTRUST_API_KEY": "sk-yourkey",
"BRAINTRUST_DEBUG": "false"
}
}
add claude code trace to an existing trace
You can attach a Claude Code session to an existing Braintrust trace by passing CC_PARENT_SPAN_ID:
claude --settings '{"env":{"CC_PARENT_SPAN_ID":"your-parent-span-id"}}' -p "task"
If the parent span is not the trace root, also pass CC_ROOT_SPAN_ID:
claude --settings '{"env":{"CC_PARENT_SPAN_ID":"parent-span-id","CC_ROOT_SPAN_ID":"root-span-id"}}' -p "task"
The Claude Code session and all its turns/tools will appear as children of your parent span in Braintrust.
To attach claude code to an experiment's trace, specify CC_EXPERIMENT_ID as well:
claude --settings '{"env":{"CC_PARENT_SPAN_ID":"parent-span-id","CC_ROOT_SPAN_ID":"root-span-id", "CC_EXPERIMENT_ID":"the-experiment-id"}}' -p "task"
braintrustdata