自学教程

Claude Code API 配置

Claude Code 教程

Claude Code 默认使用网页账号登录，也支持通过 ANTHROPIC_API_KEY API Key 的方式认证。使用 API Key 适合自动化脚本、CI/CD 流水线或者不想每次都网页登录的场景。

获取 Anthropic API Key

  1. 打开 Anthropic 控制台：https://console.anthropic.com/
  2. 登录你的账号
  3. 进入 API Keys 页面，点击 Create new key 创建密钥
  4. 复制生成的密钥，只显示一次，请妥善保存，不要泄露

⚠️ 注意：API Key 和网页账号是两套独立计费。网页订阅额度不能用于 API 调用，API 单独按 Token 计费。

配置环境变量 ANTHROPIC_API_KEY

macOS / Linux / WSL

临时设置（当前终端窗口有效，关闭终端失效）

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxx"

永久配置（bash）

echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

永久配置（zsh，macOS 默认）

echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Windows PowerShell

临时设置

$env:ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxxxxxxxxx"

永久设置（用户环境变量）

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxxxxxxxxxxxxxxxxx", "User")

验证配置

环境变量设置完成后，新开终端执行：

# 查看环境变量是否生效
echo $ANTHROPIC_API_KEY# 启动 claude，会自动读取 API Key
claude

启动时如果识别到环境变量，会优先使用 API Key 登录，跳过网页授权。

两种登录方式对比

登录方式说明适用场景
网页账号登录claude 命令唤起浏览器登录，使用 Claude 订阅额度本地交互式开发，日常使用
API Key 环境变量读取 ANTHROPIC_API_KEY，单独按Token计费脚本、CI、自动化任务

在非交互式命令中使用 API Key

git diff | claude -p "审查本次代码变更"

只要环境变量存在，这条命令自动使用 API Key 认证。

常见问题

  1. API Key 不生效：确认环境变量已刷新，新开终端；检查密钥复制有没有多余空格。
  2. 权限报错 401：API Key 错误、已删除或者账号欠费。
  3. 网页账号额度无法用于 API：网页订阅和 API 是两套计费体系，不能混用。
  4. 密钥泄露：如果 API Key 意外提交到代码仓库，立刻去控制台删除旧密钥并新建。

安全建议

  • 不要把 API Key 硬编码写进代码、提交到 Git 仓库。
  • 优先使用环境变量管理密钥。
  • 最小权限原则，定期轮换 API Key。
标签：

0 条笔记