国内使用 Claude Code 完整配置指南(微信支付)
3 分钟配好 Claude Code 国内直连。无访问IP限制,无需境外信用卡,支持 Claude / GPT / DeepSeek,微信支付按量充值。
背景
Claude Code 是 Anthropic 推出的终端 AI 编程助手,能直接在命令行里理解代码库、写代码、跑测试、修 Bug。和 Cursor 相比,它更擅长处理复杂的多文件重构和大型仓库任务。
但国内使用有两道门槛:
- 网络:Anthropic API 需要未被封禁的IP,稳定性差,超时率高
- 支付:官方只支持境外信用卡,国内用户无法直接充值
本文介绍通过 HuanCode 解决这两个问题——国内直连 API,微信支付充值,OpenAI 兼容接口,改两行配置就能用。
前提条件
已安装 Claude Code:
npm install -g @anthropic-ai/claude-code第一步:注册 HuanCode 并获取 API Key
- 打开 huancode.com/register,用邮箱注册
- 注册后进入 控制台 → API Keys,点「创建 API Key」,复制保存好
- 进入 控制台 → 充值,微信扫码充值即可
余额永久有效,不过期,按实际用量消耗。
第二步:配置 Claude Code
编辑 Claude Code 配置文件 ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.huancode.com",
"ANTHROPIC_AUTH_TOKEN": "你的 HuanCode API Key",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.6",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
"CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-4.5"
},
"model": "best"
}如果文件不存在,直接创建:
mkdir -p ~/.claude && touch ~/.claude/settings.json第三步:验证配置
claude正常会看到 Claude Code 交互界面,随便输一句话测试,能回复就说明配置成功。
配置说明
关键环境变量
| 变量 | 说明 |
|---|---|
ANTHROPIC_BASE_URL | 指向 HuanCode 网关,请求不经过 Anthropic 官方,国内直连 |
ANTHROPIC_AUTH_TOKEN | 你的 HuanCode API Key(注意不是 ANTHROPIC_API_KEY) |
ANTHROPIC_DEFAULT_SONNET_MODEL | 把 sonnet 别名映射到代理服务实际的模型名 |
ANTHROPIC_DEFAULT_OPUS_MODEL | 把 opus 别名映射到代理服务实际的模型名 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | 把 haiku 别名映射到代理服务实际的模型名 |
CLAUDE_CODE_SUBAGENT_MODEL | 子代理默认模型,设成 Haiku 加快响应、降低成本 |
模型选择建议
| 场景 | model 值 | 说明 |
|---|---|---|
| 日常编码 | "sonnet" | 速度和能力的平衡点,性价比最优 |
| 复杂架构 / 大任务 | "best" | 使用 Opus,最强推理能力 |
| 控制成本 | "haiku" | 最省 token,简单任务够用 |
| 规划用强模型 | "opusplan" | Plan Mode 用 Opus,执行自动切 Sonnet |
会话中随时切换:
/model sonnet
/model opus
/model haiku切换到 GPT 或 DeepSeek
同一个 Key,同一个配置文件,修改 model 字段即可切换到 GPT-5.4:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.huancode.com",
"ANTHROPIC_AUTH_TOKEN": "你的 HuanCode API Key"
},
"model": "gpt-5.4"
}或者 DeepSeek(价格更低):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.huancode.com",
"ANTHROPIC_AUTH_TOKEN": "你的 HuanCode API Key"
},
"model": "deepseek-v3.2"
}常见问题
提示 "Invalid API Key"
- 确认填的是 HuanCode 的 Key,不是 Anthropic 官方的
- Key 前后不要有多余空格
- 注意变量名是
ANTHROPIC_AUTH_TOKEN,不是ANTHROPIC_API_KEY或OPENAI_API_KEY
提示 "Insufficient Balance"
去 控制台 → 充值 补充余额。用量页面 可以查看每次请求的 token 消耗。
响应速度慢
HuanCode 是国内直连,网络延迟通常很低。慢的话一般是模型推理本身的时间:Haiku 最快,Opus 最慢但推理最强。日常编码推荐 Sonnet,速度和质量的平衡点。
这样配置官方支持吗?
完全支持。ANTHROPIC_BASE_URL 是 Claude Code 官方提供的 LLM Gateway 配置方式,Anthropic 官方文档有详细说明。HuanCode 走合规 API 渠道,通过网关转发到 Claude。
总结
- 注册 HuanCode → 创建 API Key → 微信充值
- 编辑
~/.claude/settings.json,填入ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN - 运行
claude
整个过程不需要梯子,不需要境外信用卡。
遇到问题可以查看 HuanCode 文档 或在评论区留言。