Claude Code 接入 GLM 配置教程

# Claude Code 接入 GLM 配置教程

> 适用：Claude Code CLI / VS Code 插件 + 智谱 GLM 分组  
> 中转站地址：`https://api.zaimod.com`（**纯域名，不带 `/v1`**）  
> 主线：装 CLI → 建令牌（智谱-自部署 / 智谱-官）→ 写 `~/.claude/settings.json` → `claude` 发一句话，约 8 分钟

---

## 一、这条线和《Claude Code 配置教程》是什么关系

Claude Code 本身支持"换后端"：只要 `ANTHROPIC_BASE_URL` 指向别处、`ANTHROPIC_AUTH_TOKEN` 换成那边的 Key，它就会把请求发到那里。GLM 这一路就是靠这个机制接进来的 —— **不需要装任何 GLM 插件，也不用改 CLI 本体**。

但有两个前提必须先讲清，否则很容易配完发现"另一个分组不能用了"：

**1. 只有一份 `~/.claude/settings.json`。** 它不分场景、不分分组，`env` 块是全局生效的。你在里面写了 GLM 的模型映射，Claude 官方分组的会话也会套用同一套映射。所以"在 GLM 和 Claude 之间切换"不是切开关，而是**改同一个文件**（见第八章 8.3）。

**2. VS Code 插件读的是同一份文件。** 用插件的人不用在插件里另设一遍地址和 Key，配好这份 JSON 就够了；反过来，插件里手动填过地址的，会和这里的 `env` 打架。

---

## 二、一分钟速查表

| 项目   | 填什么                                                                             |
| ---- | ------------------------------------------------------------------------------- |
| 配置文件 | `~/.claude/settings.json`（Windows：`C:\Users\<用户名>\.claude\settings.json`）       |
| 地址   | `ANTHROPIC_BASE_URL = "https://api.zaimod.com"` —— **纯域名，不带 `/v1`**              |
| 凭证   | `ANTHROPIC_AUTH_TOKEN = "你的API_KEY"`                                            |
| 令牌分组 | **智谱-自部署** 或 **智谱-官**（两条都行，选哪个由倍率与可用模型决定）                                       |
| 模型映射 | `ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU,FABLE}_MODEL` → `glm-5.2[1M]` / `glm-5.2` |
| 显示名  | 对应的 `_MODEL_NAME` → `glm-5.2`（只影响 `/model` 列表里看到的字）                             |
| 验证   | `claude` 启动屏左下角出现 `API Usage Billing`，`/status` 里的模型是 GLM                       |

**三个容易踩的点：**

1. 地址是**纯域名**。Claude Code 自己会拼 `/v1/messages`，你再加一个 `/v1` 就变成 `/v1/v1/messages` —— 实测 404。
2. 用的是 `ANTHROPIC_AUTH_TOKEN`，不是 `ANTHROPIC_API_KEY`。后者是官方 Key 的变量名，一旦环境里存在，会**压过**配置文件里的设置。
3. `glm-5.2[1M]` 末尾的方括号不是笔误，是 Claude Code 的**长上下文后缀约定**：带 `[1m]` 的别名会按 100 万 token 窗口对待（影响 `/model` 展示、自动压缩时机、以及部分请求参数）。它只是"声明"，不改变服务端真实上限。

---

## 三、第一步：安装 Claude Code CLI

### 3.1 官方安装器（推荐）

```powershell
irm https://claude.ai/install.ps1 | iex
```

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

安装器不需要管理员权限、不需要预装 Node.js，装完是原生二进制，之后用 `claude update` 更新。装完**重开一个终端**再验证 —— 安装器改的是用户级 PATH，已经开着的窗口读不到。

```console
claude --version
claude doctor
```

`doctor` 会顺手告诉你安装方式、配置目录、有没有残留的旧版本冲突，比只看版本号有用。

![](/uploads/editor/20261101/img_6ae62d1eb06441.82676638.png)

### 3.2 npm 安装（备选）

需要 Node.js 22 以上：

```bash
npm install -g @anthropic-ai/claude-code
```

**权限不足时不要加 `sudo`**。`sudo npm -g` 会把文件装成 root 所有，之后 `claude update` 和插件都会因为没权限而失败，官方明确不建议。正确做法是先把 npm 的全局目录指回用户目录：

```bash
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm install -g @anthropic-ai/claude-code
```

如果机器上以前用 npm 装过，现在又用安装器装了一遍，可能出现"版本号比官网旧很多"的情况 —— 用 `which -a claude`（Windows：`where.exe claude`）看是不是旧的在前面。

