把 Claude Code 指向
自定义 API 端点
截至 2026-10-07，按 Anthropic 官方网关文档，两个变量就够：ANTHROPIC_BASE_URL 指向端点，ANTHROPIC_AUTH_TOKEN 以 Authorization: Bearer 头发送凭据（网关要 x-api-key 时改用 ANTHROPIC_API_KEY），也可以写进 settings.json 的 env 块。Claude Code 2.1.285 起，自定义 ANTHROPIC_BASE_URL 下有 1M 窗口的模型（Opus 4.7+、Sonnet 5+、Fable）默认按 1M 运行，网关只到 200K 时官方建议运行 /autocompact 200k。云端会话不属于网关部署，在那里设的网关变量不生效。
更新于 2026-10-08
把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
四个要点
最小配置
ANTHROPIC_BASE_URL 指向端点，ANTHROPIC_AUTH_TOKEN 提供凭据。多数情况这两个就够。
凭据落在哪个头
截至 2026-10-07 官方文档：ANTHROPIC_AUTH_TOKEN 放进 Authorization: Bearer 头，ANTHROPIC_API_KEY 放进 x-api-key 头，apiKeyHelper 两个头都发；变量放错，凭据落进网关不读的头，请求就会 401。
第二个配置位置
不想用环境变量的话，可以写进 settings.json 的 env 块，形态与环境变量一一对应。
网页版与云端会话
截至 2026-10-07 官方文档：云端会话不属于网关部署，在云端会话环境配置里设的网关变量不会被应用；流量必须走网关时，就别给这些用户开这类入口。
为什么这两个变量就够
截至 2026-10-07，答案仍是两个变量。Claude Code 的请求出口是可配置的：ANTHROPIC_BASE_URL 决定发到哪里，ANTHROPIC_AUTH_TOKEN 决定带什么凭据。官方文档把后者说得很直白——这个环境变量就是把 key 放进 Authorization 头的那一步，而网关读的正是那个头。所以只要你的端点接受 Anthropic 协议、并按 Authorization 头鉴权，接入就成立，不需要改客户端代码。
官方文档给的写法与 2.1.285 的变化（2026-10-07 查）
写法一是环境变量：ANTHROPIC_BASE_URL 设为你的端点，ANTHROPIC_AUTH_TOKEN 设为凭据。写法二是写进 settings.json 的 env 块，键名与环境变量相同。文档另外给了 apiKeyHelper：它是 Claude Code 用来取凭据的一条命令，替代静态环境变量，适合凭据需要轮换的场景。文档里还有「把网关模型加进模型选择器」和「关掉网关路径之外的流量」两节，企业部署时值得一并看。2026-10-07 补充：Claude Code 2.1.285（2026-09-29 发布）的变更日志原文是「Changed sessions behind a custom ANTHROPIC_BASE_URL to use the 1M context window of models that have one (Opus 4.7+, Sonnet 5+, Fable); run /autocompact 200k if your gateway stops at 200K」。官方模型配置页同时写明，Claude Code 探测不到网关或其背后服务器设的更低上限。
接入的三步
设两个变量：ANTHROPIC_BASE_URL 指向端点，ANTHROPIC_AUTH_TOKEN 填凭据。先在一个干净的 shell 里试，别一上来就写进全局配置。
发一个最小请求确认通了。看响应里回显的 model 是不是你请求的那个——这一步顺带验证了中间有没有改写层。
稳定之后再固化：写进 settings.json 的 env 块，或者在 CI 里用密钥管理注入（文档给的 CI 形态是把凭据从 secrets 传给 ANTHROPIC_AUTH_TOKEN）。凭据需要轮换就换成 apiKeyHelper。
官方文档写了的 vs 需要问你的端点方
官方文档写了
① ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 两个变量的作用；② 凭据经 Authorization 头传递；③ settings.json 的 env 块是等价的第二种写法；④ apiKeyHelper 用命令取凭据替代静态变量；⑤ 云端会话（网页版）与 Slack 里的 Claude Code 不属于网关部署，在云端会话环境里设的网关变量不生效。⑥ Claude Code 2.1.285 起，自定义 ANTHROPIC_BASE_URL 下有 1M 窗口的模型（Opus 4.7+、Sonnet 5+、Fable）按 1M 运行，网关只到 200K 时运行 /autocompact 200k（变更日志原句，2026-10-07 核对）。
需要问你的端点方
base URL 到底该不该带路径后缀、支持哪些模型 id、是否支持 1M 上下文与缓存、并发上限是多少——这些取决于你接的那个端点，官方文档不会替它回答。收到 404 时先核对 base URL 的路径部分与端点文档是否一致；收到 401 先确认凭据是走 Authorization 头而不是别的头。上下文上限尤其要问清：2.1.285 起 Claude Code 在自定义端点下按 1M 做预算，却探测不到网关的更低上限；网关只到 200K 就按官方建议运行 /autocompact 200k。
两种配置位置
环境变量
改起来最快，适合先试通。缺点是容易漏——换个终端、换个 CI runner 就没了，而且凭据会出现在进程环境里。适合验证阶段和一次性任务。
settings.json 的 env 块
跟着配置走，不依赖你当前 shell 的状态，适合固化。凭据仍然是明文落盘，需要轮换或不想落盘的场景应该改用 apiKeyHelper：它是一条命令，由 Claude Code 在需要时调用取凭据。
三个最常见的卡点
① 变量设了但没生效：确认你设的是当前进程能看到的环境，且没有被 settings.json 里的同名键覆盖；两处都有时以实际加载顺序为准。② 网页版或云端会话里不生效：这是官方明确说明的行为——现行网关文档写明云端会话不属于网关部署，在那里设的网关变量不会被应用。③ 某些依赖账号身份的功能异常：文档提到，用 ANTHROPIC_AUTH_TOKEN 认证的会话在做可用性检查时可能得到与组织设置不一致的结果，因为那个检查需要 claude.ai 登录或 Anthropic API key。
在 QCode 上
截至 2026-10-07，QCode 文档写明 Claude Code 接入就是上面两个变量：ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api（末尾不要带斜杠），ANTHROPIC_AUTH_TOKEN 填 cr_ 开头的密钥；工具只认 ANTHROPIC_API_KEY 时，填同一把 cr_ 密钥也能用。Claude 模型只能走 Anthropic 协议的端点。本页不对 QCode 各模型的上下文上限作承诺，遇到上下文超限报错，按 Claude Code 官方建议用 /autocompact 把阈值调低。接通之后建议立刻做两件事：一是发一个最小请求，看响应里回显的 model 与你请求的是否一致；二是把 usage 与扣费记录对一次。按 token 计费，各模型单价见 /models。
把 ANTHROPIC_BASE_URL 指到网关之后，有两件事会跟着变
下面两条都写在官方 ANTHROPIC_BASE_URL 的条目里，条件是一样的：指向非第一方主机。QCode 就是非第一方主机，所以这两条对我们这条链路同样成立。
MCP 工具搜索默认是关的
官方在这一条里写得很直接：该变量指向非第一方主机时，MCP 工具搜索默认关闭；如果你的代理会转发 tool_reference 块，需要显式设 ENABLE_TOOL_SEARCH=true 再验一次。代理不转发这些块时，保持关闭只是少一层工具检索的加速，普通工具调用与消息本身不受影响。核对日 2026-10-07。
Remote Control 会被禁用
同一份文档：自 v2.1.196 起，当这个变量指向 api.anthropic.com 以外的主机时，Remote Control 不再可用，与它在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 上的处理一致。要在手机侧做远控会话的人，请把这当成已知边界，别在接通之后当故障排查。核对日 2026-10-07。
凭据到底落在哪个头
官方的分法是：网关团队说的是 bearer token 或 Authorization 头，就设 ANTHROPIC_AUTH_TOKEN；说的是 API key 或 x-api-key，就设 ANTHROPIC_API_KEY；两边都没说时，官方建议先用 ANTHROPIC_AUTH_TOKEN，再用一个最小请求验证要不要换。QCode 两种都接受，区别只在你把哪个变量写进配置。核对日 2026-10-07。
本节三处说法核自 Anthropic 官方文档的 ANTHROPIC_BASE_URL 条目与 LLM gateway 接入页，核对日 2026-10-07；这两件事都跟着 Claude Code 的版本走，最终以官方页面与你实际跑的版本为准。
常见问题
最少要设哪几个变量？
两个：ANTHROPIC_BASE_URL 指向端点，ANTHROPIC_AUTH_TOKEN 提供凭据。官方文档说明后者就是把 key 放进 Authorization 头的那个变量。
base URL 要不要带路径后缀？
取决于你接的端点，官方文档不替它回答。最快的判断方式是先按端点方文档写，发一个最小请求；如果收到 404，第一个要核对的就是路径部分。以 QCode 为例，文档给的值是 https://api.qcode.cc/api，末尾不带斜杠。
能不写环境变量吗？
可以，写进 settings.json 的 env 块即可，键名与环境变量相同。凭据需要轮换、或不想让它明文落盘时，改用 apiKeyHelper——它是一条由 Claude Code 调用来取凭据的命令。
为什么网页版里设了不生效？
这是官方明确说明的行为。截至 2026-10-07 的官方网关文档写的是：Slack 里的 Claude Code 与云端会话（网页版）不属于网关部署，在云端会话环境配置里设的网关变量不会被应用；流量必须走网关时，就别给这些用户开这类入口。2026-09-22 抓取的版本还写着这两者 always use Anthropic's API（始终使用 Anthropic 的 API），现行文档已删去这半句。
CI 里怎么配？
官方文档给的形态是把凭据从密钥管理里传给 ANTHROPIC_AUTH_TOKEN，base URL 照常设。不要把凭据写进仓库里的配置文件——那和写进代码没有区别。
接通之后第一件该验的事是什么？
看响应里回显的 model 是不是你请求的那个。如果多了请求里没有的前缀、后缀或供应商名，说明中间存在改写层。这不必然是坏事，但它决定了你后面读账单时该怎么归因。
信息来源
两个环境变量的作用、凭据各走哪个请求头、settings.json 的 env 块写法、apiKeyHelper 的定义、云端会话不走网关：Anthropic 官方文档「Connect Claude Code to an LLM gateway」（code.claude.com/docs/en/llm-gateway-connect，首次 2026-09-02 抓取，2026-10-07 复核）。ANTHROPIC_BASE_URL 条目：Claude Code 环境变量页（2026-10-07 抓取）。1M 上下文与 /autocompact 200k：Claude Code 变更日志（GitHub 上 anthropics/claude-code 仓库的 CHANGELOG.md，2.1.285 条目）与模型配置页，发布日期取自同一仓库的 GitHub Releases，均 2026-10-07 抓取。QCode 接入写法：docs.qcode.cc 的环境变量配置与接入点两页（2026-10-07 抓取）。具体端点的路径形态、可用模型与限额取决于你所接的服务方，本页不代其回答。
相关阅读
Cline 的 OpenAI 兼容配置
另一类客户端的自定义端点配置形态。
Claude Max / Team 每月附送 API 额度
2026-10-07 上线：$100 / $200 / 最多 $500，关联 Console 组织领取，不含 Claude Code，当期过期不结转。
在日本使用 Claude Code 实用指南
付款方式（信用卡、Apple Pay、Google Pay、加密货币）、日语文档与 ANTHROPIC_BASE_URL 接入步骤。
本页引用的官方文档最近一次核对于 2026-10-07，可能更新，以 Anthropic 官方页面为准。具体端点的路径形态、模型集合与限额以你所接服务方的文档为准；模型可用性以 /models 为准。