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 --set-api-key

# 输入 API Key
Enter your Anthropic API key: sk-ant-api03-xxxxx

# 确认保存
✓ API key saved successfully

方法 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：配置文件设置

编辑配置文件：

nano ~/.config/claude-code/config.json

添加 API Key：

{
  "api": {
    "key": "sk-ant-api03-xxxxx",
    "baseUrl": "https://api.anthropic.com"
  }
}

方法 4：.env 文件配置

创建 .env 文件：

# 在项目目录或配置目录创建
nano ~/.config/claude-code/.env

添加内容：

ANTHROPIC_API_KEY=sk-ant-api03-xxxxx

API 定价与使用

模型定价（2026年1月）

模型	输入 (Input)	输出 (Output)	适用场景
Claude Opus 4.5	$15/M tokens	$75/M tokens	最复杂的任务
Claude Sonnet 4.5	$3/M tokens	$15/M tokens	平衡性能和成本（推荐）
Claude Haiku	$0.25/M tokens	$1.25/M tokens	快速简单的任务

M = Million (百万)

成本估算示例

简单任务（修复小 bug）：

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

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

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

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

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

查看使用情况

# 查看当前会话使用
claude --usage

# 查看账户余额
claude --balance

# 查看详细统计
claude --stats

成本控制技巧

1. 选择合适的模型

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

2. 优化 Prompt

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

3. 使用子代理

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

4. 设置预算限制

   {
     "limits": {
       "dailyBudget": 10,
       "monthlyBudget": 100,
       "warningThreshold": 80
     }
   }

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. 监控使用情况

# 定期检查异常使用
claude --usage-report

# 设置预算警报
claude --set-budget-alert 50

5. 安全存储

# 限制配置文件权限
chmod 600 ~/.config/claude-code/config.json

# 加密敏感配置（可选）
gpg -c ~/.config/claude-code/config.json

⚠️ 泄露后的应对

如果 API Key 泄露：

1. 立即撤销 Key

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

2. 检查使用记录

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

3. 创建新 Key

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

4. 更新安全措施

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

多 API Key 管理

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

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

项目 A 配置：

cd /path/to/project-a
echo "ANTHROPIC_API_KEY=sk-ant-projectA-xxx" > .env

项目 B 配置：

cd /path/to/project-b
echo "ANTHROPIC_API_KEY=sk-ant-projectB-xxx" > .env

使用时 Claude Code 会自动读取当前目录的 .env

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

配置文件（config.json）：

{
  "profiles": {
    "dev": {
      "api": {
        "key": "sk-ant-dev-xxx",
        "model": "claude-haiku"
      }
    },
    "prod": {
      "api": {
        "key": "sk-ant-prod-xxx",
        "model": "claude-sonnet-4-5"
      }
    }
  }
}

使用不同配置：

# 开发环境
claude --profile dev "your task"

# 生产环境
claude --profile prod "your task"

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

团队配置建议：

1. 每个成员使用自己的 API Key
2. 在 .gitignore 中忽略个人配置
3. 提供配置模板文件

# config.template.json
{
  "api": {
    "key": "YOUR_API_KEY_HERE",
    "baseUrl": "https://api.anthropic.com"
  }
}

# 成员复制模板并填入自己的 Key
cp config.template.json config.json
# 编辑 config.json 填入个人 API Key

验证配置

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

# 1. 测试 API 连接
claude --test-connection

# 预期输出
✓ API key valid
✓ Connection to api.anthropic.com successful
✓ Model claude-sonnet-4-5 available
✓ Account balance: $45.23

# 2. 查看当前配置
claude --show-config

# 3. 测试简单任务
claude "echo 'Configuration test successful'"

# 4. 检查 API Key 是否正确加载
claude --which-api-key

# 输出：Using API key: sk-ant-***xxx (last 4 chars shown)

小结

在本章中，我们学习了：

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

重要提醒：

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