NewAPI 接入 Claude Code 的配置方法：令牌、环境变量与验证

数据截至 2026-08，价格与限额以各官网为准。本文只讲计费与接入机制，不列具体价格数字。

先把结论说完：NewAPI 官方文档为 Claude Code 单独开了一章，配置路径只有一条主线——装好 CLI，然后把 ANTHROPIC_BASE_URL 指向你自己的 NewAPI 站点，官方为三个操作系统各提供了一条一键设置命令。真正需要提前准备的不是 CLI，而是 NewAPI 这一侧：令牌要先建好，而且令牌密钥只在创建那一刻完整显示一次。 另外有一条官方在 Windows、macOS、Linux 三节末尾重复了三遍的提醒最容易被忽略：改完这个环境变量之后，所有模型（包括官方预置的模型）都会走你配置的自定义接入点，而不再消耗官方账号额度。这句话的含义是没有”只对部分请求生效”的中间态，切换是全局的。

第一步在 NewAPI 这边：先把令牌和接口地址备好

Claude Code 那一章默认你已经有一个能用的中转服务了，所以准备工作要回到 NewAPI 控制台。官方文档把令牌定义为 API 凭证，每个令牌可以独立配置自己的权限范围和额度上限，入口是左侧栏的「Tokens」，也可以直接访问 /console/token。

点右上角创建令牌之后，官方列出的可配置项包括这几类：

• 过期时间：可以设一个到期日；留空或者设成 -1 表示不过期
• 剩余额度：限制这个令牌最多能消耗多少额度，超出后令牌会被自动禁用
• 无限额度：开启后该令牌不再单独受限，但仍然受账户总额度约束
• 模型限制：把这个令牌限定在指定模型上，留空则不限制
• IP 允许列表：限制来源 IP，留空则不限制
• 分组：指定这个令牌走哪个渠道分组

给 Claude Code 用的令牌，我的建议是把「模型限制」和「剩余额度」两项认真填一遍。理由在官方 FAQ 里能找到反面印证：有人会遇到「账户额度明明够，却提示额度不足」，官方给的解释是令牌额度和账户额度是两套独立的东西，令牌额度只用来设上限。这个设计反过来正好可以利用——给编程工具单独发一个带额度上限的令牌，跑飞了也就烧掉这一个令牌的配额。

创建成功后弹窗会显示完整的令牌密钥。官方在这里放了一个警告框：密钥只在创建时完整显示一次，关闭弹窗后无法再次查看，并且提醒令牌拥有完整的 API 调用权限，不要分享给别人、不要提交进代码仓库。这一条对 Claude Code 场景格外要紧，因为环境变量很容易被顺手写进项目里的脚本或者 dotfiles 里，相关的处理思路可以参考API Key 的安全管理。

接口地址官方给的取法是：访问平台首页，页面中部有一块 API Base URL 展示区，点复制按钮拷走，这个地址就是客户端里要填的 base URL。

装 Claude Code：三个系统官方给的步骤不一样

官方这一章叫「AI Model Configuration Method」，下面按 Windows、macOS、Linux 分成三份图文指引，步骤并不完全一致，别拿一个系统的步骤套另一个。

Windows

官方的顺序是先装 Node.js 环境，因为 Claude Code 需要 Node.js 才能运行。文档让你去 nodejs.org 下 LTS 版本，双击 .msi 按向导默认设置装完，然后用 node --version 和 npm --version 验证能打印出版本号。

接着有一步很容易漏掉：官方明确写了在 Windows 环境下安装 Claude Code 需要 Git Bash，但装完之后设置环境变量和使用 Claude Code 仍然在普通的 PowerShell 或 CMD 里做。也就是说 Git Bash 只是安装环节的依赖，不是日常运行环境。装完用 git --version 验证。

安装命令本身在 PowerShell 里执行：

npm install -g @anthropic-ai/claude-code

