---
title: "Claude Code 配置 GLM 智谱 AI 教程"
description: "注册、建密钥、填三项配置、发一句测试话：把 GLM 接进 Claude Code 的完整路径，外加一张报错对照表和密钥保管规矩。"
updated: 2026-11-13
canonical: https://docai.cc/learn/connect-glm-to-claude-code/
markdown_mirror: https://docai.cc/learn/connect-glm-to-claude-code.md
---
## 你要填的其实只有三项

不管界面长什么样，接第三方模型都绕不开三个值：接口地址、密钥、模型标识。界面上的叫法可能不同，本质就是这三样。

| 项 | 从哪来 | 常见错误 |
|---|---|---|
| 接口地址 | 平台文档或控制台示例 | 少了版本段，或多写了具体路径 |
| 密钥 | 控制台创建 | 复制时带了空格，或把密钥贴到了别的位置 |
| 模型标识 | 平台模型列表 | 记成宣传名，而不是接口里的那个字符串 |

地址的作用是告诉客户端往哪发请求，拼错的典型表现是 404。密钥决定服务端认不认你，错了通常是 401 或 403。模型标识错了，多半提示模型不存在或无权访问。三条错误对应三个字段，这个映射记住了，排查就不用瞎试。

## 注册与实名

打开智谱 AI 的开放平台，用手机号注册，按提示完成验证。用个人身份注册就行，不必准备公司资料；企业场景再走企业认证。

新账号一般会带一点试用额度，额度大小和有效期会调整，以控制台当前显示为准。别把教程里的数字当承诺，注册完自己看一眼「用量」页。

## 建一枚密钥

登录后进控制台，找到 API Keys 一栏，点创建。名字建议写成用途，比如「claude-code-本机」，以后要吊销时一眼能认出是哪一台在用。

密钥通常只完整显示一次。创建弹窗出现时立刻复制，存进密码管理器；不要存进项目文件夹，不要发到聊天窗口，也不要留在浏览器的下载记录里。它等同于你账号的付款凭证。

如果怀疑泄露，处理顺序是：控制台里删掉旧密钥、建新的、更新本机配置、看一眼用量有没有异常。删比改快，也不用担心旧密钥还在别处生效。

## 三项配置怎么填

客户端里通常有两个入口：图形化的设置页，和一份配置文件或环境变量。图形界面适合第一次试，改完能立刻看到效果；环境变量适合长期用，换项目不用重填。

填的时候注意三件事：

- 地址要按平台给的示例原样抄，末尾斜杠和版本段都不要自己加戏；有的客户端要求地址以版本号结尾，有的会自己补，填错就拼出重复路径。地址与端点的区别见[端点是什么](/concepts/endpoint/)。
- 密钥只填字符串本身，不要带引号、不要带「Bearer」前缀，除非文档明确要求。
- 模型标识从平台的模型列表里复制，不要手打。列表里常同时有免费档和付费档，先选免费档试通，再换质量更高的。

平台文档里常见的地址形如 `https://open.bigmodel.cn/api/paas/v4/`，模型侧有 `glm-4-flash` 这类档位。这些值会随平台版本调整，填之前回控制台核对一遍。另外要留意：Claude Code 走的是它自己的协议，平台如果为它单独提供了接入地址，就用那个专用地址，不要拿通用接口地址硬套。两种地址在控制台的接入文档里会分开写。

密钥怎么管得更细，见[API Key 是什么](/concepts/api-key/)；如果你用的是兼容接口那一套思路，见[OpenAI 兼容接口](/concepts/openai-compatible/)。

## 发一句话验证

配置保存后，回到对话面板，发一句最短的测试：

> 你好，用一句话介绍你自己，并说明你是哪个模型。

看两件事：有没有正常回复；回复里报的模型名是不是你选的那个。有些客户端会在状态栏显示当前模型，也可以顺手核对。

正常回复之后，再补一个真实一点的小任务，比如让它读一个文件并概括三行。这一步验证的是「模型接上了」而且「工具还能用」，两件事不是一回事。

## 报错对照与额度

| 提示 | 多半是什么 | 先改哪 |
|---|---|---|
| Invalid API Key / 401 | 密钥错、过期，或粘贴时带了空格 | 重新复制密钥 |
| Connection refused / 404 | 地址写错，路径多了或少了 | 对照文档重填地址 |
| Model not found | 模型标识拼错，或账号没开通 | 从模型列表复制 |
| 429 | 请求太密或额度用尽 | 降速，查用量 |
| 回复一半停住 | 网络不稳或输出上限 | 缩短任务，重试 |

一条通用经验：只改一个字段，再测一次。同时改三样，成功了也不知道是哪一样修好的。

控制台里能看已用 token 和剩余额度。用完后可以充值，也可以先换到另一家继续试用。按 token 计费意味着成本跟输入输出长度直接相关，长文档任务尤其明显。想控制花销，先把任务拆小、把无关内容删掉再发。

如果你更在意用量和长文档，可以对照另一家的做法：[配置通义千问](/learn/connect-qwen-to-claude-code/)。