--- title: "VS Code 与桌面版 Claude Code 配置中转站" canonical: https://relayswitch.ai/zh/guides/claude-code-vscode generated: 2026-11-12T04:22:54.509Z source: https://api.relayswitch.io/v1/catalog base_url: https://api.relayswitch.io/v1 --- 配置教程 · 核对于 2026-11-11 # VS Code 里的 Claude Code 配置中转站 Claude Code 在 VS Code 里有图形面板，也能在集成终端里跑命令行，另外还有一个桌面版。三者读配置的地方不一样，所以常见的情况是：命令行已经接通中转站，扩展却还在让你登录。下面按入口分别写清楚该填哪里。 ## 01三个入口，三处配置 先对号入座。同一台电脑上这三样可以同时存在，但各读各的配置： | 入口 | 从哪里读地址和密钥 | | --- | --- | | VS Code 扩展（图形面板） | VS Code 用户设置里的 `claudeCode.environmentVariables` | | 集成终端里的 claude | 终端环境变量，或 `~/.claude/settings.json` 的 `env` 块 | | 桌面版 | 应用内的第三方推理配置（Configure Third-Party Inference） | 扩展自带一份命令行程序，只给面板用，不会加进 PATH；在集成终端里敲 `claude` 用的是你另外安装的那一份。这就是两边要分别配置的原因。还没装命令行，先看 [国内怎么用 Claude Code](https://relayswitch.ai/zh/guides/claude-code-china)；只用命令行、不用编辑器，看 [Claude Code 配置第三方 API](https://relayswitch.ai/zh/guides/claude-code) 就够了。 ## 02准备 VS Code 1.94.0 或更高版本（**Help > About** 里看版本号），和一把本站密钥。密钥在 [控制台](https://app.relayswitch.io/console?lang=zh) 创建，以 `sk-relay-` 开头；邮箱开通，USDT 或银行卡充值，最低 $10，按 token 从预付余额扣费。购买和充值的细节在 [Claude API Key 购买与充值](https://relayswitch.ai/zh/claude-api-key)。 用 API 密钥这条路不需要 claude.ai 账号或订阅。建议给编辑器单独建一把密钥，顺手设一个美元预算。 ## 03第一步：安装扩展 1. 按 `Ctrl+Shift+X`（macOS 是 `Cmd+Shift+X`）打开扩展视图。 2. 搜索 Claude Code，认准发布者是 Anthropic，点 **Install**。 3. 装完没看到图标，就在命令面板里运行 **Developer: Reload Window**，或者重启 VS Code。 扩展的版本号就是它内置的 Claude Code 版本号，扩展视图里能看到。这时打开面板会出现登录界面，先不用管，下一步填完就不再出现。 ## 04第二步：在用户设置里填地址和密钥 1. 按 `Ctrl+Shift+P`（macOS 是 `Cmd+Shift+P`）打开命令面板。 2. 运行 **Preferences: Open User Settings (JSON)**，打开的是用户级的 `settings.json`。 3. 把下面这一项加进去（文件里已有别的设置时，只加 `claudeCode.environmentVariables` 这个键，注意逗号），密钥换成你自己的，保存。 json 1`{` 2 `"claudeCode.environmentVariables": [` 3 `{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.relayswitch.io/v1" },` 4 `{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-relay-..." }` 5 `]` 6`}` 为什么是这里：按 Claude Code 的 [网关接入页](https://code.claude.com/docs/en/llm-gateway-connect)，扩展在启动前先检查这项设置里的凭据；写在 `~/.claude/settings.json` 里的值能传给它启动的进程，却到不了扩展自己的登录检查。所以只配了命令行的人，打开面板看到的还是登录界面。 地址填 https://api.relayswitch.io/v1。Claude Code 会在后面拼 `/v1/messages`，本站网关对重复的 `/v1` 做了兼容，带不带都能用。密钥变量只写 `ANTHROPIC_AUTH_TOKEN` 一个，它以 `Authorization: Bearer` 发送。 ## 05第三步：重载窗口并确认接通 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` 接网关，官方只要求上面那一项，一般用不到它。 ## 06第四步：给集成终端里的命令行写 settings.json 按 `` Ctrl+` ``（macOS 是 `` Cmd+` ``）打开集成终端，运行 `claude`。这是独立安装的命令行，不读上一步的 VS Code 设置。把同样两个变量写进用户级的 `~/.claude/settings.json`（Windows 是 `%USERPROFILE%\.claude\settings.json`）： json 1`{` 2 `"env": {` 3 `"ANTHROPIC_BASE_URL": "https://api.relayswitch.io/v1",` 4 `"ANTHROPIC_AUTH_TOKEN": "sk-relay-...",` 5 `"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",` 6 `"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",` 7 `"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"` 8 `}` 9`}` 三个 `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` 来连接。 ## 07桌面版：第三方推理配置 桌面版不读 `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**，配置只写入这台设备，应用重启后生效。 | 字段 | 填什么 | | --- | --- | | Gateway base URL | https://api.relayswitch.io | | Gateway API key | 你的 sk-relay- 密钥 | | Credential kind | Static API key（默认值） | | Gateway auth scheme | Bearer（默认值） | 字段名照官方文档抄录；地址不带 /v1，桌面版请求的是 /v1/messages。 几点官方写明的行为：模型列表默认从网关的 `/v1/models` 自动发现，只显示能认出是 Claude 的 id；设备上已有管理员下发的配置时，这个表单是只读的；网关配置生效后，环境选择器里不再有 Anthropic 托管的云端环境，Remote Control 也不可用。启动时提示 `Gateway was unreachable`，说明应用没连上填的地址，先核对地址有没有写错。 桌面版更新很快，这一节只照 [应用内配置](https://claude.com/docs/third-party/claude-desktop/in-app-configuration) 和 [网关部署](https://claude.com/docs/third-party/claude-desktop/gateway) 两页官方文档转述，菜单对不上时以官方文档为准。想要最省事的路径，还是命令行加 VS Code 扩展。 ## 08可用的 Claude 模型与价格 下表是此刻目录里 Claude Code 能调用的 13 个 Claude id，价格渲染时读取。扩展和命令行用同一把密钥、同一份价格，没有倍率：表里的美元价就是扣减价，人民币是参考价。 | 模型 | 开发商 | 输入 / 百万 | 输出 / 百万 | | --- | --- | --- | --- | | [Claude Fable 5.1](https://relayswitch.ai/zh/models/claude-fable-5.1)claude-fable-5.1 | Anthropic | $6.00≈ ¥40.82 | $30.00≈ ¥204.12 | | [Claude Fable 5.2](https://relayswitch.ai/zh/models/claude-fable-5.2)claude-fable-5.2 | Anthropic | $4.00≈ ¥27.22 | $20.00≈ ¥136.08 | | [Claude Fable 5](https://relayswitch.ai/zh/models/claude-fable-5)claude-fable-5 | Anthropic | $3.00≈ ¥20.41 | $15.00≈ ¥102.06 | | [Claude Opus 5.5](https://relayswitch.ai/zh/models/claude-opus-5-5)claude-opus-5-5 | Anthropic | $2.716≈ ¥18.48 | $9.70≈ ¥66.00 | | [Claude Sonnet 4.6](https://relayswitch.ai/zh/models/claude-sonnet-4-6)claude-sonnet-4-6 | Anthropic | $1.80≈ ¥12.25 | $9.00≈ ¥61.24 | | [Claude Opus 4.6](https://relayswitch.ai/zh/models/claude-opus-4-6)claude-opus-4-6 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Opus 4.7](https://relayswitch.ai/zh/models/claude-opus-4-7)claude-opus-4-7 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Opus 4.8](https://relayswitch.ai/zh/models/claude-opus-4-8)claude-opus-4-8 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Opus 5](https://relayswitch.ai/zh/models/claude-opus-5)claude-opus-5 | Anthropic | $1.80≈ ¥12.25 | $7.50≈ ¥51.03 | | [Claude Haiku 4.5](https://relayswitch.ai/zh/models/claude-haiku-4-5)claude-haiku-4-5 | Anthropic | $0.60≈ ¥4.08 | $3.00≈ ¥20.41 | | [Claude Sonnet 5](https://relayswitch.ai/zh/models/claude-sonnet-5)claude-sonnet-5 | Anthropic | $1.20≈ ¥8.16 | $3.00≈ ¥20.41 | | [Claude Sonnet 5.5](https://relayswitch.ai/zh/models/claude-sonnet-5-5)claude-sonnet-5-5 | Anthropic | $1.20≈ ¥8.16 | $3.00≈ ¥20.41 | | [Claude Haiku 5.5](https://relayswitch.ai/zh/models/claude-haiku-5-5)claude-haiku-5-5 | Anthropic | $0.0582≈ ¥0.396 | $0.1455≈ ¥0.99 | 美元 / 百万 tokens，人民币参考价按 ECB 2026-11-11 汇率 全部模型见 [模型与价格](https://relayswitch.ai/zh/models)，充值步骤见 [充值页](https://relayswitch.ai/zh/pay)。 ## 09排错 面板一直让登录：检查 `claudeCode.environmentVariables` 是不是写在用户设置里，两个变量名有没有拼错，改完有没有重载窗口。 命令行能用、扩展不能用，或者反过来：两边读的不是同一份配置，回到第一节的表逐个核对。两处填了不同的密钥变量也会出问题：同一个请求里带着两个值不同的密钥时，网关返回 400，提示请求里带了不止一个密钥。每处只留 `ANTHROPIC_AUTH_TOKEN`。 能连上但报错：401 是密钥不对，402 是余额或这把密钥的预算用完，其余按状态码查 [Claude Code 报错速查](https://relayswitch.ai/zh/fix/claude-code-api-error)，403 有 [单独的一页](https://relayswitch.ai/zh/fix/claude-code-403)。扩展自身的问题（图标不见、面板空白、快捷键无效）在 [官方的 VS Code 文档](https://code.claude.com/docs/en/vs-code) 末尾有逐条的处理办法。 手上有好几个地址和密钥要来回切换，用 [CC Switch](https://relayswitch.ai/zh/guides/cc-switch) 管理命令行那一侧的配置更省事。 ## 常见问题 VS Code 扩展和命令行要分别配置吗？ 要。扩展在启动前先检查 VS Code 用户设置里的 claudeCode.environmentVariables；集成终端里的 claude 是单独安装的命令行，读的是终端环境变量和 ~/.claude/settings.json。两处都写同一个地址和同一把密钥，哪边启动都能用。 已经写进 ~/.claude/settings.json，扩展为什么还让我登录？ 按 Claude Code 的网关接入页，settings.json 里的值能传给扩展启动的进程，但到不了扩展自己的登录检查。把两个变量写进 VS Code 用户设置的 claudeCode.environmentVariables，再重载窗口。 在终端里 export 过变量，扩展能读到吗？ 不一定。从程序坞或开始菜单打开的 VS Code 不继承终端里的变量；在终端里用 code . 启动才会继承。写进用户设置不依赖启动方式，更稳妥。 Cursor 或其它 VS Code 分支能用吗？ 扩展是同一个：官方文档给了 Cursor 的安装入口，其余分支在扩展视图里搜索 Claude Code，或者从 Open VSX 安装。装不了扩展的编辑器，在它的集成终端里运行命令行版即可。 桌面版能用这两个环境变量吗？ 不能。按官方文档，桌面版不读 ANTHROPIC\_BASE\_URL，也不读 settings.json，网关地址只从它的第三方推理配置里来：打开开发者模式后，在 Developer 菜单的 Configure Third-Party Inference 里填。 密钥放在 VS Code 设置里要注意什么？ 用户设置是明文 JSON。给 VS Code 单独建一把密钥并设美元预算，预算用完这把密钥就停；不要把密钥写进项目里的 .vscode/settings.json 或 .claude/settings.json，这两个文件会随代码提交。 相关页面 - [Claude Code 中转站](https://relayswitch.ai/zh/claude-code) - [国内怎么用 Claude Code](https://relayswitch.ai/zh/guides/claude-code-china) - [Claude Code 配置第三方 API](https://relayswitch.ai/zh/guides/claude-code) - [CC Switch 配置中转站](https://relayswitch.ai/zh/guides/cc-switch) - [Claude API 中转站](https://relayswitch.ai/zh/claude-api) - [Claude API Key 购买与充值](https://relayswitch.ai/zh/claude-api-key) - [Claude Code 报错速查](https://relayswitch.ai/zh/fix/claude-code-api-error) - [Claude Code 报错 403](https://relayswitch.ai/zh/fix/claude-code-403) - [Claude Code 封号](https://relayswitch.ai/zh/claude-code-fenghao) - [API 中转站怎么选](https://relayswitch.ai/zh/zhongzhuanzhan-tuijian) - [全部配置教程](https://relayswitch.ai/zh/guides) - [Claude Code 官方 VS Code 文档](https://code.claude.com/docs/en/vs-code) - [Claude Code 官方网关接入页](https://code.claude.com/docs/en/llm-gateway-connect) ## 在 VS Code 里用一把密钥跑 Claude Code 邮箱开通，USDT 或银行卡充值，最低 $10。Base URL https://api.relayswitch.io/v1。 [Claude Code 中转站](https://relayswitch.ai/zh/claude-code)[获取密钥](https://app.relayswitch.io/console?lang=zh)