Skip to content

Commit b50acae

Browse files
jverreclaude
andcommitted
docs: document the [opik_cc] config section for plugin-scoped overrides
Document how to set a separate workspace/project for Claude Code traces via an [opik_cc] section in ~/.opik.config, and note that it must be placed below [opik] since later keys override earlier ones in the current parser. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 7bd0717 commit b50acae

1 file changed

Lines changed: 13 additions & 6 deletions

File tree

README.md

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -65,19 +65,26 @@ All plugin env vars use the `OPIK_CC_` prefix to avoid conflicts with standard O
6565

6666
`OPIK_CC_WORKSPACE` and `OPIK_CC_PROJECT` let you send Claude Code traces to a different
6767
workspace/project than the rest of your Opik setup, without touching the global
68-
`OPIK_WORKSPACE` / `project_name` in `~/.opik.config` used by the Opik SDK. Both can also be
69-
set in `~/.opik.config` via the plugin-scoped `cc_workspace` and `cc_project` keys:
68+
`OPIK_WORKSPACE` in your environment. You can also keep the plugin's settings in a dedicated
69+
`[opik_cc]` section of `~/.opik.config`:
7070

7171
```ini
7272
[opik]
73+
url_override = https://www.comet.com/opik/api/
74+
api_key = your-api-key
7375
workspace = my-sdk-workspace # used by the Opik SDK
7476
project_name = my-sdk-project # used by the Opik SDK
75-
cc_workspace = my-cc-workspace # used only by the Claude Code plugin
76-
cc_project_name = my-cc-project # used only by the Claude Code plugin
77+
78+
[opik_cc]
79+
workspace = comet-all # used by the Claude Code plugin
80+
project_name = claude-code # used by the Claude Code plugin
7781
```
7882

79-
> Note: for backward compatibility, if `cc_project_name` is not set the plugin still falls back
80-
> to the shared `project_name` key.
83+
> **Place `[opik_cc]` below `[opik]`.** The plugin reads the keys it recognizes (`workspace`,
84+
> `project_name`, `url_override`, `api_key`) from the whole file, with later values overriding
85+
> earlier ones — so the `[opik_cc]` values win only when that section comes last. The
86+
> environment variables (`OPIK_CC_WORKSPACE`, `OPIK_CC_PROJECT`) always take precedence over
87+
> the file.
8188
8289
### External Trace Linking
8390

0 commit comments

Comments
 (0)