docs: add VS Code extension setup for Claude Code with Bifrost#2875
docs: add VS Code extension setup for Claude Code with Bifrost#2875BearTS wants to merge 1 commit intographite-base/2875from
Conversation
📝 WalkthroughWalkthroughDocumentation addition for VS Code extension configuration of Claude Code. Introduces setup instructions and a Changes
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~3 minutes Poem
🚥 Pre-merge checks | ✅ 3 | ❌ 2❌ Failed checks (2 warnings)
✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Comment |
|
Warning This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
This stack of pull requests is managed by Graphite. Learn more about stacking. |
Confidence Score: 4/5One P1 doc error (wrong settings key) should be fixed before merging to avoid misleading users. The incorrect VS Code settings key docs/cli-agents/claude-code.mdx — incorrect VS Code settings key in the JSON configuration block Important Files Changed
Reviews (1): Last reviewed commit: "docs: add docs for claude code vscode pl..." | Re-trigger Greptile |
| "claudeCode.environmentVariables": [ | ||
| { | ||
| "name": "ANTHROPIC_BASE_URL", | ||
| "value": "http://localhost:8080/anthropic" | ||
| }, | ||
| { | ||
| "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", | ||
| "value": "vertex/claude-sonnet-4-6" | ||
| }, | ||
| { | ||
| "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", | ||
| "value": "vertex/claude-haiku-4-5" | ||
| } | ||
| ] | ||
| } |
There was a problem hiding this comment.
The key claudeCode.environmentVariables does not exist in the Claude Code extension. The correct key is claude-code.environmentVariables (kebab-case), as confirmed by the official VS Code setup docs. Using the wrong key will silently have no effect — the environment variables will never be passed to the Claude process.
| "claudeCode.environmentVariables": [ | |
| { | |
| "name": "ANTHROPIC_BASE_URL", | |
| "value": "http://localhost:8080/anthropic" | |
| }, | |
| { | |
| "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", | |
| "value": "vertex/claude-sonnet-4-6" | |
| }, | |
| { | |
| "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", | |
| "value": "vertex/claude-haiku-4-5" | |
| } | |
| ] | |
| } | |
| { | |
| "claude-code.environmentVariables": [ | |
| { | |
| "name": "ANTHROPIC_BASE_URL", | |
| "value": "http://localhost:8080/anthropic" | |
| }, | |
| { | |
| "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", | |
| "value": "vertex/claude-sonnet-4-6" | |
| }, | |
| { | |
| "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", | |
| "value": "vertex/claude-haiku-4-5" | |
| } | |
| ] | |
| } |
|
|
||
| ### 1. Install the extension | ||
|
|
||
| 1. Open **Extensions** in VS Code (`Cmd+Shift+X` on macOS) |
There was a problem hiding this comment.
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@docs/cli-agents/claude-code.mdx`:
- Around line 48-65: Add the missing Opus tier env var to the VS Code example
JSON: insert an object with "name": "ANTHROPIC_DEFAULT_OPUS_MODEL" and an
appropriate example value (e.g., "vertex/claude-opus-4-6") into the array
alongside ANTHROPIC_DEFAULT_SONNET_MODEL and ANTHROPIC_DEFAULT_HAIKU_MODEL in
the claude-code.mdx code block so all three tiers (Sonnet, Opus, Haiku) are
shown; ensure the new entry follows the same object structure as the others.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: be1cd71a-9a1f-49cd-9b76-1f10c329be8d
📒 Files selected for processing (1)
docs/cli-agents/claude-code.mdx
| ```json | ||
| { | ||
| "claudeCode.environmentVariables": [ | ||
| { | ||
| "name": "ANTHROPIC_BASE_URL", | ||
| "value": "http://localhost:8080/anthropic" | ||
| }, | ||
| { | ||
| "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", | ||
| "value": "vertex/claude-sonnet-4-6" | ||
| }, | ||
| { | ||
| "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", | ||
| "value": "vertex/claude-haiku-4-5" | ||
| } | ||
| ] | ||
| } | ||
| ``` |
There was a problem hiding this comment.
Add ANTHROPIC_DEFAULT_OPUS_MODEL to complete the example.
The example configuration is missing the Opus tier variable. Line 165 documents that Claude Code uses three model tiers (Sonnet, Opus, and Haiku), and line 176 shows ANTHROPIC_DEFAULT_OPUS_MODEL is supported. For consistency and completeness, include all three tier variables in the VS Code configuration example.
Based on learnings, the documented environment variables match the implementation in cli/internal/harness/native_config.go.
📝 Proposed fix to add the missing environment variable
{
"name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
"value": "vertex/claude-haiku-4-5"
+ },
+ {
+ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
+ "value": "vertex/claude-opus-4-5-20251101"
}
]
}🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.
In `@docs/cli-agents/claude-code.mdx` around lines 48 - 65, Add the missing Opus
tier env var to the VS Code example JSON: insert an object with "name":
"ANTHROPIC_DEFAULT_OPUS_MODEL" and an appropriate example value (e.g.,
"vertex/claude-opus-4-6") into the array alongside
ANTHROPIC_DEFAULT_SONNET_MODEL and ANTHROPIC_DEFAULT_HAIKU_MODEL in the
claude-code.mdx code block so all three tiers (Sonnet, Opus, Haiku) are shown;
ensure the new entry follows the same object structure as the others.

Summary
Adds documentation for setting up Claude Code with the VS Code extension, pointing it to Bifrost as the backend endpoint.
Changes
claudeCode.environmentVariablessettings to route requests through Bifrost, includingANTHROPIC_BASE_URL,ANTHROPIC_DEFAULT_SONNET_MODEL, andANTHROPIC_DEFAULT_HAIKU_MODEL, with a note on handlingANTHROPIC_API_KEYfor virtual key setups.Type of change
Affected areas
How to test
Breaking changes
Related issues
Security considerations
The
ANTHROPIC_API_KEYguidance instructs users to use their Bifrost virtual key value or set it todummywhen virtual keys are not enabled. No secrets are hardcoded in the documentation.Checklist
docs/contributing/README.mdand followed the guidelines