---

## 四、第二步：打开 `settings.json`

配置目录是 `~/.claude`，文件是 `settings.json`。下面三组命令都会自动建目录、建文件，不用先手动去翻隐藏文件夹。

**Windows（PowerShell）**

```powershell
New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
notepad "$HOME\.claude\settings.json"
```

用记事本保存时注意两点：文件名别变成 `settings.json.txt`（资源管理器「查看」里勾上「文件扩展名」核对），编码选 UTF-8（不要带 BOM）。

**macOS**

```bash
mkdir -p ~/.claude
touch ~/.claude/settings.json
open -e ~/.claude/settings.json
```

**Linux**

```bash
mkdir -p ~/.claude
nano ~/.claude/settings.json
```

nano 里粘完按 `Ctrl+O` 保存、回车确认、`Ctrl+X` 退出。

---

## 五、第三步：建令牌（智谱-自部署 / 智谱-官）

**1. 控制台 → 令牌管理 → 创建令牌**

**2. 名称**随意，建议 `GLM`。

**3. 令牌分组选「默认分组」或「智能自动」**

**4.「模型限制列表」留空**

**5. 提交 → 回到令牌列表 →「密钥」列 → 复制密钥**

![](/uploads/editor/20261101/img_6ae62d63f3f5f8.22257334.png)

菜单里两项别混：**复制密钥** 得到的是一串纯 Key；**复制连接信息** 得到的是带 `Base URL`、`Bearer` 前缀的一整段，粘进 `ANTHROPIC_AUTH_TOKEN` 会直接 401。

---

## 六、第四步：写入 GLM 配置

把下面这段完整粘进 `settings.json`，只把 `你的API_KEY` 换成上一步的 Key（**只替换这串占位文字，别动引号**）：

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.zaimod.com",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "glm-5.2[1M]",
    "ANTHROPIC_DEFAULT_FABLE_MODEL_NAME": "glm-5.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME": "glm-5.2",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1M]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "glm-5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2[1M]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "glm-5.2"
  },
  "attribution": {
    "commit": "",
    "pr": "",
    "sessionUrl": false
  }
}
```

### 6.1 每一行在做什么

| 变量                               | 作用                                                 |
| -------------------------------- | -------------------------------------------------- |
| `ANTHROPIC_BASE_URL`             | 请求发到哪。**纯域名**，不带 `/v1`                             |
| `ANTHROPIC_AUTH_TOKEN`           | 中转站的 Key，会以 `Authorization: Bearer` 发出             |
| `ANTHROPIC_DEFAULT_OPUS_MODEL`   | `opus` 这个别名解析成哪个模型 ID —— 这是真正发给 API 的字符串           |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | 同上，对应 `sonnet` 别名（日常编码默认走这档）                       |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL`  | 同上，对应 `haiku` 别名（后台小任务、摘要走这档）                      |
| `ANTHROPIC_DEFAULT_FABLE_MODEL`  | 同上，对应 `fable` 别名（最长任务那一档；不设时 `fable` 会解析到官方 Fable） |
| `..._MODEL_NAME`                 | 只改 `/model` 列表里显示的名字，不影响请求。接了网关时生效                 |
| `attribution`                    | 控制提交信息与 PR 里的署名。三个键给空串 / `false` = 完全不署名           |

Claude Code 内部是按 **Opus / Sonnet / Haiku / Fable 四个档位**去要模型的。GLM 一个模型要顶四个档，所以四个 `_MODEL` 都要写，漏一个那档就会退回官方 Claude 的模型 ID，请求直接打不通。

### 6.2 关于 `glm-5.2[1M]`

- 方括号后缀是 Claude Code 的约定，官方写法是小写 `[1m]`；如果 `/model` 里没显示出 1M 窗口，把它改成小写再试一次。
- 模型 ID 本身（`glm-5.2`）必须和**模型广场里 GLM 分组的实际名称**一致。改版本时，`_MODEL` 和 `_MODEL_NAME` 一共 8 处要一起改，漏改会出现"主对话能用、后台任务 404"。
- 不确定有哪些模型时，直接在控制台模型广场按分组筛选，别凭记忆写。

### 6.3 为什么地址不能带 `/v1`

Claude Code 走的是 Anthropic 原生协议，请求路径 `/v1/messages` 是它自己拼的。`ANTHROPIC_BASE_URL` 只负责"域名 + 可选前缀"，所以：

