为什么要给 Claude Code 配置自己的 API Key?
Claude Code 是 Anthropic 推出的 AI 编程工具,能自主完成代码重构、bug 修复、功能开发等复杂任务。
但官方默认用你的 Claude Pro/Max 订阅额度,有两个问题:
- Pro $20/月,Max $100/月,对于 API 开发来说太贵
- 国内 IP 被封,必须翻墙才能用
解决方案:配置 derouter.ai 的 API Key,国内直连,比官方便宜 77%。
前置准备
需要的东西:
- Claude Code CLI(通过 npm 安装,见下方)
- derouter.ai 账号 + API Key(注册免费,充值 $10 起)
Claude Code 安装:
# 需要 Node.js 18+
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
Mac / Linux 配置方法
临时配置(当前终端会话)
export ANTHROPIC_API_KEY="你的-derouter-api-key"
export ANTHROPIC_BASE_URL="https://api.derouter.ai/proxy/v1"
# 验证
claude "你好,测试一下"
永久配置(推荐)
在 ~/.zshrc(zsh)或 ~/.bashrc(bash)末尾添加:
# Claude Code via derouter.ai
export ANTHROPIC_API_KEY="你的-derouter-api-key"
export ANTHROPIC_BASE_URL="https://api.derouter.ai/proxy/v1"
然后执行:
source ~/.zshrc # 或 source ~/.bashrc
Windows 配置方法
方法 A:PowerShell(临时)
$env:ANTHROPIC_API_KEY="你的-derouter-api-key"
$env:ANTHROPIC_BASE_URL="https://api.derouter.ai/proxy/v1"
claude "帮我优化这个函数"
方法 B:系统环境变量(永久)
- 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
- 在「系统变量」区域新建:
- 变量名:ANTHROPIC_API_KEY,变量值:你的 derouter key
- 变量名:ANTHROPIC_BASE_URL,变量值:https://api.derouter.ai/proxy/v1
- 重启 PowerShell / 命令提示符
验证是否配置成功
# 简单测试
claude "用一句话解释什么是 API"
# 如果返回正常回答,说明连接成功
# 如果报错,检查 API Key 是否正确、余额是否充足
实际使用 Claude Code 的常用场景
场景一:代码重构
# 在项目根目录执行
claude "请分析 src/auth 目录的代码结构,找出可以重构的地方,
并给出具体改进建议,重点是可维护性和安全性"
场景二:生成测试用例
claude "为 user_service.py 中的所有 public 函数生成 pytest 测试用例,
覆盖正常情况、边界值和异常情况"
场景三:代码审查,找 bug
claude "请 review 最近的 git diff,找出可能的 bug、安全漏洞和性能问题"
场景四:解释遗留代码
claude "请阅读 legacy_payment.py,用注释的方式解释每个函数的作用,
特别是那些变量名不规范的地方"
费用估算
以一个中型重构任务为例(重构 500 行代码,输入约 10K tokens,输出约 5K tokens):
| 方案 | 费用 |
|---|---|
| Claude Max $100/月 | $100/月(即使只用一次) |
| 官方 API(Sonnet) | $0.048/次 |
| derouter.ai(Sonnet 4.6) | $0.011/次(节省 77%) |
每天做 10 次这样的任务,derouter.ai 月费约 $3.3,vs Claude Max 的 $100。
常见问题
Q:配置后 Claude Code 的所有功能都能用吗?
A:能用绝大部分功能(对话、代码分析、自动执行等)。部分深度绑定 Anthropic 官方服务的高级功能(如 claude.ai 网页整合)可能受限。
Q:derouter.ai 的 Claude 模型会比官方慢吗?
A:实测延迟差异在 10-20% 以内,实际使用几乎感觉不到。国内用户甚至因为省去了翻墙的延迟,体验可能更好。
Q:充值多少合适?
A:先充 $10 试用,观察自己一周的消耗,再决定是否按月充更多。正常个人开发者 $10 够用 1-2 个月。
Q:有没有 Claude Code Agent 功能?
A:Claude Code 的 Agent 模式(claude --agent)在 derouter.ai 上完全支持,可以让 Claude 自主读文件、改代码、运行命令。
总结
Claude Code + derouter.ai API 是目前国内开发者用 AI 编程最经济的方案:
- ✅ 无需翻墙
- ✅ 无需 Claude Pro/Max 订阅
- ✅ 比官方便宜 77%
- ✅ 5 分钟配置完成
充值 $10 起,余额不过期,先用后付不浪费。