Claude Code接入GLM完整教程：从环境配置到模型切换实战指南

一直想用Claude Code写点东西，结果卡在账号和API这一步，折腾半天连命令行都没进去——这是我最近在几个技术群里看到最多的吐槽。其实答案早就有了：智谱GLM很早就开放了Anthropic API兼容接口，也就是说，你可以用GLM的API Key直接驱动Claude Code这个壳子，命令行、编辑器插件、项目记忆、权限管理这些功能全都正常用，模型底层则是GLM在跑。

这篇文章就是干这个事的：从零开始，把Claude Code装好，接入最新GLM模型，并且把我在实际配置中踩过的坑、绕过的弯都写出来。全文不需要你会Linux命令行，也不要求你懂Node.js，只要会复制粘贴命令、会打开记事本，就能跟着走完。无论你用的是macOS、Windows还是VS Code，后面都有对应的操作路径。

1. 先说清楚：Claude Code和GLM到底是怎么接上的

1.1 Claude Code是干什么的（我实际用它做什么）

Claude Code是Anthropic出的一个命令行编程助手。它不是一个聊天窗口，而是直接长在终端里面，你可以让它在项目目录下读代码、改文件、跑命令、写测试、提PR，整个流程都不用离开终端。我第一次用的时候最大的感受是：它不是一个“问答机器人”，更像是一个坐在你旁边、能直接动手改代码的实习生。

举几个我常用的场景：

• 进入一个老项目，先让它读一遍目录结构和核心模块，然后总结这个项目是干什么的、代码规范大概什么样。
• 让它修一个具体的bug，它会自己定位文件、修改代码，然后跑测试给我看结果。
• 批量重构，比如把一整套接口调用从fetch换成axios，它一条条改完再检查是否遗漏。

这里面的关键是Claude Code本身的交互能力和工具调用框架。它负责帮你读文件、执行命令、管理上下文，而“真正理解代码并生成修改”这件事，是交给底层模型的。所以把底层模型换成GLM，只是换掉了思考的大脑，Claude Code这一整个工具链依然照常运转。

1.2 GLM兼容接口的原理：为什么一条环境变量就能换模型

到目前为止，很多人对“接入GLM”有误解，以为要改Claude Code的源码或者装破解插件。实际上原理非常简单：Claude Code在启动时会读取一组环境变量，其中一个变量叫ANTHROPIC_BASE_URL，它默认指向Anthropic官方API的地址。你把这个地址改成GLM提供的兼容接口地址，Claude Code发出的所有请求就到GLM那边了。

打个比方你就懂了：Claude Code像一个点菜系统，它只认“菜单格式”，不管后厨是哪家。只要后厨（GLM）能按照同样的格式出菜，点菜系统根本不知道后厨换了人。GLM这边推出的Anthropic兼容端点，就是把你的每次请求翻译成它自己的模型调用，然后把结果格式再翻译回来。所以最终你看到的是一个完整可用的Claude Code，只是背后思考的模型换成了GLM。

这个思路也被很多其他模型采用，DeepSeek、通义、Kimi都有类似的兼容方案，所以掌握这一套配置方式之后，以后接任何兼容Anthropic协议的模型都是同一套逻辑，真的是一通百通。

1.3 这套方案的真实定位：适合谁、不适合谁

如果你已经有一个Claude Code能正常跑通的环境，并且用的是Claude官方模型，那这篇文章对你最大的价值大概是了解另一条路。但如果你属于下面这几种情况，这套方案就是为你准备的：

• 想用Claude Code的命令行交互和工具能力，但没有可以正常使用的Claude官方账号或API Key。
• 已经在用GLM或者DeepSeek的API，不想额外注册一套海外服务，希望一个Key走天下。
• 想对比不同大模型在代码任务上的表现，需要一个完全可控的切换方案。
• 零基础，第一次接触命令行AI工具，需要一篇不用查补充资料的完整教程。