官方还给了几条 Windows 侧的注意事项：推荐用 PowerShell 而不是 CMD；遇到权限问题试试以管理员身份运行；部分杀毒软件可能误报，需要加白名单。如果安装过程提示你把 ~/.local/bin 加进 PATH，官方给了一条 PowerShell 命令做这件事，注意文档写的是「仅在被提示时才需要执行」，没提示就别乱加。最后用 claude --version 确认装好了。

macOS 与 Linux

这两个系统官方给的安装命令是同一条，直接从 claude.ai 拉安装脚本执行：

curl -fsSL https://claude.ai/install.sh | bash

macOS 侧文档标注了一步可选操作：按提示把 ~/.local/bin 追加进 PATH 并重新加载配置。Linux 侧则提到遇到权限问题可以加 sudo 执行，另外部分发行版需要先补依赖库——官方点名的是 Ubuntu/Debian 装 build-essential、CentOS/RHEL 装 “Development Tools” 组。

macOS 还有一条单独的常见问题：如果系统安全设置阻止 Claude Code 运行，官方给的路径是打开「系统偏好设置」→「安全性与隐私」，点「仍要打开」或「允许」。文档里还附了一条需要在终端执行的命令作为替代路径；官方没有说明这条命令做了什么，它属于改动系统安全设置的范畴，能走前面那条界面路径就别动它。

关键一步：把请求指向你自己的网关

CLI 装完之后，官方的说法是「要让 Claude Code 连到你的中转服务，需要设置环境变量」。三个系统各给了一条一键命令，脚本都托管在官方文档仓库 QuantumNous/new-api-docs 的 helper/ 目录下：

iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.ps1')

curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/claude-cli-setup.sh | bash

前者是 Windows 的 PowerShell 版本，后者 macOS 和 Linux 共用。

这里有个必须说清楚的事实边界：官方文档在正文里只点名了 ANTHROPIC_BASE_URL 这一个变量名。Windows 那节的措辞是「需要设置多个环境变量」，Linux 那节写的是「需要设置两个环境变量」，但都没有把变量名逐个列出来——填令牌的那个变量叫什么，官方文档里没有找到相关说明，交给一键脚本处理了。同样，官方也没有给出不用脚本、纯手工设置环境变量的步骤。

正因为变量清单没写在文档里，脚本又是远程拉下来直接执行的，比较稳妥的做法是先把这两个 URL 用浏览器或者下载工具取到本地读一遍，确认它改了哪些变量、写进了哪个配置文件，再决定要不要执行。这不是对项目的怀疑，而是任何「管道执行远程脚本」的通用规矩。

配置完就可以直接启动了：

claude

想在具体项目里用，官方的写法是先 cd 进项目目录再启动。进去之后可以用 /model 命令选模型，官方对这一步的表述是「通常默认设置就够了」。

官方文档没有替你连起来的两件事

第一件是端点。 Claude Code 那一章从头到尾没有说明请求最终落到 NewAPI 的哪个接口上，它只让你改 base URL。文档另有一节叫「Native Claude Format」，说明 NewAPI 提供 Anthropic Claude Messages API 格式的请求路径 POST /v1/messages，并且要求请求头里带 anthropic-version。官方给的 curl 示例形如：

curl https://your-platform.com/v1/messages \
  -H "x-api-key: sk-xxxxxxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "...", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

有意思的是模型列表接口也遵循同一套判断逻辑：官方写明 GET /v1/models 会按请求头自动识别返回格式——带 x-api-key 和 anthropic-version 时返回 Anthropic 格式，带 Gemini 的 key 头或 query 参数时返回 Gemini 格式，其余情况返回 OpenAI 格式。这说明网关这一侧对原生 Anthropic 协议是有完整支持的。但把这两章硬连成「Claude Code 就是走 /v1/messages」是我不该替官方下的结论，文档没有明说这层关系。

第二件是模型名。 Claude Code 章节里除了 /model 这条命令，没有说明该在 NewAPI 侧配置哪些模型名、模型名对不上时会怎样。官方文档在这一点上没有给出说明。

跑起来之后怎么确认真的走通了

NewAPI 内置了两个自检工具，都不用写代码。

