Claude Code 接入国产大模型实战:GLM / Qwen 配置全解析

张开发
2026/4/20 20:41:19 15 分钟阅读

分享文章

Claude Code 接入国产大模型实战:GLM / Qwen 配置全解析
文章目录Claude Code 接入国产大模型GLM / Qwen配置说明一、配置示例GLMQwen二、核心思路三、关键参数说明1. ANTHROPIC_BASE_URL2. ANTHROPIC_API_KEY四、API Key 正确姿势1. macOS / Linux2. Windows3. settings.json 可以简化4. 临时变量什么时候用5. 运行时怎么切换模型会话内切换最常用6. 启动时指定整个会话固定用某一档7. 查当前用的哪个8. 几个容易踩的坑五、重点三个模型参数说明1. 分别代表什么2. 实际使用差异OPUSSONNETHAIKU六、国产模型要不要三档分开七、推荐配置方式1. 一档最简单2. 两档更推荐3. 三档精细配置八、常见问题九、总结Claude Code 接入国产大模型GLM / Qwen配置说明用 Claude Code 时很多人会遇到两个比较现实的问题网络不稳定成本不可控其实它本身并没有强绑定模型只是走 Anthropic 的接口协议。只要服务端兼容这套协议就可以换成其他模型。常见的替代方案智谱AI 的 GLM阿里云 的 Qwen配置也不复杂核心就是一个settings.json。一、配置示例GLM{env:{ANTHROPIC_BASE_URL:https://open.bigmodel.cn/api/anthropic,ANTHROPIC_API_KEY:xxxx,ANTHROPIC_DEFAULT_OPUS_MODEL:glm-4.5-air,ANTHROPIC_DEFAULT_SONNET_MODEL:glm-4.5-air,ANTHROPIC_DEFAULT_HAIKU_MODEL:glm-4.5-air}}Qwen{env:{ANTHROPIC_BASE_URL:https://dashscope.aliyuncs.com/apps/anthropic,ANTHROPIC_API_KEY:x-xxx,ANTHROPIC_DEFAULT_OPUS_MODEL:qwen3.5-plus,ANTHROPIC_DEFAULT_SONNET_MODEL:qwen3.5-flash,ANTHROPIC_DEFAULT_HAIKU_MODEL:qwen3-coder-next}}二、核心思路本质就两件事换接口地址Base URL换模型名称Claude Code 不关心你用的是不是 Claude只认接口格式。三、关键参数说明1. ANTHROPIC_BASE_URL请求地址决定流量打到哪里。默认官方接口现在国产模型兼容接口2. ANTHROPIC_API_KEY接口鉴权。四、API Key 正确姿势1. macOS / Linux写入~/.zshrc# 或 ~/.bashrc内容exportANTHROPIC_API_KEY你的keyexportANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic执行source~/.zshrc2. Windowssetx ANTHROPIC_API_KEYxxxxsetx ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic注意需要重新打开终端才生效3. settings.json 可以简化用了上述环境变量之后settings.json里就不用再写 Key 和 URL 了只留模型名就够{env:{ANTHROPIC_DEFAULT_OPUS_MODEL:qwen3.5-plus,ANTHROPIC_DEFAULT_SONNET_MODEL:qwen3-coder-next,ANTHROPIC_DEFAULT_HAIKU_MODEL:qwen3-coder-next}}export临时设的环境变量关掉终端就没了别用这个方式做日常配置调试可以。4. 临时变量什么时候用临时变量export/$env:只在当前终端有效关掉窗口就失效不适合长期使用它更适合临时测试多模型快速切换正常使用还是建议用“持久化变量”如上述示例中的配置5. 运行时怎么切换模型配了多档之后Claude Code 有两种方式在运行时切换。会话内切换最常用启动claude进入交互模式后直接输入/model会弹出一个交互菜单列出可选档位选完立刻生效不需要重启。也可以直接带参数/model opus# 切到 ANTHROPIC_DEFAULT_OPUS_MODEL 对应的模型/model sonnet# 切到 ANTHROPIC_DEFAULT_SONNET_MODEL 对应的模型/model haiku# 切到 ANTHROPIC_DEFAULT_HAIKU_MODEL 对应的模型这里的opus/sonnet/haiku是档位别名不是模型全名——Claude Code 会自动读你配置里对应的那个模型名。配的是qwen3.5-plus输/model opus走的就是它。6. 启动时指定整个会话固定用某一档claude--modelopus# 本次会话全程用 OPUS 档claude--modelsonnet# 本次会话全程用 SONNET 档claude--modelhaiku# 本次会话全程用 HAIKU 档适合明确知道这次任务偏重还是偏轻的情况不用中途再手动切。7. 查当前用的哪个/status显示当前模型不会改变任何设置。实际用法大概是平时默认走 sonnet 档碰到复杂重构/model opus临时换一下搞完再切回来。8. 几个容易踩的坑Base URL 末尾不要加斜杠路径要精确对不上就 404模型名必须和平台文档一致大小写都算写错直接报错Key 要确认有对应模型的调用权限不是所有套餐都开放全部模型网络延迟因人而异建议实测再决定用哪个配置文件里看到的hasCompletedOnboarding: true之类的字段是 Claude Code 自己写的初始化标记忽略即可不影响模型行为。五、重点三个模型参数说明ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL这三个参数其实是“模型分层”。1. 分别代表什么参数对应角色触发场景OPUS重型模型复杂重构、多步骤任务SONNET主力模型日常写代码、改 bugHAIKU轻量模型简单补全、快速问答2. 实际使用差异OPUS复杂逻辑大段代码修改多步骤任务特点稳但慢一点SONNET日常写代码改 bug普通问答基本是主力模型HAIKU简单补全小问题特点快但可能不够细六、国产模型要不要三档分开结论不强制但建议至少分两档原因国产模型分层没有那么细有些只是不同性能版本七、推荐配置方式1. 一档最简单{ANTHROPIC_DEFAULT_OPUS_MODEL:glm-4.5-air,ANTHROPIC_DEFAULT_SONNET_MODEL:glm-4.5-air,ANTHROPIC_DEFAULT_HAIKU_MODEL:glm-4.5-air}2. 两档更推荐{ANTHROPIC_DEFAULT_OPUS_MODEL:qwen3.5-plus,ANTHROPIC_DEFAULT_SONNET_MODEL:qwen3-coder-next,ANTHROPIC_DEFAULT_HAIKU_MODEL:qwen3-coder-next}3. 三档精细配置{ANTHROPIC_DEFAULT_OPUS_MODEL:qwen3.5-plus,ANTHROPIC_DEFAULT_SONNET_MODEL:qwen3.5-flash,ANTHROPIC_DEFAULT_HAIKU_MODEL:qwen3-coder-next}八、常见问题接口必须用/anthropic模型名要和平台一致API Key 要有权限延迟需要自己测九、总结核心就三步换 Base URL配 API Key配置模型关键点环境变量建议用“持久化方式”临时变量只适合测试模型分层可以简单用也可以细调看自己的需求。欢迎关注我的公众号【兮动人】每天分享一些技术文章和实战经验。

更多文章