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 也不够,因为扩展启动前的登录检查读不到它,会一直弹出登录页面。

配置步骤

  1. 安装扩展。VS Code 版本需要 1.94.0 或更高,在扩展面板(Cmd/Ctrl+Shift+X)搜索「Claude Code」,发布者是 Anthropic。Cursor 也能装同一个扩展,VSCodium 等编辑器可以从 Open VSX 安装。
  2. 按 Cmd/Ctrl+Shift+P 打开命令面板,运行 Preferences: Open User Settings (JSON)。
  3. 在最外层的 {} 里加入:
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "你的 Wokey API Key" }
  ],
  "claudeCode.disableLoginPrompt": true
}
  1. 命令面板运行 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。