Skip to content

docs: add VS Code extension setup for Claude Code with Bifrost#2875

Closed
BearTS wants to merge 1 commit intographite-base/2875from
04-21-docs_add_docs_for_claude_code_vscode_plugin
Closed

docs: add VS Code extension setup for Claude Code with Bifrost#2875
BearTS wants to merge 1 commit intographite-base/2875from
04-21-docs_add_docs_for_claude_code_vscode_plugin

Conversation

@BearTS
Copy link
Copy Markdown
Contributor

@BearTS BearTS commented Apr 20, 2026

Summary

Adds documentation for setting up Claude Code with the VS Code extension, pointing it to Bifrost as the backend endpoint.

Changes

  • Added a new "Setup with the VS Code extension" section to the Claude Code docs, covering how to install the extension and configure the claudeCode.environmentVariables settings to route requests through Bifrost, including ANTHROPIC_BASE_URL, ANTHROPIC_DEFAULT_SONNET_MODEL, and ANTHROPIC_DEFAULT_HAIKU_MODEL, with a note on handling ANTHROPIC_API_KEY for virtual key setups.

Type of change

  • Bug fix
  • Feature
  • Refactor
  • Documentation
  • Chore/CI

Affected areas

  • Core (Go)
  • Transports (HTTP)
  • Providers/Integrations
  • Plugins
  • UI (React)
  • Docs

How to test

  1. Navigate to the Claude Code docs page.
  2. Verify the new "Setup with the VS Code extension" section appears between the CLI authentication section and the "Amazon Bedrock via Bifrost" section.
  3. Confirm the JSON config snippet renders correctly and the extension marketplace link resolves.

Breaking changes

  • Yes
  • No

Related issues

Security considerations

The ANTHROPIC_API_KEY guidance instructs users to use their Bifrost virtual key value or set it to dummy when virtual keys are not enabled. No secrets are hardcoded in the documentation.

Checklist

  • I read docs/contributing/README.md and followed the guidelines
  • I added/updated tests where appropriate
  • I updated documentation where needed
  • I verified builds succeed (Go and UI)
  • I verified the CI pipeline passes locally if applicable

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 20, 2026

📝 Walkthrough

Walkthrough

Documentation addition for VS Code extension configuration of Claude Code. Introduces setup instructions and a settings.json snippet that configures Anthropic API environment variables, including base URL and default model tier selections, with conditional guidance for API key management.

Changes

Cohort / File(s) Summary
VS Code Configuration Documentation
docs/cli-agents/claude-code.mdx
Added new section with VS Code extension setup steps and settings.json configuration snippet for Anthropic API environment variables and model tier defaults.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A doc update hops along with care,
VS Code settings float through the air,
Anthropic keys and models now shown,
Configuration paths clearly sown! ✨

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Linked Issues check ⚠️ Warning The pull request addresses VS Code extension documentation for Claude Code, but the linked issue #123 requires Files API support for OpenAI/Anthropic providers. The changes do not implement any Files API functionality. Either link the correct issue related to VS Code documentation, or ensure this PR implements the Files API requirements specified in issue #123.
Out of Scope Changes check ⚠️ Warning The PR is a documentation-only change for VS Code Claude Code setup, but is linked to issue #123 about implementing Files API support. This documentation change is out of scope for the Files API feature requirements. Clarify the correct linked issue or separate this documentation change from the Files API implementation work.
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely describes the main change: adding VS Code extension setup documentation for Claude Code with Bifrost integration.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check ✅ Passed The PR description covers all major template sections with appropriate detail for a documentation-only change.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch 04-21-docs_add_docs_for_claude_code_vscode_plugin

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor Author

BearTS commented Apr 20, 2026

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.
Learn more

This stack of pull requests is managed by Graphite. Learn more about stacking.

@BearTS BearTS mentioned this pull request Apr 20, 2026
18 tasks
@BearTS BearTS marked this pull request as ready for review April 20, 2026 21:30
@BearTS BearTS changed the title docs: add docs for claude code vscode plugin docs: add VS Code extension setup for Claude Code with Bifrost Apr 20, 2026
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 20, 2026

Confidence Score: 4/5

One P1 doc error (wrong settings key) should be fixed before merging to avoid misleading users.

The incorrect VS Code settings key claudeCode.environmentVariables vs the correct claude-code.environmentVariables would cause users to silently misconfigure the extension — a clear factual error in user-facing documentation.

docs/cli-agents/claude-code.mdx — incorrect VS Code settings key in the JSON configuration block

Important Files Changed

Filename Overview
docs/cli-agents/claude-code.mdx Adds VS Code extension setup section, but uses incorrect settings key claudeCode.environmentVariables instead of the correct claude-code.environmentVariables.

Reviews (1): Last reviewed commit: "docs: add docs for claude code vscode pl..." | Re-trigger Greptile

Comment on lines +50 to +64
"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"
}
]
}
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Wrong VS Code settings key

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.

Suggested change
"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)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Missing Windows/Linux keyboard shortcut

Only the macOS shortcut is mentioned. Windows and Linux users use Ctrl+Shift+X.

Suggested change
1. Open **Extensions** in VS Code (`Cmd+Shift+X` on macOS)
1. Open **Extensions** in VS Code (`Cmd+Shift+X` on macOS, `Ctrl+Shift+X` on Windows/Linux)

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

📥 Commits

Reviewing files that changed from the base of the PR and between 4fdd841 and ce039eb.

📒 Files selected for processing (1)
  • docs/cli-agents/claude-code.mdx

Comment on lines +48 to +65
```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"
}
]
}
```
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

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.

@akshaydeo akshaydeo changed the base branch from 04-21-v1.5.0-prerelease4_cut to graphite-base/2875 April 20, 2026 21:52
@akshaydeo akshaydeo closed this Apr 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants