[toc]

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-2726701/bd4e019efd96f04721069a156181402a.png)

# Claude Code 接入国产大模型（GLM / Qwen）配置说明

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

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

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

常见的替代方案：

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

配置也不复杂，核心就是一个 `settings.json`。

---

# 一、配置示例

## GLM

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

## Qwen

```json
{
  "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，只认接口格式。

---

# 三、关键参数说明

## 1. ANTHROPIC_BASE_URL

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

* 默认：官方接口
* 现在：国产模型兼容接口

---

## 2. ANTHROPIC_API_KEY

接口鉴权。

---

# 四、API Key 正确姿势

## 1. macOS / Linux

写入：

```bash
~/.zshrc
# 或 ~/.bashrc
```


内容：

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

执行：

```bash
source ~/.zshrc
```

---

## 2. Windows

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

注意：

* 需要重新打开终端才生效

---

## 3. settings.json 可以简化

用了上述环境变量之后，`settings.json` 里就不用再写 Key 和 URL 了，只留模型名就够：

```json
{
  "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` 进入交互模式后，直接输入：

```bash
/model
```

会弹出一个交互菜单，列出可选档位，选完立刻生效，不需要重启。

也可以直接带参数：

```bash
/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. 启动时指定（整个会话固定用某一档）

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

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

## 7. 查当前用的哪个

```bash
/status
```

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

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

---

## 8. 几个容易踩的坑

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

---

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


# 五、重点：三个模型参数说明

```bash
ANTHROPIC_DEFAULT_OPUS_MODEL
ANTHROPIC_DEFAULT_SONNET_MODEL
ANTHROPIC_DEFAULT_HAIKU_MODEL
```

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

---

## 1. 分别代表什么

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

## 2. 实际使用差异

### OPUS

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

特点：稳，但慢一点

---

### SONNET

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

基本是主力模型

---

### HAIKU

* 简单补全
* 小问题

特点：快，但可能不够细

---

# 六、国产模型要不要三档分开

结论：

> 不强制，但建议至少分两档

原因：

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

---

# 七、推荐配置方式

## 1. 一档（最简单）

```json
{
  "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. 两档（更推荐）

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

---

## 3. 三档（精细配置）

```json
{
  "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. 配置模型

关键点：

> 环境变量建议用“持久化方式”，临时变量只适合测试

模型分层可以简单用，也可以细调，看自己的需求。

---

欢迎关注我的公众号【兮动人】，每天分享一些技术文章和实战经验。


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

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

本文介绍了如何将Claude Code接入国产大模型（GLM/Qwen）的配置方法，主要解决网络不稳定和成本控制问题。核心配置包括修改settings.json文件，替换基础URL和模型名称。文章详细说明了GLM和Qwen的配置示例，并解释了关键参数ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY的作用。

人工智能

开发工具

后端

ClaudeCode接入国产大模型（GLM/Qwen）完整配置指南，通过修改ANTHROPIC_BASE_URL和API_KEY即可切换模型，支持OPUS/SONNET/HAIKU三档分层配置，提供settings.json配置示例、环境变量设置方法及运行时模型切换技巧，解决网络不稳定和成本控制问题。

2026上云采购 | AI焕新·智启新局

tione

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 接入国产大模型实战：GLM / Qwen 配置全解析-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