Skip to content

Document agent name customization for the Claude Code plugin #2760

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
anastasiaguspan merged 2 commits into from
Jun 15, 2026
+9 −0
Merged

Document agent name customization for the Claude Code plugin #2760

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
beacfc6
Document customizable agent_name for Claude Code plugin
rgao-coreweave Jun 12, 2026
919cac8
Merge remote-tracking branch 'origin/main' into weave-claude-code-age…
rgao-coreweave Jun 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions weave/guides/integrations/agents/claude-code-harness.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,8 @@ invoke_agent claude-code (Root, one trace per user prompt.)
└─ execute_tool <tool_name>
```

The root `invoke_agent claude-code` span uses the top-level agent name, which defaults to `claude-code`. You can change it with the `agent_name` setting or the `WEAVE_AGENT_NAME` environment variable (see [Configure the plugin](#configure-the-plugin)). Subagents keep their own type names.

Multi-turn conversations are linked server-side by session ID, so you can follow a conversation across multiple traces. Each span includes token usage, model name, tool inputs and outputs, timing, and the textual content of prompts and responses. For more information about traced data, see [What Gets Traced](https://github.com/wandb/weave-claude-code/blob/main/README.md#what-gets-traced) in GitHub.

## Configure the plugin
Expand All @@ -102,13 +104,19 @@ weave-claude-code config set weave_project [YOUR-TEAM]/[YOUR-PROJECT]

# Set your W&B API key.
weave-claude-code config set wandb_api_key [YOUR-API-KEY]

# (Optional) Customize the agent name shown in the Agents view.
weave-claude-code config set agent_name [YOUR-AGENT-NAME]
```

By default, sessions appear under the agent name `claude-code` in the Agents view. Set `agent_name` to use a different name, for example to distinguish teams or projects. The name can't be empty, and surrounding whitespace is trimmed.

Environment variables take precedence over the settings file:

```bash lines
export WEAVE_PROJECT=[YOUR-TEAM]/[YOUR-PROJECT]
export WANDB_API_KEY=[YOUR-API-KEY]
export WEAVE_AGENT_NAME=[YOUR-AGENT-NAME]
```

## Weave skills
Expand All @@ -126,6 +134,7 @@ You can use the `weave:weave-config` skill to set Weave values from within Claud
```text
/weave:weave-config set weave_project [YOUR-TEAM]/[YOUR-PROJECT]
/weave:weave-config set wandb_api_key [YOUR-API-KEY]
/weave:weave-config set agent_name [YOUR-AGENT-NAME]
```

## Check plugin status
Expand Down
Loading