Claude Code 接入 · 按量 API
Claude Code 第三方 API 配置教程
Claude Code 通过环境变量读取 API 地址和密钥。把 ANTHROPIC_BASE_URL 指向 aicodewith、填入你的 API Key,就能在终端里按 token 计费使用 Claude Opus 5.5、Sonnet 5.5 等模型。
适合:Claude Code 订阅额度不够用、需要按 Key 记账的团队、想用余额按量付费的开发者。
- ANTHROPIC_BASE_URL
- https://api.aicodewith.ai
- ANTHROPIC_AUTH_TOKEN
- 你的 AI Code With API Key
- ANTHROPIC_API_KEY
- ""
- Model
- claude-sonnet-5-5(示例,/model 切换)
1 分钟快速配置
下面的内容和控制台新手引导里给出的配置完全一致。
- 1
创建 API Key
登录控制台,在 API Keys 页面新建一把 Key。可以给它设日 / 月 / 总消费上限。
- 2
写入 settings.json
macOS / Linux:~/.claude/settings.json;Windows:%USERPROFILE%\.claude\settings.json。文件不存在就新建。
~/.claude/settings.json{ "env": { "ANTHROPIC_AUTH_TOKEN": "替换成你的_API_KEY", "ANTHROPIC_API_KEY": "", "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai" } } - 3
跳过首次登录引导
在 ~/.claude.json 里加上 hasCompletedOnboarding,Claude Code 启动时就不会要求登录 Anthropic 账号。
~/.claude.json{ "hasCompletedOnboarding": true }如果 ~/.claude.json 已存在,只需在原有 JSON 里加上这一项,不要覆盖其他内容。
- 4
重启 Claude Code
关闭所有 Claude Code 会话后重新运行 claude,发一条消息测试。
这几个变量分别做什么
Claude Code 启动时读取 settings.json 里的 env,并把它们当作环境变量使用。
- ANTHROPIC_BASE_URL
- API 地址。填 https://api.aicodewith.ai,只填域名,不要带 /v1,Claude Code 会自己拼接路径。
- ANTHROPIC_AUTH_TOKEN
- 你的 aicodewith API Key,以 Authorization: Bearer 的方式发送。
- ANTHROPIC_API_KEY
- 留空。避免和系统里已有的 Anthropic Key 冲突。
只要环境里设置了 API Key,Claude Code 就会走 API 计费,不再使用 Claude 订阅的额度。费用从你的 aicodewith 余额按实际 token 扣除。
选择模型
在 Claude Code 里输入 /model 切换模型。常见搭配:
Claude Sonnet 5.5
日常编码的默认选择,速度和价格均衡。
Claude Opus 5.5
复杂重构、架构设计、难排查的 bug。
Claude Haiku 5.5
子 agent、批量小任务,最省钱。
可用模型和实时价格以模型页为准。 /models
怎么确认已经切过来了
- 在 Claude Code 里运行 /status,确认 API 地址是 api.aicodewith.ai。
- 发一条消息后,到控制台的用量记录里能看到这次请求和扣费。
- 运行 /cost 可以看到本次会话按 token 计算的费用。
切回 Claude 订阅
删掉 settings.json 里的这几个 env,然后在 Claude Code 里运行 /login 登录你的 Anthropic 账号。
还没装 Claude Code?
Claude Code 需要 Node.js 18 或更高版本。用 npm 全局安装:
npm install -g @anthropic-ai/claude-code安装方式以 Anthropic 官方文档为准。装好后在项目目录运行 claude 启动。
npm 上的 Claude Code常见问题
Base URL 要不要加 /v1?
不要。ANTHROPIC_BASE_URL 只填 https://api.aicodewith.ai,加了 /v1 会导致 404。
配好之后还会受 Claude 订阅 5 小时 / 每周额度影响吗?
不会占用订阅额度。请求按 token 从你的 aicodewith 余额扣费;我们自己的速率和并发限制仍然适用,详见文档。
怎么控制花费?
在控制台给每把 API Key 设日 / 月 / 总消费上限,也可以在 Claude Code 里用 /cost 随时查看本次会话费用。
VS Code 或 JetBrains 里的 Claude Code 插件能用吗?
能。插件和终端版读同一份 ~/.claude/settings.json,配置一次即可。
aicodewith 和 Anthropic 是什么关系?
aicodewith 是独立的第三方 API 服务,与 Anthropic 没有隶属或合作关系。Claude、Claude Code 是 Anthropic 的商标。
常见报错
大部分问题都出在 Base URL、Key 或者旧的环境变量上。
401 / Invalid API key
现象: 发消息立即报认证失败。
原因: Key 填错、被删除,或者系统里的 ANTHROPIC_API_KEY 覆盖了配置。
- 重新复制 Key,确认没有多余空格
- 确认 ANTHROPIC_API_KEY 为空
- 在终端运行 echo $ANTHROPIC_API_KEY 检查是否有残留
404 Not Found
现象: 请求返回 404。
原因: Base URL 带了 /v1 或拼写错误。
- 改成 https://api.aicodewith.ai
- 保存后完全重启 Claude Code
仍然提示 You've hit your session limit
现象: 看到的还是 Claude 订阅的限额提示。
原因: 配置没有生效,Claude Code 仍在用订阅登录。
- 确认 settings.json 路径正确、JSON 合法
- 关闭所有会话后重启
- 运行 /status 查看当前 API 地址
429 / rate limited
现象: 偶发 429。
原因: 请求频率或并发超出了速率限制。
- 降低并行子 agent 数量
- 稍等片刻重试
- 查看余额和 Key 的消费上限
Claude Code 额度用完了?
看看 Pro / Max 的 5 小时和每周限额怎么算,以及订阅、usage credits 和按量 API 的成本对比。
查看 Claude Code 用量上限说明参考资料
相关链接
Claude、Claude Code 为 Anthropic PBC 的商标。本页与 Anthropic 无关联,也未获其认可。