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 记账的团队、想用余额按量付费的开发者。

配置预览~/.claude/settings.json
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. 1

    创建 API Key

    登录控制台,在 API Keys 页面新建一把 Key。可以给它设日 / 月 / 总消费上限。

  2. 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. 3

    跳过首次登录引导

    在 ~/.claude.json 里加上 hasCompletedOnboarding,Claude Code 启动时就不会要求登录 Anthropic 账号。

    ~/.claude.json
    {
      "hasCompletedOnboarding": true
    }

    如果 ~/.claude.json 已存在,只需在原有 JSON 里加上这一项,不要覆盖其他内容。

  4. 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 全局安装:

bash
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 无关联,也未获其认可。