Claude Max API Key 怎么配置？5 步接入教程

Claude Max 订阅不会直接给你发 API Key。想用 API 有两条路:一是 Max 订阅账号通过 OAuth 登录 Claude Code(终端 /login),走订阅额度;二是在 Anthropic Console 创建 API Key 按量付费。另外 Max 和 Team 订阅用户有月度 API 积分(2026 年 6 月政策,媒体报道 Pro 每月 20 美元、Max 5x 100 美元、Max 20x 200 美元,需手动领取、每月重置不累积)。本文先讲机制,再给两条路的配置步骤和常被忽略的优先级坑。

先讲清机制:订阅与 API 是两个体系

订阅(Pro/Max/Team)挂在 claude.ai 账号上,Claude Code 通过 OAuth 使用订阅身份与额度,不额外产生 API 账单。

API Key 在 Console(console.anthropic.com)创建,按 token 计费,从账户余额扣除,与订阅费相互独立。

关键点一:认证优先级。Claude Code 按固定顺序找凭证:云平台凭据、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、apiKeyHelper、CLAUDE_CODE_OAUTH_TOKEN,最后才是订阅 OAuth。环境里残留 API Key 时,它会压过你的订阅身份,账单从 API 余额扣,而不是用订阅额度。

关键点二:Max/Team 月度 API 积分。2026 年 6 月 15 日起,订阅用户获得按 API 零售价计费的月度 Credit(媒体报道:Pro 20 美元、Max 5x 100 美元、Max 20x 200 美元),需手动领取,每月重置、不累积;2026 年 10 月 8 日随 Claude Haiku 5.5 发布,Anthropic 再次确认面向所有 Max 和 Team 用户推出每月 API 额度。怎么领、怎么查余额,站内 [Claude Max API 积分领取指南](https://www.ai345.

info/ai-guide/claude-max-api-credits-guide/) 已讲透,本文不重复,只讲配置。两条路可以并存:订阅 OAuth 用于日常交互式开发,API Key 挂给脚本和 CI,同一个账号的两个计费池互不干扰。月度积分主要用于程序化与 API 类调用(如 Agent SDK、GitHub Actions 及第三方工具),交互式 Claude Code 仍走订阅限额,这一口径与媒体报道一致。

前置准备

1. 一个 Claude 账号:订阅 Max,或准备按量付费的 Console 账号

2. 网络条件:Claude 官方服务在中国大陆无法直连,可用状态见站内 Claude Max 国内可用性,官方说明见 Anthropic 帮助中心

3. 选好计费路径:日常交互开发选订阅 OAuth,脚本/CI/团队按量结算选 API Key

4. (可选) 确认套餐是否有月度积分:Max 与 Team 用户按月发放,先领再用,领取方法见站内积分指南

方式 A:订阅 OAuth 接入 Claude Code

1. 安装 Claude Code:按官网命令安装(npm install -g @anthropic-ai/claude-code 或官方脚本),完成即可

2. 在任意目录运行 claude

3. 浏览器自动打开,登录你的 claude.ai 账号(购买 Max 的那个账号),完成 OAuth 授权

4. 若浏览器没自动打开:按 c 复制登录链接,手动在浏览器打开;若浏览器显示验证码而不是自动跳转,把验证码粘贴到终端提示处(常见于 WSL2、SSH 会话和容器)

5. 输入 /status 验证身份:应显示订阅账号信息与当前模型

订阅接入完成,Claude Code 的用量走 Max 订阅额度。如果之前登录过其他账号,先 /logout 再重新登录 Max 账号,避免用到旧账号的额度。登录成功后,模型调用、子代理、Skills 都走订阅池,直到触发每 5 小时或每周的重置限额。

方式 B:API Key 按量付费

1. 登录 console.anthropic.com(Console 与订阅可用同一账号,但计费独立)

2. 进入 API Keys 页面,创建新 Key(以 sk-ant- 开头),保存好

3. 配置:推荐写入 ~/.claude/settings.json 的 env 字段,或临时 export ANTHROPIC_API_KEY=sk-ant-...

4. 运行 claude 后输入 /status 确认身份为 API Key 计费

示例配置(写入 ~/.claude/settings.json):

{

  "env": {

    "ANTHROPIC_API_KEY": "sk-ant-你的密钥"

  }

}

安全提醒:API Key 等于账户的钱包钥匙,不要提交进 Git 仓库,不要发给第三方;一旦泄露,第一时间在 Console 删除重建。脚本里优先用环境变量注入,而不是硬编码进代码。

配置完成后,在任意项目目录运行 claude 做一次简单任务,再 /status 确认计费身份,首次调用通常很快能出结果。如果一直报认证失败,回 Console 检查 Key 是否有效、余额是否充足。

两条路对比

| 维度 | 订阅 OAuth | API Key 按量付费 |

| --- | --- | --- |

| 凭证 | claude.ai 账号授权(/login) | Console 创建的 Key |

| 计费 | 每月订阅费(Pro 20 美元/Max 100/200 美元) | 按 token 从余额扣 |

| 额度 | 订阅限额,周期性重置 | 充多少用多少 |

| 适合 | 个人日常交互开发 | 脚本、CI、自动化、团队 |

| 积分 | Max/Team 有月度 API 积分 | 无订阅积分,纯按量 |

对比 API 按量充多少用多少、无固定上限)

套餐与档位怎么选,可参考站内 Claude Max 与 Pro 对比;具体模型按量价格可看 Claude Haiku 5.5 API 价格。

常被忽略的优先级坑

场景:你买了 Max,也 /login 过,但某天发现 Console 在扣钱。原因:环境变量或配置文件里残留了 API Key,它的优先级高于订阅 OAuth。

排查三步:echo $ANTHROPIC_API_KEY 看环境变量;检查 ~/.claude/settings.json 是否写了 ANTHROPIC_API_KEY;确认后删除残留,再 /status 确认当前身份回到订阅。

常见报错速查

| 现象 | 原因 | 解法 |

| --- | --- | --- |

| 登录不弹浏览器 | 本地回调端口被占用 | 按 c 复制登录链接手动打开 |

| 浏览器显示验证码 | WSL2/SSH/容器无法回调 | 把 code 粘贴到终端提示处 |

| /status 显示 API key | 环境变量残留优先 | 清除 ANTHROPIC_API_KEY 后重登 |

| 429/额度用尽 | 订阅限额或 API 余额不足 | 等重置或充值;Max 用户领月度积分 |

| 国内卡支付失败 | 官方支付限制 | 参考站内国内可用性文章 |

行动指引:先 /status 看清自己当前用的是订阅身份还是 API Key,再决定要不要动配置。日常写代码保持订阅 OAuth 登录,自动化任务单独用 API Key,两边分开账单就不会乱。Max 和 Team 用户记得每月先领积分再用,配合订阅额度,是目前最划算的组合。订阅额度、月度积分、API 余额是三个独立池子,分清它们,配置就不会出错。