#API 配置

#获取 Anthropic API Key

Anthropic API Key 是使用 Claude Code 的必要凭证。让我们逐步了解如何获取：

#步骤 1：注册 Anthropic 账号

1. 访问 Anthropic Console
2. 点击 "Sign Up"（注册）
3. 使用 Email 或 Google 账号注册
4. 验证邮箱地址

#步骤 2：充值账户余额

重要提示：Anthropic API 是付费服务，需要预先充值

1. 登录后进入 "Billing"（计费）页面
2. 点击 "Add Credit"（添加余额）
3. 选择充值金额（建议首次充值 $20-$50）
4. 使用信用卡完成支付

#步骤 3：创建 API Key

1. 进入 "API Keys" 页面
2. 点击 "Create Key"（创建密钥）
3. 设置 Key 名称（例如：claude-code-dev）
4. （可选）设置使用限制和权限
5. 点击 "Create"
6. 重要：立即复制并保存 API Key（只显示一次！）

API Key 格式：

sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

#配置 API Key

有多种方式配置 API Key，选择最适合你的方法：

#方法 1：交互式登录（推荐）

# 启动 Claude Code，在会话内执行 /login
claude
> /login

# 按提示选择登录方式：
# - Claude 订阅账号（Pro/Max，浏览器 OAuth 登录）
# - Anthropic Console 账号（按 API 用量计费）

#方法 2：环境变量配置

临时设置（当前会话）：

# Linux/macOS
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"

# Windows (PowerShell)
$env:ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"

永久设置：

Linux/macOS (Bash):

# 编辑 .bashrc 或 .zshrc
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.bashrc
source ~/.bashrc

Linux/macOS (Fish):

set -Ux ANTHROPIC_API_KEY "sk-ant-api03-xxxxx"

Windows (PowerShell):

[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-api03-xxxxx', 'User')

#方法 3：设置文件中的 env 字段

编辑 ~/.claude/settings.json，通过 env 字段为会话注入环境变量（适合配置代理网关等场景）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://your-gateway.example.com",
    "ANTHROPIC_AUTH_TOKEN": "your-token"
  }
}

#方法 4：apiKeyHelper 脚本

如果团队通过脚本分发密钥，可在 ~/.claude/settings.json 中配置 apiKeyHelper，Claude Code 会执行该脚本获取 API Key：

{
  "apiKeyHelper": "/path/to/get-api-key.sh"
}

#API 定价与使用

#模型定价（2026年1月）

M = Million (百万)

#成本估算示例

简单任务（修复小 bug）：

• Input: ~1,000 tokens
• Output: ~500 tokens
• 成本：~$0.01 (Sonnet 4.6)

中等任务（实现新功能）：

• Input: ~5,000 tokens
• Output: ~2,000 tokens
• 成本：~$0.05 (Sonnet 4.6)

复杂任务（重构大型模块）：

• Input: ~20,000 tokens
• Output: ~8,000 tokens
• 成本：~$0.20 (Sonnet 4.6)

#查看使用情况

# 会话内：查看当前会话的 token 消耗
> /cost

# 订阅用户：查看套餐用量
> /usage

# API 计费用户：在 Anthropic Console 的 Usage 页面查看详细统计

#成本控制技巧

1. 选择合适的模型

   • 简单任务用 Haiku
   • 一般任务用 Sonnet
   • 复杂任务才用 Opus

2. 优化 Prompt

   • 清晰简洁的任务描述
   • 减少不必要的上下文

3. 使用子代理

   • 探索任务用 Explore Agent（haiku）
   • 规划任务用 Plan Agent

4. 设置预算限制

   • 在 Anthropic Console 的 "Limits" 页面设置每月消费上限
   • 配置用量告警，在接近上限前收到通知

#API 安全最佳实践

#🔒 保护你的 API Key

1. 永远不要提交到版本控制

# .gitignore 中添加
.env
config.json
**/*api-key*

2. 使用环境变量

# 推荐：使用环境变量而非硬编码
export ANTHROPIC_API_KEY="sk-ant-xxx"

3. 限制 Key 权限

• 在 Anthropic Console 中设置 Key 权限
• 为不同环境创建不同的 Key
• 定期轮换 API Keys

4. 监控使用情况

# 会话内查看当前会话的 token 消耗
> /cost

# 订阅用户查看套餐用量
> /usage

# API 计费用户：在 Anthropic Console 的 Usage 页面
# 查看用量明细，并可设置月度预算与告警

5. 安全存储

# 限制配置文件权限
chmod 600 ~/.claude/settings.json

#⚠️ 泄露后的应对

如果 API Key 泄露：

1. 立即撤销 Key

   • 登录 Anthropic Console
   • 在 API Keys 页面删除泄露的 Key

2. 检查使用记录

   • 查看是否有异常调用
   • 检查账单

3. 创建新 Key

   • 生成新的 API Key
   • 更新所有配置

4. 更新安全措施

   • 检查 .gitignore
   • 加强权限控制

#多 API Key 管理

对于团队或多项目场景，你可能需要管理多个 API Keys：

#场景 1：不同项目使用不同 Key

在每个项目的 .claude/settings.local.json（个人配置，不提交 git）中通过 env 字段指定该项目使用的 Key：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-projectA-xxx"
  }
}

Claude Code 在该项目目录启动时会自动应用此配置。

#场景 2：开发和生产环境分离

通过环境变量在启动时切换：

# 开发环境：用更经济的模型
ANTHROPIC_API_KEY=sk-ant-dev-xxx ANTHROPIC_MODEL=claude-haiku-4-5 claude

# 生产相关任务：用能力更强的模型
ANTHROPIC_API_KEY=sk-ant-prod-xxx ANTHROPIC_MODEL=claude-sonnet-4-6 claude

也可以封装成 shell alias 方便日常使用。

#场景 3：团队成员各自的 Key

团队配置建议：

1. 每个成员使用自己的 API Key
2. 共享配置放在 .claude/settings.json（提交 git），个人 Key 放在 .claude/settings.local.json（在 .gitignore 中忽略）
3. 或在共享配置中使用 apiKeyHelper 脚本统一分发密钥

// .claude/settings.json（团队共享，不含密钥）
{
  "model": "claude-sonnet-4-6",
  "apiKeyHelper": "./scripts/get-team-api-key.sh"
}

#验证配置

配置完成后，验证一切正常：

# 1. 健康检查（诊断安装与认证状态）
claude doctor

# 2. 查看当前配置
claude config list

# 3. 测试简单任务
claude -p "say hello"

# 4. 会话内查看当前登录状态与认证方式
claude
> /status

#小结

在本章中，我们学习了：

• ✅ 如何注册 Anthropic 账号并获取 API Key
• ✅ 四种配置 API Key 的方法
• ✅ API 定价和成本估算
• ✅ API 安全最佳实践
• ✅ 多 API Key 管理策略
• ✅ 配置验证方法

重要提醒：

• 🔐 妥善保管你的 API Key
• 💰 关注使用成本，设置预算警报
• 🔄 定期轮换 API Keys
• 📊 监控使用情况