Claude Code 接入指南

1. 适用版本与验证日期

最近一次用版本 2.1.310 于 2026-10-26 实测。

2. 前置条件

需要账号、API key 和正余额。没有余额时请求返回 HTTP 402（insufficient_quota）。

3. 配置

macOSLinuxWindows

~/.zshrc

export ANTHROPIC_BASE_URL=https://api.tokenwave.dev
export ANTHROPIC_AUTH_TOKEN=sk-atr-YOUR_KEY
export ANTHROPIC_API_KEY=""
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

source ~/.zshrc
claude --model claude-sonnet-5-5

~/.bashrc

export ANTHROPIC_BASE_URL=https://api.tokenwave.dev
export ANTHROPIC_AUTH_TOKEN=sk-atr-YOUR_KEY
export ANTHROPIC_API_KEY=""
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

source ~/.bashrc
claude --model claude-sonnet-5-5

setx ANTHROPIC_BASE_URL "https://api.tokenwave.dev"
setx ANTHROPIC_AUTH_TOKEN "sk-atr-YOUR_KEY"
setx ANTHROPIC_API_KEY ""
setx CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY 1
# Open a new terminal, then:
claude --model claude-sonnet-5-5

4. 选模型

这些模型能用于 Claude Code。上面的示例使用你在这里选的模型。

查看能用于 Claude Code 的模型

5. 自检

运行 claude，输入 /status：API base URL 应是你的网关地址。/model 会列出你的 key 可用的模型。

6. 发第一条提示

发送这句提示：“Reply with the single word ready.”然后打开请求记录页：一分钟内会看到这条请求，含模型、token 数和费用。

打开请求记录

7. 已知限制

只能用 Claude 模型；Claude Code 不能被路由到其他模型。网关原样转发请求时提示缓存有效。不支持 1M token 上下文选项与 fast mode。把 ANTHROPIC_API_KEY 设为空后，Claude Code 可能打印“claude.ai connectors are disabled because ANTHROPIC_API_KEY or another auth source is set”：无害，使用网关时不会加载你 claude.ai 账号里的连接器。

8. 排错

症状	原因	修复
401 Unauthorized	key 填错、已吊销，或带了多余空格。	到 API keys 页重新复制完整的 key，并确认它是有效状态。
403 Forbidden	这个 key 不能用该模型，或账户受限。	到 API keys 页检查 key 允许的模型，或换一个 key。
404 Not Found	基础地址不对：/v1 重复或缺失。	原样使用示例里的地址。Claude Code 不带 /v1，其他工具带 /v1。
model not found	模型 ID 写错，或你的 key 不能用它。	从目录复制 ID，或用 GET /v1/models 查看 key 可用的模型。
400 Extra inputs are not permitted	工具发了所选线路不接受的字段，多见于经转换的接口。	选一个提供该工具原生接口的模型（见模型页的卡片），或升级工具。
令牌与 API key 的认证冲突	ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 同时设置，或缓存着旧的登录。	按示例让 ANTHROPIC_API_KEY 保持为空，并在 Claude Code 里执行一次 /logout。
返回 HTML 页面或 “Attention Required”，不是 JSON	网关前面的网页防火墙拦截了请求体。	重试一次。反复出现时，带上时间和请求 ID 联系支持。
我传的某个参数好像没有生效	网关只转发该接口已知支持的字段，其余字段会被丢弃（不会报错）。	查看响应头 x-atr-ignored-fields：它列出了没有被转发的顶层字段。去掉这些字段，确实需要时联系支持。

9. 还原

从 shell 配置文件里删掉那四行 ANTHROPIC_ 与 CLAUDE_CODE_ 变量，再开新终端。Windows 在系统属性 → 环境变量里删除这些变量。