HuanCode Docs

国内使用 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

  1. 打开 huancode.com/register,用邮箱注册
  2. 注册后进入 控制台 → API Keys,点「创建 API Key」,复制保存好
  3. 进入 控制台 → 充值,微信扫码充值即可

余额永久有效,不过期,按实际用量消耗。


第二步:配置 Claude Code

编辑 Claude Code 配置文件 ~/.claude/settings.json

~/.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_MODELsonnet 别名映射到代理服务实际的模型名
ANTHROPIC_DEFAULT_OPUS_MODELopus 别名映射到代理服务实际的模型名
ANTHROPIC_DEFAULT_HAIKU_MODELhaiku 别名映射到代理服务实际的模型名
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:

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.huancode.com",
    "ANTHROPIC_AUTH_TOKEN": "你的 HuanCode API Key"
  },
  "model": "gpt-5.4"
}

或者 DeepSeek(价格更低):

~/.claude/settings.json
{
  "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_KEYOPENAI_API_KEY

提示 "Insufficient Balance"

控制台 → 充值 补充余额。用量页面 可以查看每次请求的 token 消耗。

响应速度慢

HuanCode 是国内直连,网络延迟通常很低。慢的话一般是模型推理本身的时间:Haiku 最快,Opus 最慢但推理最强。日常编码推荐 Sonnet,速度和质量的平衡点。

这样配置官方支持吗?

完全支持。ANTHROPIC_BASE_URL 是 Claude Code 官方提供的 LLM Gateway 配置方式,Anthropic 官方文档有详细说明。HuanCode 走合规 API 渠道,通过网关转发到 Claude。


总结

  1. 注册 HuanCode → 创建 API Key → 微信充值
  2. 编辑 ~/.claude/settings.json,填入 ANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN
  3. 运行 claude

整个过程不需要梯子,不需要境外信用卡。

遇到问题可以查看 HuanCode 文档 或在评论区留言。

On this page