不适合的情况也有。比如你极度依赖Claude官方独有的一些性能或生态功能，那换模型确实会有差异。也别指望GLM和Claude的所有行为完全一致，毕竟模型训练不同、风格不同、上下文处理不同，关键是“能用、好用、够用”。

2. 安装前先把「环境检查」做扎实

很多人装不上Claude Code，不是步骤不对，而是环境有问题。比如Node版本太老、npm权限不够、终端没重启。所以我单独用一章把安装前的检查工作写清楚，免得后面出了错不知道从哪排查。

2.1 Node.js版本检查：一条命令确认

Claude Code是基于Node.js开发的npm包，Node版本不够就直接装不上。你不需要懂Node.js是什么，只需要知道它是运行Claude Code的底座就行。

打开你的终端：

• macOS：打开“终端”（Terminal）
• Windows：按Win键，输入“cmd”，回车打开命令提示符

然后输入：

node -v

如果能看到类似v18.0.0、v20.x.x这样的版本号，说明Node已经装好了。建议版本在18以上，版本太低会出现各种莫名其妙的问题。如果提示找不到node或者版本太低，去 Node.js 官网下载LTS版本，一路下一步安装就行。装完之后把终端完全关掉重开，否则新装的Node不会生效。

然后检查npm：

npm -v

能出来版本号就说明npm可用。npm是Node配套的包管理工具，装Claude Code就靠它。

2.2 准备GLM API Key：注册到拿Key的全过程

GLM是智谱AI旗下的大模型系列，API在国内就能直接访问，这也是我选择它的一个重要原因，不存在网络可达性方面的额外折腾。

步骤很直接：

1. 打开智谱开放平台（bigmodel.cn），用手机号注册登录。
2. 登录后进入控制台，找到“API Keys”或“密钥管理”页面。
3. 点击创建新的API Key，把生成的那一串key复制保存好。

这里有一个特别容易忽略的点：API Key只在创建时完整显示一次，关掉页面就看不到了。我身边已经有好几个人创建之后没保存，回头找来找去只能重新生成一个。你拿到key之后立刻粘贴到一个记事本文件里，备注清楚，后面用得到。

另外，GLM的API是付费的，但新用户通常会有一定额度的赠送，而且它的计费相比海外模型要实在很多。你可以在账户后台看到余额，没有余额的话按平台指引充值一点够测试用就行，成本很低。

2.3 需要理解的三个环境变量

接入GLM只需要设置三个环境变量，先把它们的含义搞清楚，后面配置就不会懵。

第一个是ANTHROPIC_BASE_URL，接口地址。它决定Claude Code往哪个服务器发请求。默认是Anthropic官方地址，我们要改成GLM的兼容接口地址：

https://open.bigmodel.cn/api/anthropic

第二个是ANTHROPIC_AUTH_TOKEN，身份凭证。值就是你刚才复制下来的GLM API Key。Claude Code拿着这个key去请求GLM接口，相当于进门刷的门禁卡。

第三个是ANTHROPIC_MODEL，模型名。告诉Claude Code默认使用哪个模型。以目前GLM开放的最新系列为例，模型名通常写作glm-4.6、glm-4.5这类格式，具体以你在模型列表里看到的最新名称为准。如果你不设这个变量，Claude Code发起请求时用的可能是默认的Claude模型名，GLM这边不识别就直接报错。所以这个变量在接入时非常关键，很多人漏了它才导致半天跑不通。

把这三个变量的关系理解成一个快递单：接口地址是收货点，API Key是取件码，模型名是你要的商品。三个填对，包裹必达。

3. 手把手：从零安装Claude Code并接入GLM

3.1 安装Claude Code本体

环境确认无误之后，在终端里执行这一条命令，全局安装Claude Code：

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

安装过程可能需要十几秒到几分钟，取决于网络状况。看到类似下面的输出说明装好了：

added 123 packages in 15s

