前天在技术群里看到有人问:VS Code 里能不能用 Claude Code?能不能顺便接智谱的 GLM-4.6V?这问题放在一年前还不算好回答,但到了 2026 年,已经有了一条非常成熟的组合路径。
Claude Code 是 Anthropic 推出的终端编程代理,优势在于能主动读代码、改文件、跑命令,而不是像网页聊天那样问一句答一句。不过直接使用官方服务需要额外申请、付费,流程也比较繁琐。智谱 GLM-4.6V 是国产模型里编码能力很能打的一个,而且智谱开放平台提供了 Anthropic 兼容接口——也就是说,Claude Code 本身不用改任何代码,只要把请求地址和鉴权信息换成智谱的,就能直接用上 GLM-4.6V。
这篇文章写给两类人:一类是想在 VS Code 里用上 Claude Code 的开发者,另一类是想用国产模型替代官方模型、降本增效的团队和个人。下面整个流程我从零开始走一遍:装 VS Code、装 Node.js、装 Claude Code、申请智谱 API Key、配置兼容端点、在 VS Code 侧边栏里跑起来。命令和配置都会贴出来,包括我自己踩过的坑。
1. 这套组合解决什么问题:Claude Code 与 GLM-4.6V 的适配逻辑
1.1 Claude Code 的定位:终端里的编程代理
很多人第一次听说 Claude Code,以为是又一个聊天机器人页面,实际并不是。它是跑在终端里的一个交互式编程代理,进入目录后启动claude,你就可以用自然语言给它派活,比如“看下 README 并总结项目结构”“把 src/utils/format.js 重构成异步写法”“帮我把这个接口加上单元测试并运行”。
真正让它在开发者圈子里火起来的,是它的 Agent 机制:它不只是生成一段代码交给你,而是会自己调用工具去读文件、搜索关键代码、编辑文件、执行测试命令。当测试报错时,它还能读取报错信息,定位到具体代码行,继续修,直到跑通。这种“把任务从描述推进到完成”的体验,和传统问答式 AI 有本质区别。
但这里有个现实问题:Claude Code 原生的后端模型是 Anthropic 自家的 API,官方渠道需要专门的账号、API Key 和付费方案。个人开发者折腾一整套流程,成本不算低。团队要引入,还得考虑模型服务商是否好对接、费用是否可控。所以很多人的诉求就变成了:我要 Claude Code 这种 Agent 形态的工具,但模型最好换成国产的,按国内习惯开通,成本低、接入快。
1.2 智谱 GLM-4.6V 适合做这个“平替”的理由
在可选的国产模型里,智谱 GLM 系列一直是“闭源模型里最舍得开放兼容接口”的一家。GLM-4.6V 是这一代的最新版本,我在编码场景里实测下来的体感是:多轮工具调用的连贯性不错,长上下文下前面交代的约束不容易丢,生成代码的完成度能顶到第一梯队。
更关键的是,智谱开放平台提供了 Anthropic 协议兼容的接口。Claude Code 向后端发请求时用的是 Anthropic Messages API 那一套格式,智谱直接把这个协议接住了。也就是说,Claude Code 不需要改源码、不需要装插件或中间层,只靠环境变量把“请求地址”和“密钥”指过去,就能跑通。
我整理了一张简单的对比表,方便理解为什么用这套组合:
| 对比维度 | Claude Code + 官方模型 | Claude Code + 智谱 GLM-4.6V |
|---|---|---|
| 接入方式 | 官方账号 + 官方 API | 智谱开放平台 + Anthropic 兼容接口 |
| 开通流程 | 注册海外服务、绑定支付 | 手机号注册,按国内流程开通 |
| 成本控制 | 按官方定价计费 | 有免费资源包,按量计费,成本通常更低 |
| 模型切换 | 固定官方模型 | 在 Claude Code 环境变量里换模型名 |
| 视觉能力 | 官方多模态模型支持 | GLM-4.6V 自带视觉理解,可丢截图分析 |
所以这套组合解决的本质问题,是“既要 Claude Code 的 Agent 体验,又想在模型和计费上有自主权”。接下来的实操部分,我会从最基础的环境准备开始,把每个关键步骤解释清楚。
2. 环境准备:从 Node.js 版本到 Claude Code 起手的三个坑
2.1 为什么先装 Node.js 而不是直接装 VS Code 扩展
很多人在 VS Code 扩展市场搜到 “Claude Code” 就直接点了安装,结果打开后一脸懵:扩展能装上,但点击启动时总是报错。原因很简单:Claude Code 的实体是本地 CLI 工具,VS Code 扩展只是它的图形化外壳。CLI 用 Node.js 编写,通过 npm 全局安装,所以 Node.js 才是真正的安装前置项。
建议直接装 Node.js 的 LTS 版本,不要碰 Current 版本。当前 LTS 大约在 20.x 到 22.x 之间,都满足 Claude Code 的要求。如果机器上已经装了旧版(比如 16 或 14),务必先升级,否则后面安装 CLI 时会出现各种奇怪的兼容问题。
Windows 用户去官网下载 LTS 安装包,一路默认下一步。macOS 用户我习惯用 Homebrew:
brew install node安装完要新开一个终端窗口执行node -v和npm -v。注意是“新开窗口”,因为旧窗口的环境变量不会刷新,直接验证会报找不到命令。
2.2 Windows 上 PowerShell 执行策略这个坑
这个坑我至少见过十个朋友踩过。在 Windows 上全局安装完 Claude Code,执行claude时终端报出一段红字:无法加载 claude.ps1,因为在此系统上禁止运行脚本。
原因是 PowerShell 默认执行策略是 Restricted,不允许执行 .ps1 脚本文件。Claude Code 的启动脚本正是以 .ps1 形式存在的。解决办法不是换终端,而是给当前用户放开执行策略限制:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser执行后会让你确认,输入 Y 回车。RemoteSigned 表示本地写的脚本可以运行,从网上下载的脚本必须有签名。这个力度比较适中,不建议改成 Unrestricted。
改完后重新打开终端,执行claude就能正常进入交互界面。如果你之前用 npm 装过老版本,建议先执行npm uninstall -g @anthropic-ai/claude-code,再重新安装,避免旧版本残留。
2.3 安装 Claude Code 与镜像源注意事项
Node.js 就绪后,全局安装 Claude Code:
npm install -g @anthropic-ai/claude-code如果你在执行这条命令时速度很慢,大概率是 npm 官方源的网络链路问题,并不是安装步骤有误。可以临时指定国内镜像源:
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com注意:如果你的机器已经配置过 npm 全局路径,安装结束后命令行里找不到claude,需要检查 npm 全局 bin 目录是否在 PATH 中。Windows 下通常会在%APPDATA%\npm,macOS/Linux 下在/usr/local/bin或用户目录。
安装完成后验证版本:
claude --version能输出版本号,说明 CLI 本身装好了。这一步先不用登录,也不要去接官方 API,我们接下来先把智谱那边的准备工作做完。
3. 智谱开放平台:API Key、免费额度与兼容端点配置
3.1 注册、创建 API Key 与免费资源包
打开智谱开放平台(通常访问 bigmodel.cn 就能进到控制台),用手机号注册账号并登录。个人开发者注册后在个人中心完成实名认证,就能开通 API 服务。整个流程都是国内常规的账号体系,不需要准备海外支付方式,这是很多团队选择它的直接原因。
登录控制台后,在“API Keys”页面创建一个新 Key。智谱的 API Key 格式比较特殊,是一串以点号分隔的两段式字符串,类似id.secret。创建成功时页面会完整显示一次,之后就不再展示全部内容,所以复制保存后要放到安全的位置。我个人的习惯是存到本机的密钥管理工具里,不放进代码仓库,也不写在博客评论区里分享。
关于 cost 方面,新注册用户通常会有免费资源包可以领取,我写这篇内容时,平台还在发放大额的新人 token 礼包,入口在控制台的资源包或活动中心,具体以你操作时官网的实际入口为准。这些免费 token 足够把一个真实项目跑通,也能支撑你完成下面整套测试流程,先不用急着充值。
3.2 兼容端点、模型标识与接口自测
智谱开放平台为 Claude Code 提供的 Anthropic 兼容端点地址是:
https://open.bigmodel.cn/api/anthropic模型名使用:
glm-4.6vClaude Code 在请求时会自动拼接/v1/messages路径。为了少踩后面配置阶段的坑,我先建议你在浏览器里做一个最基础的接口自测。用下面这条 curl 命令,把你的APIKey换成刚才创建的真实 Key:
curl https://open.bigmodel.cn/api/anthropic/v1/messages \ -H "x-api-key: 你的APIKey" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "glm-4.6v", "max_tokens": 512, "messages": [ {"role": "user", "content": "用一句话介绍你自己"} ] }'如果接口配置正确,你会收到一段包含正文内容的 JSON 响应。如果返回 401,说明 Key 有问题或复制格式有误;如果返回 404,说明模型名不对。这一步能提前把认证类问题拦在门外,等会儿配置 Claude Code 时如果遇到 401,你至少知道不是智谱这边的问题。
我实测下来,这个兼容端点同时接受x-api-key和Authorization: Bearer <APIKey>两种鉴权方式,Claude Code 默认走后退逻辑,可靠度足够。你不需要在自测阶段把两种都验证完,能通一路即可。
4. 把 Claude Code 指向 GLM-4.6V:两种配置路径详解
4.1 方案A:通过 settings.json 注入环境变量
Claude Code 的全局配置文件位于用户目录下的~/.claude/settings.json。这个文件支持env字段,可以写入自定义环境变量,Claude Code 每次启动时会加载它。把下面这段配置填进去,就能把请求拉到智谱:
{ "env": { "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic", "ANTHROPIC_AUTH_TOKEN": "你的智谱APIKey", "ANTHROPIC_MODEL": "glm-4.6v" } }三个环境变量的作用我拆开解释一下:
ANTHROPIC_BASE_URL:Claude Code 发请求的目标地址。默认是 Anthropic 官方地址,改成智谱后,请求就发到兼容端点了。ANTHROPIC_AUTH_TOKEN:鉴权凭证。智谱兼容接口用这个字段接收你的 API Key。ANTHROPIC_MODEL:模型名。Claude Code 某些版本会默认使用服务端内置模型,为了确保实际跑的是 GLM-4.6V,建议显式指定。
如果只想让某一个特定项目使用智谱,不要改全局文件,而是在项目根目录下创建.claude/settings.json,写入相同内容。项目级配置优先于全局配置,这样你可以在不同项目里灵活指定不同模型。
4.2 方案B:使用命令行 claude config 全局设置
有些开发者不喜欢手改 JSON,更习惯命令行操作。Claude Code 提供了配置命令,逐条执行即可:
claude config set --global ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic claude config set --global ANTHROPIC_AUTH_TOKEN 你的智谱APIKey claude config set --global ANTHROPIC_MODEL glm-4.6v查看当前配置是否写入:
claude config list --global方案 A 和方案 B 本质上都是在改环境变量,只是入口不同,二选一即可。我个人更推荐方案 A 的 settings.json 写法,因为文件直观、可注释、方便用 git 管理(如果你选择把它纳入版本库的话),而且团队内部共享时更容易对齐。方案 B 更适合临时调试,比如在一台不常改配置的机器上快速指过去。
这里需要提醒一点:如果你之前配置过 Anthropic 官方 API Key 的全局环境变量,两套来源的变量同时存在时,项目级 settings.json 和 CLI 配置有更高优先级。如果切换后仍然请求到了官方端点,优先检查是否还有系统级环境变量在生效。
4.3 验证是否真的命中 GLM-4.6V
配置完成后,先不要急着打开 VS Code,在终端里做一次最直接的验证。找个临时目录,比如/tmp/test-claude,执行:
claude -p "输出当前使用的模型名称,并介绍你自己"-p表示非交互模式,适合快速测试。如果此时返回的正常内容是中文回复,并且提到了 “glm-4.6v” 或智谱相关字样,说明请求已经命中智谱端点。如果返回 401 或模型不存在,请回到第 3.2 节重新验证 Key 和模型名。
进入交互模式后,部分版本的 Claude Code 支持/status命令查看当前配置和模型信息。如果版本没有这个命令,直接看请求是否能正常走通即可。这里最关键的判断标准是:不再报鉴权错误,能真实生成代码或回答问题,就说明整条链路已经通了。
5. VS Code 扩展集成:侧边栏跑通 + 首次任务实测
5.1 安装 Claude Code 官方扩展并理解它的运行机制
进入 VS Code 扩展市场,搜索 “Claude Code”,选择发行方为 Anthropic 的官方扩展进行安装。这里要注意:千万不要只装一个图标差不多的第三方插件就完事。第三方插件良莠不齐,很多只是套壳,并不读取本地 CLI 配置,装完反而容易把环境搞乱。
因为上一个章节已经配置好了~/.claude/settings.json,扩展安装后会自动读取这些配置。它的运行机制是这样的:VS Code 扩展本身只是一个图形前端,真正干活的还是本地安装的 Claude Code CLI。所以第 2 章里安装的 CLI 是刚需,不能跳过。
安装完成后,左侧活动栏会出现 Claude Code 的图标。点击图标会启动侧边栏面板。如果你是第一次使用扩展,它可能会引导你登录 Anthropic 官方账号。这一步要特别留意:我们已经通过环境变量接入智谱了,不需要官方登录。如果面板一直引导登录,找一下设置里的 “登录方式” 或 “API Key 类型” 选项,选择自定义、或者直接继续用环境变量配置即可。
5.2 在 VS Code 侧边栏里配置 Base URL 和 Api Key
我个人的建议是:在侧边栏跑了第一次之后再考虑要不要填图形化配置。因为~/.claude/settings.json已经写好了环境变量,扩展应该能直接读取。但如果你发现扩展并没有读到配置,或者你不想改动全局 JSON,也可以把配置填到 VS Code 自己的设置里。
在 VS Code 设置界面(快捷键Ctrl/Cmd + ,),搜索 “Claude Code”,会看到跟 Base URL、Api Key 相关的字段。填入:
Base URL: https://open.bigmodel.cn/api/anthropic Api Key: 你的智谱APIKey填写后,VS Code 会把这些值合并进扩展的运行时环境。如果需要重启 VS Code 才能生效,就重启一下。重启后重新点击侧边栏图标,输入一个最简单的 prompt 测试,比如“当前项目是用什么语言写的?”如果它能识别出项目类型,说明 VS Code 集成已经成功。
注意一个小细节:如果你以前在 VS Code 扩展里登录过 Anthropic 官方账号,切换成智谱后,最好在扩展设置里把旧账号登出。不然有些版本会在启动时尝试连接官方服务,出现登录信息过期之类的提示,干扰调试。
5.3 首次任务实测:让 GLM-4.6V 在真实项目里干活
配置通了之后,我拿一个自己写的小型 Express 项目做了次完整测试。给它下达的任务是:
给 src/utils/format.js 写一组完整的单元测试,然后运行 npm test 查看结果;如果测试失败,修复对应代码。Claude Code 在侧边栏里的执行过程大致是这样的:
- 先读取
package.json,确认测试框架是否装好; - 打开
src/utils/format.js,理解现有函数逻辑; - 生成对应的测试文件;
- 自动执行
npm test; - 读取失败输出,回到代码里调整,再跑,直到全绿。
整个过程我没有手动做过任何干预,只靠自然语言描述。GLM-4.6V 在这一套流程中的工具调用非常顺畅,没有发生中途掉链子、生成代码后不会自己执行的情况。相比我在终端里直接叫claude,侧边栏的好处是代码改动实时显示在编辑窗口里,我在旁边看着它改,能更快判断哪些改动可以接受、哪一步跑偏了。
另外提一句 GLM-4.6V 的视觉能力:它不是纯文本模型,支持直接读图。有次我截了一张页面错位的浏览器截图丢给它,描述“这个页面为什么右边空了”,它能识别布局问题并给出对应 CSS 修改建议。所以遇到样式、截图、设计还原类的需求时,可以直接贴图,不要只打文字。
6. 踩坑排错与日常使用优化
6.1 常见报错与定位链路
这套环境涉及的环节比较多:VS Code、CLI、Node.js、智谱平台、配置文件。任何一个点出错,表现可能都类似。我把实际遇到过的几类报错整理成表格,按“错误现象—可能原因—处理方法”的顺序来定位:
| 错误现象 | 可能原因 | 处理办法 |
|---|---|---|
| 401 Unauthorized | API Key 错误、复制时带了空格、Key 过期 | 回到智谱控制台重新创建 Key,再执行第 3.2 节 curl 验证 |
| 404 model not found | 模型名写错,或模型不支持当前接口 | 确认配置里的模型名是glm-4.6v,不是旧版名称 |
| 请求超时 | 本地网络到智谱端点不通,或端点配置有误 | 先用浏览器访问https://open.bigmodel.cn确认可访问,再检查 Base URL 是否拼错 |
| 提示无法加载 claude.ps1 | PowerShell 执行策略限制 | 按第 2.2 节执行 Set-ExecutionPolicy |
claude不是内部或外部命令 | npm 全局目录不在 PATH,或安装失败 | 重装 CLI,检查 npm prefix 并手动把 bin 目录加入 PATH |
| VS Code 扩展启动后一直转圈 | 扩展没读到本地 CLI,或 CLI 版本过旧 | 在终端执行claude --version,确认 CLI 在用;重启 VS Code |
| 请求仍打到官方 API | 系统级环境变量或扩展设置里残留官方 Key | 全局搜索ANTHROPIC_API_KEY,清掉旧变量,重启终端和 VS Code |
这里有个排错顺序的建议:先判断是不是 Key 和网络的最基础问题,再检查配置,最后再怀疑 CLI 或扩展本身。不要一上来就重装所有东西。很多时候就是某个环境变量拼写多了个空格,或者模型名新旧版本不一致。
6.2 token 消耗管理、配置热切换与长会话维护
GLM-4.6V 虽然比官方模型成本低,但 Claude Code 这类 Agent 工具会频繁读取文件、反复执行命令,token 消耗速度比普通聊天快不少。在实际使用中,我有几个控制消耗的习惯。
第一,在项目根目录创建.claudeignore文件,把不需要 AI 扫描的目录排除掉。它和.gitignore的语法类似,常见内容:
node_modules dist build .git .idea .vscode这样 Claude Code 在做文件检索和上下文收集时,不会把 node_modules 里成千上万的依赖文件读进去,既提升响应速度,也省 token。
第二,长会话及时清理上下文。对话拉得很长后,模型要携带的历史信息越来越多,每次请求的 token 消耗会上涨。如果发现 Claude Code 反应变慢,可以输入/clear开启新一轮对话。如果只是想把当前关键信息精简保留,可以用/compact压缩上下文,新版 CLI 是支持这类指令的。
第三,多套模型配置热切换。我自己的电脑上同时维护着官方模型和智谱两套配置,用于不同场景。官方模型用于兼容性验证,GLM-4.6V 用于日常开发和成本控制。实际操作层面,改配置文件再重启 VS Code 就行,不算麻烦。如果想更高效,可以使用社区里常见的配置切换工具,把多个 Base URL、Key、模型名存成不同 profile,一键切换,省去每次手改文件的时间。
最后说一点个人体会:Claude Code 接国产模型这件事,难点从来不在模型本身,而在“协议能否对齐”。智谱做了 Anthropic 兼容接口,等于把最难的一段路铺平了。你不需要研究 Anthropic API 的细节,也不需要懂中间层开发,只改环境变量就能搞定。这套组合我跑了一段时间,体感上是目前 VS Code + Claude Code 接入国产模型最顺滑的路径之一。如果你是第一次折腾,不用追求一次成功,按第 6.1 节的排查顺序,每一步多做一次验证,很快就能把环境跑通。