一个是 Playground，官方描述是内置的在线测试工具，可以直接和模型对话，用来快速验证令牌可用，入口在左侧栏或者 /console/playground。先在这里确认令牌本身能出结果，再去排 Claude Code 那一侧，能省掉一大半误判。

另一个是用量日志。官方对这一页的说明是：可以查看 API 调用日志，看到所用的令牌分组、模型和消耗；普通用户看自己的，管理员可以看其他用户的。判断 Claude Code 有没有真的走你的网关，看这里最直接——终端里输出正常但日志里一条记录都没有，那就是环境变量没生效，请求根本没到网关。

如果确实怀疑环境变量没吃进去，官方在 Linux 常见问题里给了三条自查：确认改的是正确的配置文件（.bashrc 还是 .zshrc）、重启终端或者重新 source 一次、然后用 echo 打印 ANTHROPIC_BASE_URL 看看值对不对。

报错对照：官方 FAQ 里能对上的几条

接入环节的失败大多不在 CLI 侧，而在网关配置上。官方 FAQ 里几条能直接对号入座：

• 提示没有可用渠道：官方让你按顺序查三处——用户分组设置、渠道分组设置、渠道模型设置。这三处是层层收窄的关系，令牌绑的分组、渠道所属的分组、渠道声明支持的模型，任何一环对不上都会落到这个报错。
• 渠道测试报「倍率或价格未配置」：官方给的处理是去「系统设置 - 运营设置 - 模型倍率设置」里确认该模型的倍率或价格配过了，或者在运营设置里启用自用模式。新加模型忘了配倍率是很常见的疏漏。
• 提示额度不足但账户额度够：前面说过，令牌额度和账户额度是两套，先查令牌那一层。
• 提示当前分组负载已饱和：官方明确说这表示上游渠道返回了 429（请求过多）。也就是说这条不是你的网关限流，问题在上游，处理思路和通用的 429 处理一致。
• 渠道测试报 invalid character '<' looking for beginning of value：官方解释是返回的不是合法 JSON 而是一个 HTML 页面，最可能的原因是部署站点的 IP 或代理节点被 CloudFlare 拦了。

花销这条线怎么算

Claude Code 是个会连续发起多轮请求的工具，接到自建网关之后费用记在哪一层值得先搞清楚。NewAPI 官方给出的额度计算公式是：

Quota = Group Ratio * Model Ratio * (Prompt Token Count + Completion Token Count * Completion Ratio)

三个系数：分组倍率 × 模型倍率，其中补全 token 还要再乘一个补全倍率。倍率具体填多少是每个部署方自己在系统设置里定的，任何写死的数字都不作数——这也是自建网关和商业平台最本质的差别：定价权在部署者手里。想把成本盯住，思路和通用的 API 成本监控是一样的，只是数据源换成了 NewAPI 的用量日志。

最后两件别跳过的事

一是合规。 NewAPI 在渠道管理页顶部放了一个警告框，写明上游渠道必须是部署者合法拥有或获得授权的账号、API Key、模型服务或企业合同；负载均衡、自动故障转移、加权随机、多 Key 管理这些能力是为高可用和企业多账号管理准备的，使用时应遵守上游服务条款、平台规则和监管要求。文档在讲客户端接入时也反复提醒：要用你自己部署的 NewAPI，不要把来源不明的 API 地址和密钥接进生产环境。这套东西是网关，不是绕开授权的工具。

二是那条全局生效的提醒。 官方在 macOS 与 Linux 两节的末尾都写了这条提醒：改完 ANTHROPIC_BASE_URL 之后，所有模型（包括官方预置的模型）都会调用自定义接入点，而不再使用官方账号额度。所以这不是”多加一个可选后端”，而是整体切换。如果你原本还有官方订阅在用，切换前想清楚这一点，别切完之后对着账单发懵。

真要动手，顺序建议反过来走：先在 NewAPI 控制台把渠道、分组、模型倍率配通，用 Playground 验证一次能出结果，再去装 CLI 改环境变量。 反过来先装 CLI，一旦报错你会分不清是客户端配错了还是网关根本没配好。网关本身怎么搭，可以看NewAPI 部署教程那篇。