前天在技术群里看到有人问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 用户我习惯用 Homebrewbrew 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 Codenpm install -g anthropic-ai/claude-code如果你在执行这条命令时速度很慢大概率是 npm 官方源的网络链路问题并不是安装步骤有误。可以临时指定国内镜像源npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com注意如果你的机器已经配置过 npm 全局路径安装结束后命令行里找不到claude需要检查 npm 全局 bin 目录是否在 PATH 中。Windows 下通常会在%APPDATA%\npmmacOS/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换成刚才创建的真实 Keycurl 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_URLClaude 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 UnauthorizedAPI Key 错误、复制时带了空格、Key 过期回到智谱控制台重新创建 Key再执行第 3.2 节 curl 验证404 model not found模型名写错或模型不支持当前接口确认配置里的模型名是glm-4.6v不是旧版名称请求超时本地网络到智谱端点不通或端点配置有误先用浏览器访问https://open.bigmodel.cn确认可访问再检查 Base URL 是否拼错提示无法加载 claude.ps1PowerShell 执行策略限制按第 2.2 节执行 Set-ExecutionPolicyclaude不是内部或外部命令npm 全局目录不在 PATH或安装失败重装 CLI检查 npm prefix 并手动把 bin 目录加入 PATHVS 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 节的排查顺序每一步多做一次验证很快就能把环境跑通。