macOS用户如果遇到权限报错，比如提示EACCES，说明npm把包装到系统目录时没有写入权限。最简单的解决办法是加上sudo重新执行：

sudo npm install -g @anthropic-ai/claude-code

输入你的电脑开机密码（输入时不显示字符，正常输完回车就行）即可。Windows端一般不会有这个权限问题，但如果你用的是PowerShell，遇到“禁止运行脚本”之类的报错，是因为系统默认的脚本执行策略太严，可以换用系统自带的cmd来操作，最省事。

3.2 写入环境变量（macOS和Windows分别怎么搞）

这一步是核心。安装好Claude Code之后，要让它在启动时知道：去GLM的地址、用GLM的Key，和GLM的模型。

macOS用户：

打开终端，输入：

nano ~/.zshrc

如果你用的是老版本macOS自带bash，就改成：

nano ~/.bash_profile

在文件末尾粘贴下面这几行（把你的GLM_API_KEY替换成真实key）：

export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic" export ANTHROPIC_AUTH_TOKEN="你的GLM_API_KEY" export ANTHROPIC_MODEL="glm-4.6"

按Ctrl + O保存，再按Ctrl + X退出。最后让配置生效：

source ~/.zshrc

Windows用户：

如果你用的是cmd，逐条输入：

setx ANTHROPIC_BASE_URL "https://open.bigmodel.cn/api/anthropic" setx ANTHROPIC_AUTH_TOKEN "你的GLM_API_KEY" setx ANTHROPIC_MODEL "glm-4.6"

setx是永久写入，设置完会提示“成功”，然后关掉cmd重新打开，让变量生效。这里必须注意：很多人设置完不重开终端，直接继续测试，结果环境变量还是旧的，白折腾半天。Windows还有一个坑，就是setx输出的值如果太长或者含特殊字符可能截断，API Key一般不会，但查看变量用的命令你要会：

echo %ANTHROPIC_BASE_URL%

3.3 首次启动：如何确认模型真的切到GLM了

配置完成，终端输入：

claude

第一次启动会出现一个使用协议之类的提示，按说明书确认即可。之后你会进入一个交互式命令行界面，前面有>这样的提示符。到这里，Claude Code已经跑起来了。

现在做一次确认，这是最直接也最重要的验证，直接问它：

你现在使用的是哪个模型？你的API接口地址是什么？

如果配置成功，它会明确回答自己来自智谱GLM系列，甚至直接告诉你模型名。如果它回答的是“我是Claude”，那说明Claude Code还在用默认配置，大概率是三个环境变量没生效，回头重新检查一遍。

确认模型正确之后，随便让它做一个能真正“动手”的任务测试一下，比如：

帮我看看当前目录下有哪些文件，并且说明每个文件大概是做什么的

如果它能正常列目录、读文件、做出分析，说明整个链路完全通了。

3.4 在VS Code里用同一套配置

命令行跑通之后，你可以顺理成章地装一个VS Code插件，直接在一个醒目的侧边栏窗口里和它对话。

打开VS Code，进入扩展商店，搜索“Claude Code”，安装Anthropic官方出的那个插件。安装完成后左侧会出现对应的图标。这里的关键是：VS Code插件读的仍然是系统环境变量，所以只要你在前面已经把环境变量写进了系统配置，插件这边不需要重复设置，打开就是同一个GLM。

如果你在VS Code里连接的是远程服务器，或者发现插件里仍然提示未登录，可以用一个通用解法。在VS Code的终端里先手动导出环境变量，再从这个终端启动VS Code，这样插件就能继承这些变量：

export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic" export ANTHROPIC_AUTH_TOKEN="你的GLM_API_KEY" export ANTHROPIC_MODEL="glm-4.6" code .

先在终端里跑环境变量，再通过code .启动当前项目，VS Code的插件就能读到这一组配置。

4. 实操中最容易踩的坑：我替你们先踩了一遍

