Claude Code 配置

Claude Code 是 Anthropic 推出的命令行 AI 编程助手。通过简单配置，即可让 Claude Code 通过 HuanCode 网关调用 Claude 模型，无需直接访问 Anthropic 或 AWS。

更多信息请参考 Claude Code 官方 LLM Gateway 文档。

前提条件

已安装 Claude Code CLI（更新到最新版本）
已在 HuanCode 控制台创建 API Key
账户余额充足

完整配置

使用Claude模型

编辑 Claude Code 设置文件 ~/.claude/settings.json，添加以下配置：

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-4.5",
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "CLAUDE_CODE_SKIP_BEDROCK_AUTH": "1",
    "ANTHROPIC_BEDROCK_BASE_URL": "https://api.huancode.com/bedrock",
    "ANTHROPIC_AUTH_TOKEN": "your-huancode-api-key"
  },
  "skipWebFetchPreflight": true,
  "model": "best"
}

将 your-huancode-api-key 替换为你在 HuanCode 控制台获取的 API Key。

使用 OpenAI GPT 模型

编辑 Claude Code 设置文件 ~/.claude/settings.json，添加以下配置：

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.huancode.com",
    "ANTHROPIC_AUTH_TOKEN": "your-huancode-api-key"
  },
  "model": "gpt-5.4"
}

将 your-huancode-api-key 替换为你在 HuanCode 控制台获取的 API Key。

使用 DeepSeek 模型

编辑 Claude Code 设置文件 ~/.claude/settings.json，添加以下配置：

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.huancode.com",
    "ANTHROPIC_AUTH_TOKEN": "your-huancode-api-key"
  },
  "model": "deepseek-v3.2"
}

将 your-huancode-api-key 替换为你在 HuanCode 控制台获取的 API Key。

配置说明

必须设置的环境变量

变量	说明
`ANTHROPIC_BASE_URL`	HuanCode 网关地址
`ANTHROPIC_AUTH_TOKEN`	你的 HuanCode API Key

变量	说明
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Sonnet 模型名称，推荐 `claude-sonnet-4.6`,有新模型时要记得更新
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Opus 模型名称，推荐 `claude-opus-4.6`,有新模型时要记得更新
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Haiku 模型名称，推荐 `claude-haiku-4.5`,有新模型时要记得更新
`CLAUDE_CODE_SUBAGENT_MODEL`	子代理默认使用的模型，推荐设置为 Haiku（`claude-haiku-4.5`）以加快响应速度

默认模型

通过顶层 model 字段设置 Claude Code 启动时的默认模型：

{
  "model": "best"
}

model 支持以下值（详见官方模型配置文档）：

模型别名：

别名	说明
`default`	清除模型覆盖，恢复账户类型推荐的默认模型
`best`	使用最强大的可用模型，当前等同于 `opus`
`sonnet`	最新 Sonnet 模型（当前 Sonnet 4.6），适合日常编码
`opus`	最新 Opus 模型（当前 Opus 4.6），适合复杂推理
`haiku`	快速高效的 Haiku 模型，适合简单任务
`sonnet[1m]`	Sonnet + 100 万 token 上下文窗口
`opus[1m]`	Opus + 100 万 token 上下文窗口
`opusplan`	Plan Mode 用 Opus，执行模式自动切换为 Sonnet