Claude Code VS Code 扩展配置 API Key 与自定义网关
截至 2026-10-07，按 Claude Code 官方文档，VS Code 扩展接自定义网关的可靠写法是：在 VS Code 用户设置的 claudeCode.environmentVariables 里写入 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，因为扩展启动前会检查这个设置里的凭据。想让终端 CLI 共用，再在 ~/.claude/settings.json 的 env 块写同样两项。接 QCode 时两项分别填 https://api.qcode.cc/api 与 cr_ 开头的密钥。本页整理配置步骤、与 CLI 的关系，以及找不到 key、仍要求登录、模型选择三类常见问题。
更新于 2026-10-08
先记住四件事
QCode 只需要填两个变量
ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api（填到 /api 为止，末尾不带斜杠），ANTHROPIC_AUTH_TOKEN 填控制台创建的 cr_ 密钥。
扩展放网关凭据的可靠位置
官方写明：扩展启动前会检查 claudeCode.environmentVariables 里的凭据；~/.claude/settings.json 里的值能传给扩展启动的进程，却到不了扩展自己的登录检查。
与终端 CLI 共用的配置
~/.claude/settings.json 由扩展与 CLI 共用，在 env 块写同样两项，终端里的 claude 也连同一个网关。不要写进项目的 .claude/settings.json，那个文件会被提交。
自定义 base URL 下的上下文窗口
2.1.285 起，设了自定义 ANTHROPIC_BASE_URL 的会话对 Opus 4.7 及以后、Sonnet 5 及以后与 Fable 直接按 1M 运行；网关只到 200K 时，官方变更日志建议运行 /autocompact 200k。
VS Code 扩展怎么读配置
截至 2026-10-07，答案是：扩展有两套设置。官方文档写明，VS Code 里的扩展设置管扩展自身的行为，~/.claude/settings.json 由扩展与 CLI 共用，用来放环境变量、允许的命令、hooks 与 MCP 服务器。接自定义网关时，官方网关文档把凭据放在 VS Code 用户设置的 claudeCode.environmentVariables 里，理由是扩展启动前会检查这里的凭据。扩展自带一份 CLI 供聊天面板使用，但不会把 claude 加进 PATH；要在集成终端里运行 claude，还得单独安装 CLI。官方要求 VS Code 1.94.0 或更高。用 Claude 付费订阅或 Console 账号登录不需要 API key；接网关时，由凭据变量代替你的 claude.ai 登录。
最近几版与 VS Code 相关的变化（截至 2026-10-07）
截至 2026-10-07，GitHub Releases 上最新的是 2.1.292，发布于 2026-10-06（UTC）。与接网关相关的几条：2.1.285 起，自定义 ANTHROPIC_BASE_URL 后面的会话对有 1M 窗口的模型（Opus 4.7 及以后、Sonnet 5 及以后、Fable）按 1M 运行，官方变更日志写明网关只到 200K 时运行 /autocompact 200k；2.1.280 给 VS Code 加了 Status 对话框，输入 /status 可看当前会话的版本、账号、模型与服务器信息；2.1.277 起，在不适用套餐额度的登录方式下（变更日志列举 Vertex、Bedrock、Foundry 与 API key），Account & usage 对话框显示本会话的费用与 token 用量；2.1.290 修复了 Claude Code 找不到或启动不了自身程序时，登录与新会话不给出明确原因的问题。
版本时间线
2.1.261 发布（UTC）：修复了 VS Code 里已勾选 Disable Login Prompt，却在 Claude Code 报告未登录、或请求因缺少登录而失败时仍弹出登录页的问题。
2.1.280 发布（UTC）：VS Code 新增 Status 对话框，在面板输入 /status 即可查看当前会话的版本、账号、模型与服务器信息，核对配置是否生效更方便。
2.1.285 发布（UTC）：设了自定义 ANTHROPIC_BASE_URL 的会话，对有 1M 窗口的模型（Opus 4.7 及以后、Sonnet 5 及以后、Fable）直接按 1M 运行。
已确认 vs 文档没写的
已确认（官方文档逐字可核）
以下都能在 Claude Code 官方文档、变更日志或 QCode 文档里逐字核到：VS Code 1.94.0 或更高；扩展自带 CLI 但不加进 PATH；~/.claude/settings.json 由扩展与 CLI 共用；网关变量写在 claudeCode.environmentVariables，扩展启动前检查这里的凭据；Disable Login Prompt 用来跳过登录提示；ANTHROPIC_AUTH_TOKEN 走 Authorization: Bearer 头、ANTHROPIC_API_KEY 走 x-api-key 头；凭据变量优先于已保存的 claude.ai 登录；只设 ANTHROPIC_BASE_URL、不设凭据变量，不会替换订阅登录；扩展与 CLI 共用对话历史；2.1.285 改为默认 1M 窗口；QCode 的两项取值 https://api.qcode.cc/api 与 cr_ 密钥。
文档没写或没核实的
三件事本页不下结论：① 截至 2026-10-07，官方扩展设置表中未列出单独的 API key 或 base URL 设置项；本页只写官方文档列出的配置位置，其它配置文件的写法不在本页范围内。② 网关自己设的上下文上限，官方写明 Claude Code 探测不到；你的网关是否放行 1M，要看网关文档或自己实测。③ 扩展的设置名称与按钮会随版本变化，本页按 2026-10-07 抓取的官方文档写，没有逐版实测，以你手上的版本为准。
放在哪、和 CLI 什么关系
environmentVariables 对 settings.json
两处都写最省事。claudeCode.environmentVariables 是 VS Code 用户设置，为扩展启动的 Claude 进程设置环境变量；扩展启动前会检查这里的凭据，所以官方网关文档把凭据放这里。~/.claude/settings.json 的 env 块由扩展与终端 CLI 共用，官方 VS Code 文档建议共享的配置写这里。只写后者，值能传到进程，却到不了扩展自己的登录检查；只写前者，配置不会与终端 CLI 共享。
VS Code 扩展对终端 CLI
两者读同一套设置文件，也共用对话历史：在终端运行 claude --resume 就能接着扩展里的对话。差别在功能：官方对照表写明 CLI 有全部命令与 skills，扩展只有一部分（输入 / 查看）；! Bash 快捷方式与 Tab 补全只在 CLI。扩展不会把 claude 加进 PATH，要在终端用 CLI 需单独安装；扩展里看不出报错原因时，官方建议在终端运行 claude 查看更详细的错误信息。
五步接上自定义网关
① 安装扩展：在扩展视图（Cmd+Shift+X / Ctrl+Shift+X）搜索 Claude Code 并安装，或在终端运行 code --install-extension anthropic.claude-code；VS Code 需 1.94.0 或更高。② 在命令面板运行 Preferences: Open User Settings (JSON)，加入 claudeCode.environmentVariables，写两项：name 为 ANTHROPIC_BASE_URL、value 为 https://api.qcode.cc/api；name 为 ANTHROPIC_AUTH_TOKEN、value 为你的 cr_ 密钥。③ 如果仍弹出登录页，打开设置搜索 Claude Code login，勾选 Disable Login Prompt（官方说明它用于第三方接入时跳过登录提示）。④ 想让终端 CLI 共用：在 ~/.claude/settings.json（Windows 为 %USERPROFILE%\.claude\settings.json）的 env 块写同样两项；不要写进项目的 .claude/settings.json。⑤ 运行 Developer: Reload Window，在面板输入 /status 核对版本、账号、模型与服务器信息，再发一句话测试。
在 QCode 上
在 QCode 上，两项取值照 QCode 文档：ANTHROPIC_BASE_URL=https://api.qcode.cc/api（填到 /api 为止，末尾不要带斜杠），ANTHROPIC_AUTH_TOKEN 填 cr_ 开头的密钥（控制台创建），Claude Code 会把它作为 Bearer 令牌发出。Claude 模型只能走 Anthropic 协议的端点，VS Code 扩展用的正是这种协议。可调的 Claude 型号如 claude-sonnet-5-5、claude-opus-5-5、claude-sonnet-5，按 token 计费，各模型单价见 /models，Claude 系列不分长短档。北美与欧洲可用 us.qcode.cc（洛杉矶），中国大陆网络文档建议换成 asia.qcode.cc，路径不变、同一把密钥通用；每次请求都能在 probe.qcode.cc 输入密钥查看。
常见问题
VS Code 里的 Claude Code 在哪填 API key 和自定义 base URL？
填在 VS Code 用户设置的 claudeCode.environmentVariables 里。在命令面板运行 Preferences: Open User Settings (JSON)，加入 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 两项；接 QCode 分别填 https://api.qcode.cc/api 与 cr_ 密钥。截至 2026-10-07，官方扩展设置表中未列出单独的 API key 或 base URL 设置项；官方网关文档写明扩展启动前会检查这个设置里的凭据，所以它是放网关凭据的可靠位置。
终端里已经 export 了变量，扩展还是找不到 key？
多半是变量没传到 VS Code。官方写明 shell export 只对那个终端会话和从它启动的程序生效，从程序坞或开始菜单打开的编辑器看不到。只写进 ~/.claude/settings.json 的 env 块也不够：这些值能传给扩展启动的进程，却到不了扩展自己的登录检查。把两项写进 claudeCode.environmentVariables，再运行 Developer: Reload Window，改完可在面板输入 /status 核对。
配好了为什么还要求登录？
通常是扩展的登录检查没看到凭据。先确认凭据写在 claudeCode.environmentVariables 里，而不是只设了 ANTHROPIC_BASE_URL：官方写明只设 base URL、不设凭据变量，不会替换订阅登录，已保存的 claude.ai 登录仍是生效的凭据。仍弹登录页时，在设置里搜 Claude Code login 并勾选 Disable Login Prompt；2.1.261 修复过勾选后仍弹登录页的问题，旧版先升级。启动时若出现列出两个凭据来源、以 auth may not work as expected 结尾的警告，官方给的办法是运行 /logout，只保留网关凭据。
VS Code 扩展和终端 CLI 能共用一份配置吗？
能，共用 ~/.claude/settings.json。官方写明终端、VS Code 与 JetBrains 扩展以及桌面应用读同一套设置文件；在 env 块写好 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，终端里的 claude 也连同一个网关。同一变量在 shell export 与设置文件 env 块里都设了时，以设置文件为准。两边还共用对话历史，在终端运行 claude --resume 可接着扩展里的对话。注意扩展不会把 claude 加进 PATH，终端要用 CLI 得单独安装。
模型怎么选？选择器里没有想要的型号怎么办？
点输入框下方的模型标签或输入 /model 选择；也可以设 ANTHROPIC_MODEL 环境变量，或在设置文件里写 model 字段。官方写明 /model 会把选择写进用户设置的 model 字段，作为新会话的默认值，所以扩展与 CLI 读到的是同一个默认。网关的模型名不在 Claude Code 内置列表里时，官方给的办法是设 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1，让选择器读取网关的模型列表。接 QCode 时 model 可填 claude-sonnet-5-5、claude-opus-5-5 或 claude-sonnet-5，在售型号以 /models 为准。
ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 用哪个？
接 QCode 用 ANTHROPIC_AUTH_TOKEN。官方写明它以 Authorization: Bearer 头发送，ANTHROPIC_API_KEY 则走 x-api-key 头；凭据放错变量，会落在网关不读的请求头里而返回 401，换另一个变量再试即可。QCode 文档约定密钥放在 ANTHROPIC_AUTH_TOKEN，只认 ANTHROPIC_API_KEY 的工具填同一把 cr_ 密钥也能用。另一个差别：ANTHROPIC_API_KEY 在交互模式下首次需要你确认一次才生效，ANTHROPIC_AUTH_TOKEN 则立即优先于已保存的登录。
信息来源
配置位置与扩展行为：Claude Code 官方文档的 VS Code 页（code.claude.com，含前提条件、扩展设置表、第三方接入步骤、与 CLI 的对照与常见问题），以及连接 LLM 网关、LLM 网关概览、认证、设置、环境变量与模型配置各页，均于 2026-10-07 抓取。版本变化：anthropics/claude-code 仓库的 CHANGELOG 与 GitHub Releases 发布时间（UTC），同日抓取。QCode 侧取值：QCode 文档的环境变量配置页（更新于 2026-09-25）、接入点与 API 格式页、VS Code 集成页（更新于 2026-09-18）与 /models 页，同日抓取。
相关阅读
ANTHROPIC_BASE_URL 与 AUTH_TOKEN 配置指南
把 Claude Code 指向自定义端点：两个环境变量与 settings.json 写法。
Claude Code 使用指南
从安装配置到熟练使用的完整教程。
Claude Code 国内使用完全指南
中国大陆开发者使用 Claude Code / Codex API 的接入说明，支持支付宝付款。
本页步骤与引语核对于 2026-10-07，以 Claude Code 官方文档、变更日志与 QCode 文档为准，上游调整不另行通知。扩展界面与设置名称随版本变化，以你手上的版本为准；模型可用性以 /models 为准。