trace-claude-code

Braintrust Claude Code Marketplace

A Claude Code plugin marketplace for Braintrust integration - LLM evaluation, logging, observability, and session tracing.

Prerequisites

• A Braintrust account
• BRAINTRUST_API_KEY exported in your environment

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"