VS Code 里的 Claude Code 配置中转站

先对号入座。同一台电脑上这三样可以同时存在，但各读各的配置：

扩展自带一份命令行程序，只给面板用，不会加进 PATH；在集成终端里敲 claude 用的是你另外安装的那一份。这就是两边要分别配置的原因。还没装命令行，先看 国内怎么用 Claude Code；只用命令行、不用编辑器，看 Claude Code 配置第三方 API 就够了。

VS Code 1.94.0 或更高版本（Help > About 里看版本号），和一把本站密钥。密钥在 控制台 创建，以 sk-relay- 开头；邮箱开通，USDT 或银行卡充值，最低 $10，按 token 从预付余额扣费。购买和充值的细节在 Claude API Key 购买与充值。

用 API 密钥这条路不需要 claude.ai 账号或订阅。建议给编辑器单独建一把密钥，顺手设一个美元预算。

1. 按 Ctrl+Shift+X（macOS 是 Cmd+Shift+X）打开扩展视图。
2. 搜索 Claude Code，认准发布者是 Anthropic，点 Install。
3. 装完没看到图标，就在命令面板里运行 Developer: Reload Window，或者重启 VS Code。

扩展的版本号就是它内置的 Claude Code 版本号，扩展视图里能看到。这时打开面板会出现登录界面，先不用管，下一步填完就不再出现。

1. 按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）打开命令面板。
2. 运行 Preferences: Open User Settings (JSON)，打开的是用户级的 settings.json。
3. 把下面这一项加进去（文件里已有别的设置时，只加 claudeCode.environmentVariables 这个键，注意逗号），密钥换成你自己的，保存。

为什么是这里：按 Claude Code 的 网关接入页，扩展在启动前先检查这项设置里的凭据；写在 ~/.claude/settings.json 里的值能传给它启动的进程，却到不了扩展自己的登录检查。所以只配了命令行的人，打开面板看到的还是登录界面。

地址填 https://api.relayswitch.io/v1。Claude Code 会在后面拼 /v1/messages，本站网关对重复的 /v1 做了兼容，带不带都能用。密钥变量只写 ANTHROPIC_AUTH_TOKEN 一个，它以 Authorization: Bearer 发送。

1. 命令面板里运行 Developer: Reload Window。
2. 打开面板：点编辑器右上角工具栏里的 Spark 图标（要先打开一个文件才会出现），或者点窗口右下角状态栏的 ✻ Claude Code。
3. 不再出现登录界面，直接发一句话。几秒后，这条请求出现在控制台的用量页，带模型 id、计费 tokens 和费用。

扩展 2.1.280 及以上，在输入框里敲 /status 可以看到会话的版本、账号和当前模型。还是出现登录界面，多半是这一项写进了工作区设置而不是用户设置，或者 JSON 少了逗号导致整份设置没被读取，VS Code 会在文件里用波浪线标出语法错误。

设置里还有一个 claudeCode.disableLoginPrompt（Disable Login Prompt），官方对它的说明是“跳过登录提示，用于第三方平台的部署”，文档里配的是 Amazon Bedrock 这类平台。走 ANTHROPIC_BASE_URL 接网关，官方只要求上面那一项，一般用不到它。

按 Ctrl+`（macOS 是 Cmd+`）打开集成终端，运行 claude。这是独立安装的命令行，不读上一步的 VS Code 设置。把同样两个变量写进用户级的 ~/.claude/settings.json（Windows 是 %USERPROFILE%\.claude\settings.json）：

三个 ANTHROPIC_DEFAULT_*_MODEL 决定 /model 里 opus、sonnet、haiku 各指向哪个 id，可以不写。这个文件扩展和命令行共用，权限、钩子、MCP 服务器也在这里配。

启动后运行 /status，Status 页上应当有 Anthropic base URL 一行显示 https://api.relayswitch.io/v1，以及 Auth token 一行写着来源是 ANTHROPIC_AUTH_TOKEN。扩展已经装好时，集成终端里的命令行会自动连上它，改动以编辑器里的 diff 呈现；在外部终端里则运行 /ide 来连接。

桌面版不读 ANTHROPIC_BASE_URL，也不读 settings.json。官方把它接网关的方式叫第三方推理配置（third-party inference），可以由企业管理员统一下发，也可以在本机的表单里自己填。自己填的步骤：

1. 菜单栏里依次点 Help → Troubleshooting → Enable Developer Mode，应用重启后多出一个 Developer 菜单。Windows 上的菜单在登录界面左上角的 ☰ 里。
2. 点 Developer → Configure Third-Party Inference…，在 Connection 一栏把 Inference provider 选成 Gateway。
3. 按下表填 Gateway credentials 卡片。
4. 点 Apply Changes，配置只写入这台设备，应用重启后生效。

几点官方写明的行为：模型列表默认从网关的 /v1/models 自动发现，只显示能认出是 Claude 的 id；设备上已有管理员下发的配置时，这个表单是只读的；网关配置生效后，环境选择器里不再有 Anthropic 托管的云端环境，Remote Control 也不可用。启动时提示 Gateway was unreachable，说明应用没连上填的地址，先核对地址有没有写错。

桌面版更新很快，这一节只照 应用内配置 和 网关部署 两页官方文档转述，菜单对不上时以官方文档为准。想要最省事的路径，还是命令行加 VS Code 扩展。

下表是此刻目录里 Claude Code 能调用的 13 个 Claude id，价格渲染时读取。扩展和命令行用同一把密钥、同一份价格，没有倍率：表里的美元价就是扣减价，人民币是参考价。

全部模型见 模型与价格，充值步骤见 充值页。

面板一直让登录：检查 claudeCode.environmentVariables 是不是写在用户设置里，两个变量名有没有拼错，改完有没有重载窗口。

命令行能用、扩展不能用，或者反过来：两边读的不是同一份配置，回到第一节的表逐个核对。两处填了不同的密钥变量也会出问题：同一个请求里带着两个值不同的密钥时，网关返回 400，提示请求里带了不止一个密钥。每处只留 ANTHROPIC_AUTH_TOKEN。

能连上但报错：401 是密钥不对，402 是余额或这把密钥的预算用完，其余按状态码查 Claude Code 报错速查，403 有 单独的一页。扩展自身的问题（图标不见、面板空白、快捷键无效）在 官方的 VS Code 文档 末尾有逐条的处理办法。

手上有好几个地址和密钥要来回切换，用 CC Switch 管理命令行那一侧的配置更省事。