Claude Code 配置 GLM 智谱 AI 教程

你要填的其实只有三项

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

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

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

注册与实名

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

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

建一枚密钥

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

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

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

三项配置怎么填

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

填的时候注意三件事：

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

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

密钥怎么管得更细，见API Key 是什么；如果你用的是兼容接口那一套思路，见OpenAI 兼容接口。

发一句话验证

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

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

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

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

报错对照与额度

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

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

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

如果你更在意用量和长文档，可以对照另一家的做法：配置通义千问。