Claude Code VS Code 扩展接第三方 API:environmentVariables 配置教程
Wokey Team · 2026-09-24
结论先说: Claude Code 的 VS Code 扩展接第三方 API,要把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 写进 VS Code 用户设置里的 claudeCode.environmentVariables,并打开 claudeCode.disableLoginPrompt。在终端里 export 对扩展基本无效;写在 ~/.claude/settings.json 也不够,因为扩展启动前的登录检查读不到它,会一直弹出登录页面。
配置步骤
- 安装扩展。VS Code 版本需要 1.94.0 或更高,在扩展面板(
Cmd/Ctrl+Shift+X)搜索「Claude Code」,发布者是 Anthropic。Cursor 也能装同一个扩展,VSCodium 等编辑器可以从 Open VSX 安装。 - 按
Cmd/Ctrl+Shift+P打开命令面板,运行 Preferences: Open User Settings (JSON)。 - 在最外层的
{}里加入:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "你的 Wokey API Key" }
],
"claudeCode.disableLoginPrompt": true
}
- 命令面板运行 Developer: Reload Window 重新加载窗口,再打开 Claude Code 面板。
要注意三点:
ANTHROPIC_BASE_URL只写域名,不要带/v1,扩展会自己拼上/v1/messages。- 这里写的是用户设置,不要写进工作区的
.vscode/settings.json,那个文件经常被提交到仓库。 disableLoginPrompt用来跳过登录提示,官方说明就是「用于第三方 provider 配置」。
为什么 export 和 settings.json 不够
扩展在启动 Claude 进程之前,会先检查有没有可用的凭证。这一步只读 claudeCode.environmentVariables:
- 从 Dock、开始菜单或桌面图标打开的 VS Code,拿不到你在
~/.zshrc里export的变量。 ~/.claude/settings.json里的env能传给扩展启动的 Claude 进程,但到不了扩展自己的登录检查。
所以只写 settings.json、又没打开 disableLoginPrompt 时,常见的现象是「扩展一直要求登录」。想临时用 shell 变量,可以在设置好变量的终端里运行 code . 启动 VS Code,但长期还是写进用户设置更稳。
确认已经走 Wokey
在扩展的输入框里运行 /status(需要 Claude Code v2.1.280 或更高),Status 页里的 Anthropic base URL 应该显示 https://api.wokey.ai。
选模型
在命令菜单里选 Switch model…,或者直接点输入框下方的模型名。要固定 Opus、Sonnet、Haiku 三档分别对应哪个模型,把变量加进同一个列表:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "你的 Wokey API Key" },
{ "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
{ "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" }
]
}
第三方模式下用不了的功能
扩展接第三方 API 后,依赖 claude.ai 账号的功能都不提供:
- 套餐用量条、语音输入,以及云端会话的 Web 标签页。
- 菜单里没有 Sign out。
/bug提交会报错,什么也不会发送。
之前用 /login 登录过的 claude.ai 账号会保留,但不再使用。
和终端里的 CLI 相比,扩展本来就只支持一部分命令,也没有 ! 执行 Bash 的快捷方式和 Tab 补全。
常见问题排查
一直弹出登录页面。 claudeCode.environmentVariables 没写或写错了位置(比如写进了工作区设置),或者改完没有 Reload Window。确认 disableLoginPrompt 也已设为 true。
报 invalid x-api-key。 请求发到了 Anthropic 官方地址,ANTHROPIC_BASE_URL 没生效。Wokey 从不返回这句话,排查方法见 invalid x-api-key 报错指南。
报 404,提示 /v1/v1/messages。 base URL 多写了 /v1,改成 https://api.wokey.ai。
一直没有回复,也没有报错。 官方建议在终端里运行 claude 看更详细的错误。扩展自带一份 CLI,但不会把 claude 加进 PATH,要单独安装 CLI,并按 Claude Code base URL 指南 配置好环境变量。
JetBrains 用户
JetBrains 插件不自带 CLI,它是在 IDE 的终端里运行你已安装的 claude 命令,路径可以在 Settings → Tools → Claude Code [Beta] 的 Claude command 里改。所以 JetBrains 的配置方式就是 CLI 的配置方式:把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 写进 ~/.claude/settings.json 的 env,详见 Claude Code base URL 指南。
常见问题
VS Code 里的 Claude Code 怎么设置 base URL?
在 VS Code 用户设置(JSON)里加 claudeCode.environmentVariables,写入 ANTHROPIC_BASE_URL(https://api.wokey.ai,不带 /v1)和 ANTHROPIC_AUTH_TOKEN,再把 claudeCode.disableLoginPrompt 设为 true,最后 Reload Window。
为什么扩展一直弹出登录页面?
扩展启动前的登录检查只读 claudeCode.environmentVariables,读不到终端变量和 ~/.claude/settings.json。把变量写进用户设置、打开 disableLoginPrompt,再重新加载窗口。
能写进工作区的 .vscode/settings.json 吗?
不建议。工作区设置经常被提交到仓库,会泄露 key。写在用户设置里即可对所有项目生效。
JetBrains 插件怎么配置?
JetBrains 插件运行的是你安装的 claude 命令,所以和 CLI 配置方式相同:把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 写进 ~/.claude/settings.json 的 env。