Claude Code接入国产大模型(GLM/Qwen)配置全解析

Written by

in

文章目录
  • 本质就两件事: 换接口地址(Base URL) 换模型名称 Claude Code 不关心你用的是不是 Claude,只认接口格式。
  • ANTHROPIC_DEFAULT_OPUS_MODEL ANTHROPIC_DEFAULT_SONNET_MODEL ANTHROPIC_DEFAULT_HAIKU_MODEL 这三个参数其实是“模型分层”。
  • 结论:不强制,但建议至少分两档 原因: 国产模型分层没有那么细 有些只是不同性能版本
  • 接口必须用 /anthropic 模型名要和平台一致 API Key 要有权限 延迟需要自己测
  • 核心就三步: 换 Base URL 配 API Key 配置模型 关键点:环境变量建议用“持久化方式”,临时变量只适合测试 以上就是Claude Code接入国产大模型(GLM/Qwen)配置全解析的详细内容,更多关于Claude Code接入国产大模型的资料请关注风君子博客其它相关文章!
  • 目录
    • 一、配置示例
      • GLM
      • Qwen
    • 二、核心思路
      • 三、关键参数说明
        • 1. ANTHROPIC_BASE_URL
        • 2. ANTHROPIC_API_KEY
      • 四、API Key 正确姿势
        • 1. macOS / Linux
        • 2. Windows
        • 3. settings.json 可以简化
        • 4. 临时变量什么时候用
        • 5. 运行时怎么切换模型
        • 6. 启动时指定(整个会话固定用某一档)
        • 7. 查当前用的哪个
        • 8. 几个容易踩的坑
      • 五、重点:三个模型参数说明
        • 1. 分别代表什么
        • 2. 实际使用差异
      • 六、国产模型要不要三档分开
        • 七、推荐配置方式
          • 1. 一档(最简单)
          • 2. 两档(更推荐)
          • 3. 三档(精细配置)
        • 八、常见问题
          • 九、总结

            Claude Code 接入国产大模型(GLM / Qwen)配置说明

            用 Claude Code 时,很多人会遇到两个比较现实的问题:

            • 网络不稳定
            • 成本不可控

            其实它本身并没有强绑定模型,只是走 Anthropic 的接口协议。只要服务端兼容这套协议,就可以换成其他模型。

            常见的替代方案:

            • 智谱AI 的 GLM
            • 阿里云 的 Qwen

            配置也不复杂,核心就是一个 settings.json

            {
              "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"
              }
            }

            {
              "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"
              }
            }

            本质就两件事:

            1. 换接口地址(Base URL)
            2. 换模型名称

            Claude Code 不关心你用的是不是 Claude,只认接口格式。

            请求地址,决定流量打到哪里。

            • 默认:官方接口
            • 现在:国产模型兼容接口

            接口鉴权。

            写入:

            ~/.zshrc
            # 或 ~/.bashrc

            内容:

            export ANTHROPIC_API_KEY=你的key
            export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
            

            执行:

            source ~/.zshrc
            

            setx ANTHROPIC_API_KEY "xxxx"
            setx ANTHROPIC_BASE_URL "https://open.bigmodel.cn/api/anthropic"
            

            注意:需要重新打开终端才生效

            用了上述环境变量之后,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 临时设的环境变量关掉终端就没了,别用这个方式做日常配置,调试可以。

            临时变量(export / $env:)只在当前终端有效:

            • 关掉窗口就失效
            • 不适合长期使用

            它更适合:

            • 临时测试
            • 多模型快速切换

            正常使用还是建议用“持久化变量”,如:上述示例中的配置

            配了多档之后,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 走的就是它。

            claude --model opus     # 本次会话全程用 OPUS 档
            claude --model sonnet   # 本次会话全程用 SONNET 档
            claude --model haiku    # 本次会话全程用 HAIKU 档
            

            适合明确知道这次任务偏重还是偏轻的情况,不用中途再手动切。

            /status
            

            显示当前模型,不会改变任何设置。

            实际用法大概是:平时默认走 sonnet 档,碰到复杂重构 /model opus 临时换一下,搞完再切回来。

            • Base URL 末尾不要加斜杠,路径要精确,对不上就 404
            • 模型名必须和平台文档一致,大小写都算,写错直接报错
            • Key 要确认有对应模型的调用权限,不是所有套餐都开放全部模型
            • 网络延迟因人而异,建议实测再决定用哪个

            配置文件里看到的 "hasCompletedOnboarding": true 之类的字段,是 Claude Code 自己写的初始化标记,忽略即可,不影响模型行为。

            ANTHROPIC_DEFAULT_OPUS_MODEL
            ANTHROPIC_DEFAULT_SONNET_MODEL
            ANTHROPIC_DEFAULT_HAIKU_MODEL
            

            这三个参数其实是“模型分层”。

            参数 对应角色 触发场景
            OPUS 重型模型 复杂重构、多步骤任务
            SONNET 主力模型 日常写代码、改 bug
            HAIKU 轻量模型 简单补全、快速问答

            OPUS

            • 复杂逻辑
            • 大段代码修改
            • 多步骤任务

            特点:稳,但慢一点

            SONNET

            • 日常写代码
            • 改 bug
            • 普通问答

            基本是主力模型

            HAIKU

            • 简单补全
            • 小问题

            特点:快,但可能不够细

            结论:不强制,但建议至少分两档

            原因:

            • 国产模型分层没有那么细
            • 有些只是不同性能版本

            {
              "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.5-air",
              "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.5-air",
              "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air"
            }

            {
              "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.5-plus",
              "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3-coder-next",
              "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-coder-next"
            }

            {
              "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.5-plus",
              "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.5-flash",
              "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3-coder-next"
            }

            • 接口必须用 /anthropic
            • 模型名要和平台一致
            • API Key 要有权限
            • 延迟需要自己测

            核心就三步:

            1. 换 Base URL
            2. 配 API Key
            3. 配置模型

            关键点:环境变量建议用“持久化方式”,临时变量只适合测试

            以上就是Claude Code接入国产大模型(GLM/Qwen)配置全解析的详细内容,更多关于Claude Code接入国产大模型的资料请关注风君子博客其它相关文章!

            站内搜索