Claude Code 的 API 接口配置,核心是把 Anthropic API 密钥写进 ANTHROPIC_API_KEY 环境变量,再按需设置模型、Base URL 或云厂商开关。下面把官方入口、环境变量清单和常见坑点逐一说明。 - Claude Code 文档:code.claude.com,安装、配置与环境变量说明;
- Anthropic 控制台:console.anthropic.com,创建与管理 API 密钥;
- Claude 网页端:claude.ai,登录即用,不走按量计费;
- API 文档:docs.anthropic.com,接口、模型与计费细则;
- 帮助中心:support.anthropic.com,密钥与配置问题排查。
注意区分:网页端免费用订阅额度;开放平台与 API 按 token 计费,面向开发者。官方入口只此几处,建议从官方页面直接进入。
API密钥获取与环境变量设置
- 打开 Anthropic 控制台(console.anthropic.com),登录后进入 API Keys 页面创建密钥;
- 复制密钥,临时生效可在终端直接执行
export ANTHROPIC_API_KEY='your-api-key-here'(macOS / Linux);
- 密钥只显示一次,请立即复制保存,丢失只能到控制台删除重建;
- 永久生效需写入 shell 配置(如
~/.zshrc 或 ~/.bash_profile),保存后执行 source ~/.zshrc 或重开终端;
- Windows 在「系统属性 → 环境变量」里新增
ANTHROPIC_API_KEY,重启终端后生效。
验证是否生效:在 Claude Code 内输入 /status 查看当前鉴权方式,或在终端执行 echo $ANTHROPIC_API_KEY。
Claude Code环境变量配置表
下表变量均来自 Claude Code 官方文档,在启动 claude 前的 shell 中设置,或写入 settings.json 的 env 项:
| | |
|---|
| | |
ANTHROPIC_MODEL(或 CLAUDE_MODEL) | | Anthropic 模型标识,可用 /model 查看当期列表 |
| | 默认 https://api.anthropic.com,走代理/网关时改此项 |
| 自定义 Authorization Bearer 令牌 | |
CLAUDE_CODE_USE_BEDROCK=1 | | 配合 AWS 凭证,可加 ANTHROPIC_BEDROCK_BASE_URL |
| 改用 Google Cloud Agent Platform | 配合 GCP 凭证,可加 ANTHROPIC_VERTEX_BASE_URL |
CLAUDE_CODE_USE_FOUNDRY=1 | | 配合 Azure 凭证,可加 ANTHROPIC_FOUNDRY_BASE_URL |
Claude Platform on AWS 另需 CLAUDE_CODE_USE_ANTHROPIC_AWS=1 加 ANTHROPIC_AWS_WORKSPACE_ID。各云厂商走的是对应凭证体系,设了开关后 ANTHROPIC_API_KEY 不再参与鉴权。
模型选择与认证优先级
选模型有三种方式:启动时加 --model、会话内用 /model 打开选择器、或设 ANTHROPIC_MODEL 固定默认。模型标识遵循 Sonnet、Opus、Haiku 等能力档位,具体可用 ID 以 /model 列表为准。
密钥与订阅的优先级:只要环境里存在 ANTHROPIC_API_KEY,Claude Code 就会用它替代 Pro / Max / Team / Enterprise 订阅来计费——即便你已经登录。非交互模式(-p)下密钥始终生效;交互模式会先弹一次确认再覆盖订阅。想回到订阅额度,执行 unset ANTHROPIC_API_KEY 即可。
Claude Code API配置注意事项
- 密钥只活在当前 shell:临时 export 仅本次会话有效,永久生效必须写进 ~/.zshrc 等并 source 或重开终端。
- 设了密钥就走计费:ANTHROPIC_API_KEY 存在时会改用按量计费,与是否登录订阅无关;想用订阅额度先 unset 它。
- 网关要兼容 Messages 格式:ANTHROPIC_BASE_URL 指向的网关必须实现 /v1/messages,裸 OpenAI 端点不做翻译会直接失败。
- 官方不允许第三方代登:Anthropic 不允许第三方为产品提供 claude.ai 登录或速率限制,请使用本文的 API 密钥鉴权方式。
- SDK 不自动读 .env:Agent SDK 从进程环境取密钥,不会自动加载 .env,需自行用 dotenv 或手动导出。
- 改完变量要重启终端:常见坑是改了配置却没 source / 重开终端,结果仍读不到密钥。
- 网关会关 MCP 工具搜索:BASE_URL 指向非官方主机时,MCP 工具搜索默认关闭,确需可设 ENABLE_TOOL_SEARCH=true。
Claude Code API配置常见问题
Q:Claude Code API 免费吗?
A:API 调用按 token 计费;不设密钥时也可用 Pro / Max 等订阅额度,由登录态承担。
Q:API 密钥在哪里拿?
A:到 Anthropic 控制台(console.anthropic.com)的 API Keys 页面创建,密钥只显示一次。
Q:怎么确认密钥已经生效?
A:在 Claude Code 里输入 /status 看当前鉴权方式,或终端执行 echo $ANTHROPIC_API_KEY 检查。
Q:能接第三方或自建网关吗?
A:能。把 ANTHROPIC_BASE_URL 指向兼容 Anthropic Messages 格式的网关,并用 ANTHROPIC_AUTH_TOKEN 鉴权。
Q:支持哪些云厂商?
A:AWS Bedrock、Google Cloud Agent Platform、Microsoft Foundry,分别开对应 USE_ 开关并配云凭证。
Q:怎么切换模型?
A:启动时加 --model、会话内用 /model 选择,或设 ANTHROPIC_MODEL 固定默认模型。
Q:设了密钥还会扣订阅吗?
A:不会。存在 ANTHROPIC_API_KEY 就改用按量计费,想用订阅额度先 unset 它。
Q:密钥泄露了怎么办?
A:立刻到控制台删除并重建密钥,同时清理 shell 配置与该密钥的历史记录。
Q:走网关时数据安全吗?
A:官方服务按 Anthropic 隐私政策处理数据;经企业网关时,凭证与审计由网关方管理。
Claude Code API配置 走的是环境变量这条路:密钥、模型、网关各自一个变量,配齐就能稳定跑起来。想持续跟进 Claude Code API配置 的最新变动与坑点,可以关注本站的 AI 工具栏目。