Claude Code: API 配置与模型选择
最后更新:2026-08-31
Claude Code 默认使用 Anthropic API,但也支持通过兼容接口接入 DeepSeek 等第三方模型。合理配置 API 是控制成本和效果的关键。
💡 提示:Claude Code 原生支持 Anthropic API,通过
ANTHROPIC_API_KEY 环境变量配置。第三方模型需要 OpenAI 兼容接口。
📋 前置知识:第二章 安装与使用
1. 你将学到
- Anthropic API 配置与计费
- DeepSeek 等第三方模型接入
- 模型选择策略(Sonnet vs Opus)
- API 费用估算
- 多 API Key 管理
2. Anthropic API 配置
(1) 获取 API Key
BASH
# 步骤:
# 1. 访问 https://console.anthropic.com/
# 2. 注册/登录账号
# 3. 进入 API Keys 页面
# 4. 点击 "Create Key"
# 5. 复制 Key(格式:sk-ant-api03-xxxxx)
(2) 配置环境变量
BASH
# 临时设置(当前终端有效)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"
# 永久设置(写入 shell 配置)
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.zshrc
source ~/.zshrc
# 验证
echo $ANTHROPIC_API_KEY
# sk-ant-api03-xxxxx
(3) 模型选择
| 模型 | 上下文 | 输入价格 | 输出价格 | 适用场景 |
|---|---|---|---|---|
| Claude Sonnet | 200K | $3/MTok | $15/MTok | 日常编程,性价比最优 |
| Claude Opus | 200K | $15/MTok | $75/MTok | 复杂架构,需要深度推理 |
| Claude Haiku | 200K | $0.25/MTok | $1.25/MTok | 快速查询,低成本 |
BASH
# 指定模型
claude --model claude-sonnet-4-20250514
claude --model claude-opus-4-20250514
# 或通过环境变量
export CLAUDE_MODEL="claude-sonnet-4-20250514"
3. DeepSeek 模型接入
(1) 配置 DeepSeek API
DeepSeek 提供 OpenAI 兼容接口,可被 Claude Code 使用:
BASH
# 设置 DeepSeek API
export ANTHROPIC_API_KEY="your-deepseek-api-key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com"
# 或使用 OpenAI 兼容端点
export OPENAI_API_KEY="your-deepseek-api-key"
export OPENAI_BASE_URL="https://api.deepseek.com/v1"
(2) DeepSeek 模型对比
| 模型 | 上下文 | 价格(输入/输出) | 适用场景 |
|---|---|---|---|
| DeepSeek V3 | 128K | ¥2/MTok / ¥8/MTok | 通用编程,性价比极高 |
| DeepSeek R1 | 128K | ¥4/MTok / ¥16/MTok | 深度推理,数学/逻辑 |
▶ 示例 1: DeepSeek 配置完整流程
BASH
# Alice 使用 DeepSeek 降低成本
# 1. 获取 DeepSeek API Key
# 访问 https://platform.deepseek.com/
# 2. 配置环境变量
export ANTHROPIC_API_KEY="sk-deepseek-xxxxx"
export ANTHROPIC_BASE_URL="https://api.deepseek.com"
export CLAUDE_MODEL="deepseek-chat"
# 3. 运行 Claude Code
claude "帮我重构这个函数"
4. 费用估算与控制
(1) Token 消耗模式
Claude Code 的 Token 消耗主要来自:
| 消耗来源 | 占比 | 说明 |
|---|---|---|
| 项目上下文 | 40-60% | 读取项目文件内容 |
| 对话历史 | 20-30% | 之前的交互记录 |
| 代码输出 | 10-20% | 生成的代码 |
| 系统提示 | 5-10% | CLAUDE.md 等指令 |
(2) 费用估算
▶ 示例 2: 月度费用估算脚本
PYTHON
def estimate_monthly_cost(
daily_sessions: int,
avg_context_tokens: int,
avg_output_tokens: int,
model_input_price: float,
model_output_price: float,
working_days: int = 22
):
daily_input = daily_sessions * avg_context_tokens
daily_output = daily_sessions * avg_output_tokens
monthly_input = daily_input * working_days
monthly_output = daily_output * working_days
cost = (
monthly_input * model_input_price / 1_000_000
+ monthly_output * model_output_price / 1_000_000
)
return round(cost, 2)
# Sonnet 方案
sonnet_cost = estimate_monthly_cost(
daily_sessions=10,
avg_context_tokens=50000,
avg_output_tokens=5000,
model_input_price=3,
model_output_price=15
)
print(f"Sonnet 月费: ${sonnet_cost}")
# DeepSeek 方案
deepseek_cost = estimate_monthly_cost(
daily_sessions=10,
avg_context_tokens=50000,
avg_output_tokens=5000,
model_input_price=0.27,
model_output_price=1.1
)
print(f"DeepSeek 月费: ${deepseek_cost}")
输出:
TEXT
📖 仅展示
Sonnet 月费: $46.2
DeepSeek 月费: $3.74
5. 多 API Key 管理
▶ 示例 3: 按项目切换 API 配置
BASH
# 在 .env 文件中按项目配置
# project-a/.env
ANTHROPIC_API_KEY=sk-ant-project-a-key
CLAUDE_MODEL=claude-sonnet-4-20250514
# project-b/.env
ANTHROPIC_API_KEY=sk-deepseek-key
ANTHROPIC_BASE_URL=https://api.deepseek.com
CLAUDE_MODEL=deepseek-chat
# 使用 direnv 自动切换
# .envrc
source .env
export ANTHROPIC_API_KEY
export ANTHROPIC_BASE_URL
export CLAUDE_MODEL
(2) API 额度监控
BASH
# 检查 Anthropic API 用量
curl https://api.anthropic.com/v1/usage \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01"
# Claude Code 内置统计
claude /cost
# 当前会话 Token 使用量: 125,430
# 估算费用: $2.34
6. 综合示例:成本优化配置
BASH
# Alice 的成本优化方案
# 核心项目:使用 Sonnet(质量优先)
export PROJECT_CORE_API_KEY="sk-ant-api03-xxxxx"
export PROJECT_CORE_MODEL="claude-sonnet-4-20250514"
# 辅助项目:使用 DeepSeek(成本优先)
export PROJECT_AUX_API_KEY="sk-deepseek-xxxxx"
export PROJECT_AUX_BASE_URL="https://api.deepseek.com"
export PROJECT_AUX_MODEL="deepseek-chat"
# 在 shell alias 中配置
alias claude-core='ANTHROPIC_API_KEY=$PROJECT_CORE_API_KEY CLAUDE_MODEL=$PROJECT_CORE_MODEL claude'
alias claude-aux='ANTHROPIC_API_KEY=$PROJECT_AUX_API_KEY ANTHROPIC_BASE_URL=$PROJECT_AUX_BASE_URL CLAUDE_MODEL=$PROJECT_AUX_MODEL claude'
# 使用
cd core-project && claude-core "重构认证模块"
cd side-project && claude-aux "添加日志功能"
❓ 常见问题
Q DeepSeek 的效果和 Claude 差多少?
A DeepSeek V3 在编程任务上接近 Claude Sonnet 的 80-90% 水平,但复杂推理和长上下文理解仍有差距。对日常编程足够,关键任务建议用 Claude。
Q API Key 泄露了怎么办?
A 立即在控制台撤销该 Key,生成新的。检查 git 历史是否误提交了 Key。
Q 免费额度能用多久?
A Anthropic 新账号赠送 $5 额度,按 Sonnet 价格约支持 50-100 次中等复杂度编程会话。
Q 可以同时配置多个 API 吗?
A 可以。通过环境变量在不同项目间切换,或使用 direnv 自动切换。
Q DeepSeek 上下文长度够用吗?
A DeepSeek V3 支持 128K 上下文,对大多数项目足够。超大项目(100+ 文件)可能需要 Claude 的 200K。
Q 如何知道当前用了多少 Token?
A 在 Claude Code 中输入
/cost 可查看当前会话的 Token 用量和估算费用。📖 小节
- Anthropic API 通过
ANTHROPIC_API_KEY环境变量配置 - Sonnet 性价比最优,Opus 适合复杂推理,Haiku 适合快速查询
- DeepSeek 通过 OpenAI 兼容接口接入,成本仅为 Claude 的 1/10
- Token 消耗主要来自项目上下文(40-60%)
- 通过环境变量和 alias 实现多 API 配置切换
📝 作业
- 基础题(难度⭐):配置 Anthropic API Key,运行 Claude Code 确认连接成功。
- 进阶题(难度⭐⭐):估算你团队每月使用 Claude Code 的 API 费用(使用示例中的脚本)。
- 挑战题(难度⭐⭐⭐):搭建 DeepSeek 接入方案,对比同一任务在 Claude Sonnet 和 DeepSeek V3 上的效果和成本差异。