配置本身不复杂，但如果你照着我前面的步骤还是出了状况，别急着放弃，八成就在下面这几个坑里。我把它们的报错样子、原因和解决办法一次性列出来，你对着排查就行。

4.1 “无法连接到Anthropic服务”不是网络问题，是端点写错了

这是接入时出现频率最高的一条报错。很多人一看“connect to Anthropic”就以为是自己网络的问题，其实大部分情况根本不是。

错误原因几乎只有一个：ANTHROPIC_BASE_URL没有生效，Claude Code还在往Anthropic官方地址发请求。验证方法很简单，在系统里查看一下这个变量的实际值：

macOS：

echo $ANTHROPIC_BASE_URL

Windows：

echo %ANTHROPIC_BASE_URL%

如果输出的是默认的Anthropic地址，而不是open.bigmodel.cn，说明你的环境变量没写进去或者没生效。按下面几个顺序排查：

• 终端是否重开过？没有的话先重开。
• 写入的配置文件对不对？macOS上zsh用户写.zshrc，bash用户写.bash_profile，写错文件等于没写。
• 保存后是否执行了source？没执行就重启终端一次。

有个更省心的做法：不依赖全局变量，启动Claude Code时临时指定，测试很方便：

export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic" export ANTHROPIC_AUTH_TOKEN="你的GLM_API_KEY" export ANTHROPIC_MODEL="glm-4.6" claude

三条export加一条claude，每次粘贴回车就搞定，很适合先验证方案通不通，确认没问题再写进配置文件。

4.2 模型名到底填什么：404和NoSuchModel的排查

另一个高频问题出现在模型名上。如果你启动Claude Code之后，对话能连上服务，但每次提问都返回类似model not found或NoSuchModel的错误，那问题就出在ANTHROPIC_MODEL这个变量上。

GLM开放平台上的模型型号一直在迭代，同一个系列可能同时存在不同版本，比如4.5系列和包含推理增强的4.6系列，名称写法不完全一样。你要做的就一件事：登录开放平台，进模型列表页面，找到“最新模型”的名称，原样复制粘贴到环境变量里，不要把空格、序号或者中文备注一起带上。模型名写错一个字符，哪怕大小写不对，都会直接拒绝服务。

另外注意，Claude Code在发请求时有时会带上模型名后缀，如果某些版本要区分具体规格，也会出现模型找不到的情况。如果你在模型列表里看到好几个类似名称不知道怎么选，优先选标注“最新”或者“稳定”的主版本，这种接口兼容性最好。

4.3 不想每次都点“允许”：权限确认的三种解法

Claude Code在一些操作上需要你确认权限。比如运行命令、写文件、执行shell命令，它会弹出一个“是否允许”提示。命令少的时候还好，需求量一多，每次回车确认也会把人点到烦。这里有几个办法能让你少点几下。

第一种，在会话中按Shift + Tab切换“自动接受”模式。这个键会在“需要确认”和“允许所有操作”之间循环切换，你切到自动接受模式后，一段会话内它都会直接执行命令不再询问。适合你看着它干活的时候用。

第二种，用配置命令把常用操作加入白名单。比如你想让它执行npm命令前不用每次都问，可以这样设置：

claude config set --global allowedTools "Bash(npm:*)"

以后它执行npm开头的命令就不会再弹确认框了。这个是灵活且值得研究的方案，把高频操作加白，把有风险的操作保留确认，安全性仍然可控。

第三种，针对一次会话临时放行所有Tolked工具，在启动命令后面直接加--dangerously-skip-permissions，配合自动接受使用，几乎可以做到全程无打扰。但这等于把所有确认都跳过了，只建议在你自己机器的个人项目里用，别在公司正式环境随意开启。

4.4 同时接GLM和DeepSeek：多模型切换的配置方法

很多朋友问“我现在接GLM，之后想切DeepSeek怎么办”。方法很简单，你已经理解了环境变量的机制，多模型切换就是换一个接口地址和Key的事。