| 填写                                  | 实际请求                                            | 结果  |
| ----------------------------------- | ----------------------------------------------- | --- |
| `https://api.zaimod.com`             | `https://api.zaimod.com/v1/messages`             | 正确  |
| `https://api.zaimod.com/v1`          | `https://api.zaimod.com/v1/v1/messages`          | 404 |
| `https://api.zaimod.com/v1/messages` | `https://api.zaimod.com/v1/messages/v1/messages` | 404 |

---

## 七、第五步：启动与验证

保存后**完全关掉终端再重开**（环境变量只在启动时读一次），然后：

```console
claude
```

随便发一句：

```console
你好
```

![](/uploads/editor/20261101/img_6ae62d9d74eea4.44891885.png)

### 7.1 三处判据，比"能回话"更硬

| 位置        | 正常表现                    | 说明                                                 |
| --------- | ----------------------- | -------------------------------------------------- |
| 启动屏左下角    | `API Usage Billing`     | 说明在走 API 计费（中转站生效）。显示 `Claude Pro / Max` = 还在官方订阅里 |
| `/status` | 模型是 GLM，Base URL 是中转站域名 | 最直接的一条，能同时看到地址和模型                                  |
| `/model`  | 列表里出现 `glm-5.2`         | 说明 `_MODEL_NAME` 生效了；不显示就是 JSON 没被读到               |

最硬的还是后台：控制台「使用日志」里出现这次调用，才算真的走了中转。

### 7.2 顺手确认 JSON 是合法的

配置有语法错误时，Claude Code 会**静默忽略整份文件**，然后直接进入官方登录引导 —— 症状是"配了半天，它让我登录 Anthropic 账号"。所以改完先过一遍语法：

```bash
python3 -c "import json;json.load(open('$HOME/.claude/settings.json'));print('JSON OK')"
```

```powershell
python -c "import json,os;json.load(open(os.path.expanduser('~/.claude/settings.json')));print('JSON OK')"
```

没有 Python 就用 VS Code 打开这个文件，右下角会标红；或者粘到任意 JSON 校验网站。

---

## 八、常见问题

**8.1 报 401 / 提示未授权**

先确认三件事：`ANTHROPIC_AUTH_TOKEN` 里是纯 Key（没有 `Bearer ` 前缀、没有引号嵌套）；令牌没被禁用；环境里没有残留的 `ANTHROPIC_API_KEY`。最后这条最容易漏 —— 系统环境变量里的官方 Key 会压过配置文件，把它删掉或改名再重开终端。

**8.2 提示模型不存在 / 404**

`_MODEL` 里的 ID 和模型广场对不上。注意 GLM 分组里不同分组的模型 ID 可能不一样（`智谱-自部署` 与 `智谱-官` 未必同名），换分组时这 8 个值要一起核对。

**8.3 想临时切回 Claude 官方分组怎么办**

同一份 `settings.json`，把 `env` 里的四个 `_MODEL` 和四个 `_MODEL_NAME` 删掉，只留 `ANTHROPIC_AUTH_TOKEN` + `ANTHROPIC_BASE_URL`，再把 token 换成对应分组的 Key 即可。想彻底回官方：把整个 `env` 块删掉，然后 `claude` 里重新登录。

如果想"两套配置并存"，用项目级配置覆盖：在项目根目录放 `.claude/settings.json`，写上另一套 `env`（项目级优先级高于用户级）。但注意 —— 项目级文件会进版本库，**别把 Key 写进去**。

**8.4 VS Code 插件里显示的还是官方模型**

插件和 CLI 共用同一份 `~/.claude/settings.json`，改完要**重启 VS Code**（不是重开面板）。如果插件设置里手动填过 API 地址，先清掉 —— 插件里的显式设置会盖过文件。

**8.5 主对话正常，但一让它改代码就卡住或报错**

后台的 Haiku 档（摘要、标题、文件索引）没有正确映射。补上 `ANTHROPIC_DEFAULT_HAIKU_MODEL` 再重启；这一档如果指向了一个不存在的模型，表现往往不是报错，而是"它一直在想但不动"。

**8.6 中文路径 / 空格路径**

`claude` 以当前目录为工作区。先在项目目录里 `cd` 进去再启动；路径带空格时用引号包住。在主目录下启动会收到 "You have launched claude in your home directory" 的提示，那是提醒你别把整个用户目录当仓库。

上一篇：Grok Build 配置{else}上一篇：没有了下一篇：Kimi Code CLI 配置{else}下一篇：没有了