Claude Code 多服务商配置与切换完整教程

子燕若水

757人浏览 · 2026-05-27 11:50:21

子燕若水 · 2026-05-27 11:50:21 发布

https://linux.do/t/topic/1779614
https://linux.do/t/topic/2230328

一、前言

Claude Code（简称 CC）是 Anthropic 推出的终端 AI 客户端，官方服务未对中国大陆开放，国内需借助代理、第三方转接节点（Anyrouter、阿里云百炼、DeepSeek 等）正常使用。

本教程整合全局配置、多服务商独立配置、模型映射、启动命令、排错、避坑规则，采用「全局公共配置 + 独立服务商配置文件」方案，实现一键切换不同接口，兼顾通用性与灵活性。

二、核心概念说明

2.1 配置文件分类

配置文件	路径	作用	优先级
全局配置	`~/.claude/settings.json`	所有服务商共用：代理、功能开关、会话保留、通用规则	低
服务商独立配置（Profile）	`~/.claude/settings.xxx.json`	单服务商专属：接口地址、密钥、模型映射、锁定模型	高（覆盖全局同名配置）
登录引导控制	`~/.claude.json`	控制是否跳过官方登录引导，新安装必改	-

2.2 启动参数 `--settings`

执行逻辑：

优先加载全局配置；
加载指定的服务商独立配置，同名字段直接覆盖全局；
合并后配置正式生效。

使用格式：

claude --settings ~/.claude/settings.xxx.json

2.3 关键规则

所有配置文件为标准 JSON 格式：末尾键值对不能加逗号，中间键值对必须加逗号；
env 内开关项必须使用字符串："1"=开启，"0"=关闭，禁止使用布尔值/纯数字；
接口地址 ANTHROPIC_BASE_URL 仅填写域名前缀，不要手动拼接 /v1，CC 会自动补全接口路径。

三、前置操作：跳过官方登录引导

新安装 Claude Code 会强制弹出官方登录引导，国内环境直接跳过即可。

编辑文件 ~/.claude.json；
写入/修改顶层字段：

{
  "hasCompletedOnboarding": true
}

true：跳过登录引导，直接进入交互界面；
false：弹出官方登录页（国内无法使用）。

四、全局配置 `~/.claude/settings.json`

存放所有服务商通用配置：网络代理、功能开关、会话保留策略，无需在每个服务商配置中重复编写。

4.1 通用模板（推荐）

{
  "env": {
    "HTTP_PROXY": "http://192.168.3.31:7897",
    "HTTPS_PROXY": "http://192.168.3.31:7897",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "DISABLE_INSTALLATION_CHECKS": "1",
    "ENABLE_TOOL_SEARCH": "1"
  },
  "cleanupPeriodDays": 720
}

4.2 字段详细释义

配置项	作用
`HTTP_PROXY` / `HTTPS_PROXY`	全局局域网代理地址，为 CC 统一配置网络代理
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: "1"`	一键禁用：自动更新、错误上报、遥测数据、反馈入口，精简流量
`CLAUDE_CODE_ATTRIBUTION_HEADER: "0"`	关闭客户端标识请求头，提升第三方节点缓存命中率
`DISABLE_INSTALLATION_CHECKS: "1"`	关闭安装方式校验，消除 npm 安装的黄色警告
`ENABLE_TOOL_SEARCH: "1"`	开启工具延迟加载，大上下文场景可保留；转接节点兼容差可改为 `"0"`
`cleanupPeriodDays: 720`	会话记录保留 720 天（2年），默认仅保留30天

说明：全局不填写接口地址、密钥、模型，交由独立服务商配置单独管理。

五、多服务商独立配置（Profile）

根据不同转接节点，创建专属配置文件，仅编写当前服务商独有的内容，自动继承全局代理与开关。

5.1 案例一：Anyrouter（Any牌路由器）

特点：模型 ID 与 Claude 官方完全一致，无需额外映射，仅需配置接口、密钥，并锁定可用模型。
文件路径：~/.claude/settings.anyrouter.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://anyrouter.top",
    "ANTHROPIC_AUTH_TOKEN": "你的个人Token"
  },
  "model": "opus[1m]"
}

补充说明

ANTHROPIC_BASE_URL：节点根地址，禁止追加 /v1；
ANTHROPIC_AUTH_TOKEN：服务商分配的鉴权密钥；
"model": "opus[1m]"：Anyrouter 已下线 Sonnet 模型，全局锁定 Opus 1M 模型，避免报错。

启动命令

claude --settings ~/.claude/settings.anyrouter.json

5.2 案例二：阿里云百炼

特点：无原生 Claude 模型 ID，必须手动做模型映射，将 Claude 分类映射为通义千问模型。
文件路径：~/.claude/settings.aliyun.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_API_KEY": "你的阿里云API密钥",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.5-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.5-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.5-plus"
  }
}

补充说明

密钥字段为 ANTHROPIC_API_KEY，和 Anyrouter 字段名不同，注意区分；
模型映射规则：
- haiku/sonnet → 映射为轻量快速模型 qwen3.5-flash；
- opus → 映射为高性能模型 qwen3.5-plus。

启动命令

claude --settings ~/.claude/settings.aliyun.json

5.3 案例三：DeepSeek（你的当前在用）

特点：第三方大模型兼容 Claude 接口，需完整模型映射、子代理、思考强度配置。
文件路径：~/.claude/settings.deepseek.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API密钥",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  },
  "model": "haiku"
}

补充说明

模型映射：高端模型统一使用 deepseek-v4-pro[1m]，轻量场景使用 deepseek-v4-flash；
CLAUDE_CODE_SUBAGENT_MODEL：子代理调用轻量模型，提速省费；
CLAUDE_CODE_EFFORT_LEVEL: "max"：开启最高思考强度；
全局默认启动 haiku（对应映射为 flash 模型），如需默认使用高端模型，改为 "model": "opus"。

启动命令

claude --settings ~/.claude/settings.deepseek.json

六、常见故障排查

故障现象	原因	解决方案
短时间返回 403	模型额度/账号余额耗尽	切换已锁定的可用模型，查询账号配额
`ECONNRESET` 连接重置	代理失效、接口地址错误、网络不通	检查代理状态、核对 `ANTHROPIC_BASE_URL`
4xx 报错无返回内容	当前选中模型不可用	1. 切换模型；2. 携带 Token 访问 `接口地址/v1/models` 查询可用模型
使用中突然中断	Haiku 模型欠费/额度不足	全程锁定 Opus 类高端模型，规避轻量模型