我推荐用别名或者脚本管理，这样随时能切换，不用反复改全局变量。macOS在.zshrc末尾加一行：

alias claude-glm="ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic ANTHROPIC_AUTH_TOKEN=你的GLM_KEY ANTHROPIC_MODEL=glm-4.6 claude" alias claude-ds="ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic ANTHROPIC_AUTH_TOKEN=你的DS_KEY ANTHROPIC_MODEL=deepseek-chat claude"

设置完执行source ~/.zshrc，接着你想用哪个模型就在终端敲对应的命令。Windows用户可以写一个简单的bat脚本，放在桌面，双击就是指定模型的Claude Code：

@echo off set ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic set ANTHROPIC_AUTH_TOKEN=你的GLM_KEY set ANTHROPIC_MODEL=glm-4.6 claude

这样一个模型一套脚本，互不干扰。需要对比不同模型写代码能力的时候，开两个终端各跑各的，马上就能看出差别。

5. 接入之后真正提升效率的几个习惯

跑通只是开始，让Claude Code在你的日常开发里真正发挥作用，还需要几个使用习惯。这些技巧跟用什么模型无关，纯粹是Claude Code这个工具本身的价值洼地，很多人装了半年都还没用上，我一起写在下面。

5.1 用CLAUDE.md让Claude记住项目约定

Claude Code有个项目记忆文件叫CLAUDE.md，放在项目根目录。你在里面写的内容，会在每次对话时被自动读取，相当于给它一份“入职手册”。

这能带来什么效果？举例：

• 你的项目要求所有接口返回格式统一为{ code, data, message }，写进CLAUDE.md之后，它写的所有新接口都会自动遵守。
• 你的项目不用TypeScript，用了它也不会擅自给你生成.ts文件。
• 测试命令、启动命令、打包命令，写进去之后它执行命令时就会用你的规范，而不是猜。

我的做法是新建项目第一件事就写一个CLAUDE.md，内容包括项目简介、技术栈、目录结构、常用命令、编码规范，也就几行，但后面每次使用它都像换了一个“熟悉该项目的同事”，省太多了。

5.2 skills扩展和常用命令速查

Claude Code支持通过skills给它的能力扩容。一个skill本质上是一组带说明的指令包，你可以告诉它“以后做代码审查时按这个标准流程走”，或者“看到代码里有某个模式，就按这个规则自动修复”。如果你不想自己动手写，网上已经有很多现成的技能包可以直接放进去，安装路径一般在~/.claude/skills下，丢进去重启就能识别。

常用操作命令我再整理一下：

• 退出当前会话：/exit
• 清理当前会话上下文，重新开始：/clear
• 查看所有可用命令：/help
• 设置权限白名单：claude config set --global allowedTools "Bash(...)"
• 查看当前配置：claude config list

5.3 卸载与重装的注意事项

如果你跟我一样，配置调试反复怀疑人生，想过卸载重装，那就把下面的命令记住。彻底卸载Claude Code：

npm uninstall -g @anthropic-ai/claude-code

想重装，先确认全局环境变量已经指向GLM，再执行安装命令，装完启动即是GLM。如果你只想换模型名称，不需要卸载，直接改ANTHROPIC_MODEL这一个变量就行。

另外提醒一句：重装不会清空你的配置文件和对话历史，真正想要“完全干净”的话，手动删除用户目录下的.claude文件夹再重装。不过一般情况下用不到，改环境变量就够了。

最后分享一个我个人的使用小习惯。跑通接入之后，我会先不做复杂任务，而是用一个自己很熟的小项目，让它从头到尾完成“读代码 -> 总结逻辑 -> 改一个功能 -> 写测试”的完整流程。这一步能让你快速摸清GLM模型在Claude Code里的性格和边界，比如它在什么时候会多话、什么时候理解偏差比较大、什么样的指令表述最省力。每个人用AI编程工具的上手路径不一样，但方向都是一样的：让它真正开始干活，而不是停在“你好，你会什么”这一步。