Claude Code: API 配置与模型选择

最后更新:2026-08-31

Claude Code 默认使用 Anthropic API,但也支持通过兼容接口接入 DeepSeek 等第三方模型。合理配置 API 是控制成本和效果的关键。

💡 提示:Claude Code 原生支持 Anthropic API,通过 ANTHROPIC_API_KEY 环境变量配置。第三方模型需要 OpenAI 兼容接口。

📋 前置知识:第二章 安装与使用

1. 你将学到


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 用量和估算费用。

📖 小节


📝 作业

  1. 基础题(难度⭐):配置 Anthropic API Key,运行 Claude Code 确认连接成功。
  2. 进阶题(难度⭐⭐):估算你团队每月使用 Claude Code 的 API 费用(使用示例中的脚本)。
  3. 挑战题(难度⭐⭐⭐):搭建 DeepSeek 接入方案,对比同一任务在 Claude Sonnet 和 DeepSeek V3 上的效果和成本差异。
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