Claude Code 使用原生 `--settings` 选项配置多个自定义模型供应商

问题描述：

很久没有写博客类文本，已经不知道怎么开场了，直接开始吧

首先需要把 Claude Code 更新到 1.0.61 及以上版本，Anthropic 在这个版本给 Claude Code 添加了 --settings 选项, 这个也是实现原生多模型供应商配置的切入点

image2396×1028 186 KB
Claude Code Changelog

image1871×885 45.4 KB

现在开始配置，打开用户目录下的 .claude 文件夹（如果没有请手动创建），如果不是第一次安装已经在使用了，目录里可能有一个 settings.json 主配置文件记得备份一下后面有用，接下来我直接贴出配置好的 DeepSeek、Kimi、智谱 GLM 的配置文件

settings.json

{ "env": { "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" }, "includeCoAuthoredBy": false }

settings-deepseek.json

{ "env": { "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "API_TIMEOUT_MS": "600000", "ANTHROPIC_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner" } }

settings-kimi.json

{ "env": { "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx", "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic", "API_TIMEOUT_MS": "600000", "ANTHROPIC_MODEL": "kimi-k2-turbo-preview", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2-turbo-preview" } }

settings-glm.json

{ "env": { "ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic", "API_TIMEOUT_MS": "3000000", "ANTHROPIC_MODEL": "glm-4.5", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air" } }

配置完成之后的目录大概长这样
image1270×639 36.9 KB

配置文件搞定之后，下面一个问题就是如果在使用中便捷的切换不同的模型供应商。
你可以使用以下命令来手动指定某一个配置文件启动 Claude Code 但是这样不太方便

claude --settings $HOME/.claude/settings-xxxxx.json

我们可以通过配置 PowerShell 配件文件来实现，在安装 VSCode 的情况下，在 PowerShell 的命令窗口输入

code $PROFILE

会打开 PowerShell 的用户配置文件（如果之前没有会自动创建) 在末尾加入以下行，保存退出并重启 PowerShell，就可以通过 claude-deepseek 等别名来启动到对应的模型供应商了

function claude-packy { claude --settings $HOME/.claude/settings-packycode.json @args } function claude-deepseek { claude --settings $HOME/.claude/settings-deepseek.json @args } function claude-kimi { claude --settings $HOME/.claude/settings-kimi.json @args } function claude-glm { claude --settings $HOME/.claude/settings-glm.json @args }

接下来解释下配置文件，按照命令行提示的描述 --settings 用于加载附加设置，所以我们可以通过一个 settings.json 主配置文件和 N 个附加设置，将自定义模型供应商专属的配置放在各自模型供应商命名的附加设置配件文件里，settings.json 只保留通用的配置。

回收之前提到 目录里可能有一个 settings.json 主配置文件记得备份一下后面有用 的提示，如果你在进行配置之前已经 .claude 目录里已经有了一个 settings.json 你应该检查其中是否包含自定义模型供应商的配置内容，如果有应当将其文件名命名为对应的模型供应商
(settings.json → settings-xxx.json)，并在 PowerShell 配置文件中添加对应的别名函数

关于配置文件的配置项的含义请参阅 Anthropic 的官方文档：
Claude Code 官方文档

另外才知道 --settings 选项的使用 @Haleclipse 已经写过了，更详细的配置教程和问题解决可以参考哈雷佬的帖子

《 Claude Code 终极版 FAQ 指南 》 文档共建

-- 施工中 -- 最近性能下降严重 唉~ “我当 工有所偿 学有所用，无人欺我无依傍” 因最近CC的更新发版速度很快，官方文档的内容存在滞后性 本篇QA 实时 跟进 一些“隐晦”的问题 记录正确的解决方案 解决大家对于Claude Code的从基础到高级的疑惑和问题 这也是本篇的意义所在 安装部分 部分软件包存在 个人偏好 如你明白其作用和意义 按需…

网友解答：

---

--【壹】--：

太强了，感谢大佬

---

--【贰】--：

我没有试过，如果想默认一个供应商，相关的 API 和 Key 需要写到主 settings.json 文件中，如果启动其他供应商配件文件不知道会不会同名覆盖实现你想要的这种效果

---

--【叁】--：

ccr是用来转换的 这个是载入不同配置的

也就是说 可以 很快的 从 用官网服务的情况下 跳去 用其他Anthropic消息格式提供商的模型
而不用 对着 settings.json 来回改 或者倒腾环境变量

---

--【肆】--：

是的这样配置可以实现调用其他供应商的模型，CCR 我没用过 其他功能我不确定

---

--【伍】--：

真。学到了。

---

--【陆】--：

我设置了alias claude=“claude --settings $HOME/.claude/settings-anyrouter.json”,工作良好

---

--【柒】--：

感谢分享！

---

--【捌】--：

可以默认一个提供商吗？

---

--【玖】--：

非常详细，感谢佬友分享，哈雷佬友之前也说过这个方法

---

--【拾】--：

长知识了 没特别关注过

---

--【拾壹】--：

感谢大佬！

---

--【拾贰】--：

谢谢分享

---

--【拾叁】--：

手动切换还是麻烦，可以看看我的
GitHub - caidaoli/ccLoad

• 智能路由：根据渠道优先级优先请求高优先级渠道，相同优先级则轮询调用
• 自动故障切换：当渠道出现故障时，自动切换到其他可用渠道
• 指数级冷却机制：故障渠道使用指数级别冷却时间，避免持续请求故障服务
• 零手动干预：客户端无需手动切换上游渠道，系统自动处理

---

--【拾肆】--：

还可以这样啊 那这是不是和subagents类似的呢

---

--【拾伍】--：

现在都快 v120 了

我直呼火星救援

《 Claude Code 终极版 FAQ 指南 》

v1.0.61 已经添加 --settings 参数，能够便捷化指定加载不同的settings.json配置

image358×188 20.8 KB

---

--【拾陆】--：

还可以这样，学到了

---

--【拾柒】--：

意思是可以不依赖CCR直接使用CC调用其他模型啦?

---

--【拾捌】--：

感谢大佬！

---

--【拾玖】--：

是的这样配置可以同时启动好几个 Claude Code 同时使用不同的供应商