先说明一下这套玩法的核心逻辑:Claude Code 不一定要配 Claude 官方模型,接智谱 GLM 完全可行,而且对想低成本入门的开发者来说,这可能是当前最舒服的组合。这篇文章就是一份从零到一的实操记录,包含怎么注册智谱开放平台、怎么安装 Claude Code、怎么把两者接起来、怎么用 cc-switch 一键切换模型,以及我在真实项目踩过的各种坑。适合没用过命令行 AI 编程工具的小白,也适合已经被模型成本或者账号折腾过、想换一种更省心姿势的人。
1. 先把思路理顺:Claude Code 和智谱 GLM 为什么能组在一起
1.1 Claude Code 到底是什么
Claude Code 是 Anthropic 推出的官方命令行 AI 编程代理。你可以把它理解成一个"长在终端里的结对编程搭档":给它一个任务,它能自己读项目代码、跨文件修改代码、执行终端命令、跑测试,然后反复迭代直到任务完成。比起在网页对话框里来回粘贴代码,Claude Code 最大的不同是它拥有你的项目上下文——它知道你项目里有哪些文件、哪里报错了、测试挂了什么,所以它能真正"干活",而不是停留在"聊天"。
使用方式就是命令行交互。你 cd 到项目目录,敲 claude,进入一个既能对话又能动手改文件的界面;也可以直接 claude "帮我把这个页面改成响应式布局",它会自动开工。对不熟命令行的人,这个思路需要先接受一下:它不是图形界面软件,是一个终端工具,但它的能力边界比普通聊天机器人高一大截。你给它的上下文越完整,它干得越靠谱,这也决定了后面配置文件的价值。
1.2 为什么要把智谱 GLM 接进去
官方 Claude Code 使用的是 Anthropic 自家模型,付费需要绑海外支付方式开通 API,而且重度使用价格不便宜。对很多人来说,这是一个实打实的门槛。智谱 GLM 是国内头部大模型之一,在智谱开放平台(bigmodel.cn)提供 API,最关键的在于:智谱提供了 Anthropic 兼容接口。换句话说,智谱把服务端协议做成了 Anthropic Messages API 格式,而 Claude Code 只认这个协议。于是你把请求地址指向智谱、把密钥换成智谱的 Key,Claude Code 就会用 GLM 模型来干活。
这个背后的原理就是"协议兼容"。Claude Code 本身并不绑定某一家模型,它按照 Anthropic 的 API 协议发出请求,服务端返回什么模型的结果,它就接收什么。谁家的服务端实现了这套协议,谁就能被 Claude Code 调用。智谱做了这个兼容层,等于给开发者开了一条低门槛的路:不用改 Claude Code 的代码,不用搭中间服务,改几个变量就完事。这也是"Claude Code + 智谱 GLM"这个组合能在社区火起来的根本原因。
1.3 这套方案适合谁
说实话,不是所有人都需要这个组合。如果你只是偶尔问几个编程问题、平时不怎么碰终端,那网页版对话完全够用。但如果你是这几类人,可以继续往下看:第一类是学生党和个人开发者,预算有限,想体验 Agent 级别的编程工具,智谱有免费模型和体验卡,几乎零成本起步;第二类是不想折腾海外账号支付、希望直接注册直接调用的开发者,智谱国内注册、国内调用,链路短,出问题也容易排查;第三类是需要在多款模型之间对比的中高级开发者,用 cc-switch 在智谱、DeepSeek 等供应商之间来回切换,同样的操作界面,换模型跟换主题一样轻松。
也有一个反向提醒:GLM 模型和 Claude 官方模型能力并不完全等价,在特别复杂的重构任务、超大上下文场景下,体验还有差异。但对日常编码、脚本编写、代码解释、中小型项目开发来说,GLM 的表现相当能打,尤其是中文理解和中文注释生成,反而更贴合国内项目的习惯。我自己的使用感受是,不要神化任何模型,按任务选择合适的才是正道。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 前置准备:注册智谱、实名认证、拿到 API Key 和体验卡
2.1 注册与实名认证
打开智谱开放平台官网 bigmodel.cn,用手机号注册账号。注册完成后进控制台做实名认证,个人开发者身份即可。这里需要直说:不完成实名认证,API 是没办法正常调用的。整个流程和国内绝大多数云平台一样,提交身份信息加人脸识别,几分钟就能搞定。别嫌麻烦,这一步不做,后面所有配置都是白搭。
2.2 创建 API Key
登录控制台后,找到"API 密钥"菜单,点新建,系统会生成一串形如 id.secret 的 Key。注意,这个 Key 的完整内容只在创建时显示一次,务必立刻复制保存到密码管理器里。丢失了也不用慌,可以在控制台注销旧 Key、重新生成新的,不影响使用。另外要留意的是,智谱的 Key 格式和 OpenAI 的 sk- 开头的格式不一样,是一段 ID 加一段密钥用点号连接,配置的时候整串复制,不要截断。
2.3 免费模型与 7 天体验卡
智谱平台长期开放免费的 Flash 系列模型,比如 glm-4-flash,一直可以用,速率和并发有限制,但日常编码够用。除此之外,智谱会不定期提供"GLM Coding Plan 7 天体验卡"活动,在控制台或活动页可以领取。这张体验卡的作用,是让你在 7 天里使用更高规格的模型,编码场景的体验明显更顺滑。我的建议是:真正准备开始用 Claude Code 之前再激活体验卡,不要提前激活白白浪费 7 天窗口。
提示:体验卡一般需要先在控制台绑定到你的账号,调用时会计入体验卡额度而不是账单。用之前去控制台确认一下体验卡状态是"有效",免得配置半天发现请求被拒。
2.4 确认模型名,这一步千万别偷懒
模型名是后面所有配置的命根子。进控制台的模型列表,找到你想用的模型对应的"模型编码 / Model ID"。不同时期模型编码不一样,比如 glm-4-flash、glm-4.7-flash、glm-5.3-flash 等等。一定要复制控制台里真实存在的 Model ID,不要凭印象手打。那些 "is not a model this version of claude code recognizes" 的报错,八成就是模型名填得不对或者已经过期。
3. 安装 Claude Code:先把环境备齐
3.1 检查 Node.js
Claude Code 是一个 npm 包,先得有 Node.js,要求版本在 18 以上,推荐用 20 LTS。打开终端输入 node -v,能输出版本号就行;提示找不到命令,就去 Node.js 官网下载 LTS 版本,一路下一步安装,装完重启终端再验证一次。这一步是纯环境准备,没啥技术含量,但很多小白卡在这里,往往是安装完 Node 忘了重开终端。
3.2 npm 全局安装
确认 Node 之后,安装就是一条命令:
bash复制npm install -g @anthropic-ai/claude-code
国内网络环境下如果安装速度很慢或者卡住,可以先把 npm 源切到国内镜像:
bash复制npm config set registry https://registry.npmmirror.com
然后再执行安装。装完验证:
bash复制claude --version
能输出版本号就说明安装成功。这里分享一个实操经验:macOS 用户如果碰到 EACCES 权限报错,是因为全局安装目录没有写权限。解决办法不是无脑加 sudo,而是用 nvm 管理 Node 版本,通过 nvm 装的 Node 没有全局权限问题的麻烦。Windows 用户如果提示"claude 不是内部或外部命令",检查 npm 全局 bin 目录有没有加到 PATH,重开终端一般能解决。
3.3 保持更新
Claude Code 迭代非常快,社区里很多人踩的坑其实在新版本已经修了。养成习惯,隔一两周跑一次:
bash复制npm update -g @anthropic-ai/claude-code
升级之后如果发现行为有变化,去官方 changelog 翻一眼就能知道改了啥。这个习惯能省掉很多莫名其妙的排障时间。
4. 核心配置:把 Claude Code 接到智谱 GLM
4.1 方式一:环境变量,最快见效
环境变量是最直接的接入方式,适合先验证整体思路通不通。在终端执行:
bash复制export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的智谱API_KEY"
export ANTHROPIC_MODEL="glm-4.7-flash"
export ANTHROPIC_SMALL_FAST_MODEL="glm-4.7-flash"
然后在这个终端窗口里启动 claude。这里逐个变量解释一下:ANTHROPIC_BASE_URL 是请求地址,填智谱的 Anthropic 兼容端点;ANTHROPIC_AUTH_TOKEN 是你的智谱 Key,Claude Code 会把它作为 Bearer Token 传给服务端;ANTHROPIC_MODEL 是主模型,干重活的那个;ANTHROPIC_SMALL_FAST_MODEL 是后台小模型,Claude Code 用它做低成本任务,比如给会话起标题、简单分类。如果只设主模型不设小模型,某些版本会报错或行为异常,所以两个一起设置最稳。
终端里的环境变量是临时的,关掉就没了。想永久生效,把 export 那几行追加到 ~/.zshrc(macOS 默认 shell)或者 ~/.bashrc(多数 Linux)末尾,然后 source 一下或者重开终端。Windows 用户在 PowerShell 里写法如下:
powershell复制$env:ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="你的智谱API_KEY"
$env:ANTHROPIC_MODEL="glm-4.7-flash"
$env:ANTHROPIC_SMALL_FAST_MODEL="glm-4.7-flash"
环境变量适合临时验证,如果你确定以后主力就是智谱,可以继续用;但我更推荐下面这第二种方式,正式使用更稳。
4.2 方式二:settings.json,推荐正式使用
Claude Code 启动时会读取用户目录下的配置文件,路径如下:
- macOS / Linux:~/.claude/settings.json
- Windows:%USERPROFILE%.claude\settings.json
如果目录或文件不存在,手动创建即可。写入这样的 JSON:
json复制{
"env": {
"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的智谱API_KEY",
"ANTHROPIC_MODEL": "glm-4.7-flash",
"ANTHROPIC_SMALL_FAST_MODEL": "glm-4.7-flash"
}
}
保存后重新启动 claude,配置就生效了。这里有一个优先级问题必须提醒:环境变量会覆盖 settings.json 里同名的配置。如果你之前为了测试手动 export 过,现在又写了 settings.json,那残留的环境变量会继续生效,导致你以为改了配置却没任何变化。排查时第一件事就是把终端里所有 export 过的 ANTHROPIC_* 变量清掉,或者直接开一个全新终端。
4.3 模型名到底填什么
"模型名填什么"是问得最多的问题。记住一句话:以智谱控制台里显示的 Model ID 为准。免费场景用 Flash 系列;体验卡或付费场景用更强的大杯模型。原则是主模型和后台小模型填同一个值最省心,因为部分兼容网关并不支持把"小模型"单独路由到别的模型,填一样是最稳的。
配置完别急着开干,先做验证。启动 claude,直接问一句"你当前使用的模型是什么",或者让它写一段简单代码;同时打开智谱控制台的用量页面,能看到一条调用记录,就说明链路完全通了。第一次启动时如果没有配置任何环境和文件,Claude Code 会让你选择登录方式;配置好之后它会跳过登录步骤,直接进入工作状态。
4.4 为什么这样配:把原理说透
很多人配完就跑,但我建议你理解一下里面发生了什么。Claude Code 本质是一个客户端,发出的请求格式是 Anthropic Messages API。智谱的兼容端点收到请求后,在服务端翻译成 GLM 模型的调用格式,再按照 Anthropic 的格式返回。对 Claude Code 来说,它"以为"自己在跟官方服务对话,实际上后面是 GLM 在回答问题。这就是"兼容接口"的本质——它不改变客户端行为,只换服务提供方。
理解这个,你就能解释很多表面看起来很奇怪的问题:比如为什么请求头里的 Token 是你的智谱 id.secret 而不是 sk- 开头;为什么某些官方模型独有的参数,在兼容接口下会报参数错误;为什么模型名必须以智谱侧为准。一旦请求链路断了,顺着客户端到服务端的方向排查,问题定位会快得多。
5. 进阶管理:用 cc-switch 实现多模型一键切换
5.1 cc-switch 解决什么问题
如果只用智谱一家,前面那半段配置就够了。但实际使用中,很多人会同时用智谱 GLM、DeepSeek 甚至其他供应商,因为不同模型在不同任务上的表现和价格差异很大。手动改环境变量、改 settings.json 实在太低效,还容易改错。cc-switch 就是为这个场景而生的开源桌面工具:它把 Claude Code(以及 Codex 等)的多套供应商配置统一管理起来,界面点一下,就把对应配置写进 Claude Code 的配置文件,重启即生效。
注意,这跟在某个工具的设置界面里"选择模型"是两码事。cc-switch 改的是 Claude Code 的配置文件,相当于一键替代了第四节的全部手工操作。社区里"cc-switch 智谱怎么配"这个话题热度很高,正说明这是很多人的真实痛点。
5.2 安装与首次使用
去 cc-switch 的 GitHub Releases 页面下载对应系统的安装包,macOS 装 dmg,Windows 装 exe,双击安装即可。首次打开会让你选择管的是 Claude Code 还是 Codex,选 Claude Code。主界面是"供应商"列表,点"新增供应商"开始配置。
5.3 添加智谱与 DeepSeek 供应商
字段不多,填起来很快。先添加智谱:
- 名称:智谱 GLM(自己起名,能认出来就行)
- 接口地址:https://open.bigmodel.cn/api/anthropic
- API Key:你的智谱 Key
- 模型:glm-4.7-flash(或者你实际使用的 Model ID)
填完保存,列表里出现"智谱 GLM"这个卡片。再用同样方式添加 DeepSeek:
- 名称:DeepSeek
- 接口地址:https://api.deepseek.com/anthropic(以官方最新文档为准)
- API Key:你的 DeepSeek Key
- 模型:deepseek-chat
配置完成后,点击想用的供应商卡片,cc-switch 会提示已切换,同时帮你把 ~/.claude/settings.json 更新为对应内容。重启 claude 就生效了。这里有一个我踩过的坑:如果之前手动设置过环境变量,cc-switch 写入的 settings.json 可能不生效,因为环境变量优先级高于配置文件。所以用 cc-switch 管理时,要把手动 export 的内容清干净,让 cc-switch 成为唯一配置入口,才能真正实现一点切换。
5.4 配合 7 天体验卡的有效用法
体验卡只有 7 天有效期,怎么把价值榨干?我的建议是:激活前先用免费 Flash 模型做基础工作,比如搭项目脚手架、写常规代码、日常小改动;激活体验卡之后,把高强度任务集中在这 7 天,比如一次大规模重构、把老项目迁移整理成新结构、集中学习某个技术栈的实战。这类任务对模型推理能力要求高,体验卡的价值最能体现。7 天用完后切回免费模型继续日常维护。整个过程在 cc-switch 里就是点两下的事,不用反复改配置,这也是我推荐这个工具的直接原因。
6. 上手实操:第一次用 Claude Code 干活
6.1 常用命令速览
配置好之后,一切从终端开始。先 cd 到项目根目录,然后:
bash复制claude
进入交互
