如果你跟我一样每天都在 VS Code 里写代码那最近一定被 Claude Code 这个终端编程助手刷屏了。它是 Anthropic 官方的 Agent 工具最大的特点是能读懂整个项目结构然后自己动手改文件、执行命令、跑测试——你只需要在终端里把需求说清楚。但很多人卡在第一步模型服务门槛不低而且价格对个人开发者不算友好。于是国内开发者圈子里折腾最多的路线就是把 Claude Code 的模型层换掉接到国产大模型 API 上。我今天要分享的就是这条路线里最省心的组合VS Code Claude Code 接智谱 GLM-4.6V。整个教程从零开始二十分钟能跑通关键是智谱新用户有 3 亿 token 体验金前期试错基本不花钱。我会把原理、配置、实操和踩坑全部写出来适合刚接触 Claude Code 的小白也适合已经装好但接不上 GLM 的老手。1. 接入方案与原理为什么是 Claude Code 加 GLM-4.6V1.1 Claude Code 到底是什么、它解决什么问题Claude Code 是一个运行在终端里的编程代理不是普通的代码补全插件。它做的事更像一个结对程序员你说要加一个登录接口它会自己去读现有代码、理解路由怎么写、创建文件、补依赖甚至直接执行测试命令给你看结果。整个过程是多轮对话加工具调用而不是你一次提问、它回复一段代码就结束。我最初被它吸引是因为它把改代码这件事从对话里落地了。之前用聊天式 AI 写代码经常要复制粘贴代码片段再手动打开文件修改来回切换很割裂。Claude Code 是直接在项目目录里工作它知道当前仓库的目录结构、依赖配置、Git 状态改完了还能直接给你 diff。对于接口开发、重构、修 bug 这类任务效率提升非常明显。而且它不挑前端后端Python、Node、Java、Go 都能处理只要终端能跑的命令它都能调。VS Code 里开一个终端就能用不用换编辑器这也是它能在开发者社区快速火起来的原因。1.2 为什么选智谱 GLM-4.6V 当驱动模型选择驱动模型的时候我考虑过几家常用的国产 APIDeepSeek、豆包、千问、智谱。它们各有优势但最终我留下的是智谱 GLM-4.6V主要是三个原因。第一GLM-4.6V 的代码能力和工具调用在国产模型里是第一梯队。Claude Code 依赖模型做一件关键的事理解工具返回结果然后决定调用哪个工具、传什么参数。GLM-4.6V 在代码生成、函数调用这些维度上表现稳定不是那种聊起来很聪明但一写代码就跑偏的模型。第二它有视觉能力。GLM-4.6V 后面的 V 是 Vision 的意思可以直接看图。这对写前端太有用了设计稿截图、页面报错截图、UI 细节差异图直接丢给终端里的模型它能理解画面内容再动手改代码。很多模型只有文本能力遇到照着这个图实现页面的需求就抓瞎。第三智谱对外提供了兼容接口配置最简单。Claude Code 官方发的消息格式是 Anthropic 协议智谱直接做了对应适配不需要自己写代理、装中间件。你只要改几个环境变量把请求地址指向智谱模型名字换成 glm-4.6v剩下的全交给 Claude Code 自己处理。顺带说一句如果你之前领过智谱的 3 亿 token 体验金新账号自带的额度足够白嫖挺长时间。这也是很多新手选择它的理由——先零成本跑通流程确认值不值得再付费。1.3 接入原理Claude Code 如何把请求转发给 GLM要理解这套接入为什么不复杂得先弄清 Claude Code 的工作方式。Claude Code 本身就是一个命令行程序它在终端里收集你的自然语言输入拼上系统提示词、项目上下文、工具定义打包成一个 HTTP 请求发送给模型服务端。服务端返回内容后Claude Code 再解析里面的工具调用指令执行命令或读写文件然后继续下一轮。这个过程中Claude Code 并不关心服务端背后跑的是什么模型它只关心接口协议对不对。Anthropic 官方用的是 Messages API 格式而智谱的兼容端点也实现了这套格式。所以我们做的事很简单把请求地址从官方改成智谱的把认证密钥从官方的换成智谱的把模型名从 claude- 改成 glm-4.6v。打个比方这就像公司前台打电话号码和分机号决定了电话转给谁但通话方式和话术不变。Claude Code 就是那个打电话的人我们改的只是通讯录里的号码不需要动话术也不需要换电话机。我见过有人自己写 Node 脚本中转请求也有人用各种代理工具做协议转换其实都不需要。智谱官方提供了兼容端点一步到位而且不用维护中间服务升级 Cluade Code 版本也不会受影响。2. 环境准备VS Code、Node.js 与 Claude Code 安装2.1 VS Code 下载与安装附中文界面配置VS Code 的安装没什么门槛去官方站点 code.visualstudio.com 下载对应系统的安装包。Windows 注意选 x64 User InstallermacOS 选 Apple Silicon 或 Intel 对应版本。安装时我建议勾选添加到 PATH这样后续可以直接在终端里用code .打开当前目录很常用。装完之后如果想用中文界面左侧扩展市场搜 Chinese装中文简体语言包装完重启 VS Code 就会变成中文菜单。这个不装也不影响使用但很多新手习惯中文界面看菜单更安心。接下来顺手做一件事在 VS Code 里打开终端面板快捷键 Ctrl 或者菜单栏 Terminal - New Terminal确认终端的默认 shell 是 PowerShellWindows或 bashmacOS/Linux。后面跑 Claude Code 全靠这个终端别用别人推荐的在线编辑器替代在本地终端里操作最顺。2.2 Node.js 环境准备与版本选择Claude Code 是 npm 安装的命令行工具所以电脑上必须先有 Node.js 环境。这里强调一下Node.js 版本不要太老Claude Code 对运行环境有要求建议装 20 LTS 或 22 LTS这两个版本目前最稳。去 nodejs.org 下载 LTS 版本Windows 安装包是 .msimacOS 是 .pkg安装时一路下一步就行它会自动把 npm 一起装上并把 node 和 npm 加入系统 PATH。装完验证一下新开一个终端输入下面两条命令能看到版本号就说明环境没问题。node -v npm -v如果你执行命令提示node 不是内部或外部命令多半是安装时没有勾选 Add to PATH或者 PATH 没有刷新。最简单的方法是重新安装并勾选避免手动改环境变量的麻烦。还有一个小坑npm 下载依赖默认走境外源国内网络环境有时候很慢。我习惯先切到国内镜像后面装 Claude Code 会快很多。npm config set registry https://registry.npmmirror.com2.3 Claude Code 安装与基础验证环境没问题后直接用 npm 全局安装 Claude Code。npm install -g anthropic-ai/claude-code安装过程的输出比较长最后出现 done 或 added 字样就说明成功。然后验证版本claude --version能输出版本号比如 1.0.x 或更高就说明 Claude Code 已经装好了。这里给 Windows 用户提个醒如果你在终端里输入 claude 提示找不到命令但 npm 安装成功了大概率是 npm 全局目录没有加入 PATH。解决方法是执行npm config get prefix查看全局安装路径把它加到系统 PATH 里然后重启终端。还有一个权限问题。macOS 或 Linux 下如果用 nvm 管理 Nodenpm 全局安装可能遇到 EACCES 权限不足这种情况不要直接 sudo npm install建议检查 nvm 目录归属正常来说 nvm 安装的 Node 不需要 sudo。如果实在不行可以用npm install -g --user的方式或者切换到 nvm 管理的 Node 版本。3. 智谱 API Key 与模型参数配置3.1 注册智谱账号并领取 3 亿 token 体验金访问智谱开放平台 bigmodel.cn用手机号注册账号注册完成后需要实名认证才能调用模型 API。认证流程很快按页面提示填信息即可。登录控制台后首页一般会有新用户 3 亿 token 体验金的入口直接点领取。领取的时候注意看说明体验金通常有有效期而且并非所有模型都支持赠送GLM-4.5、GLM-4.6 一般都在覆盖范围内但要以控制台的实际提示为准。如果页面没显示入口可以看控制台左侧有没有资源包或优惠券之类的位置。有一点需要提前说清楚体验金耗尽或者过期之后调用就按模型实际定价计费。所以我是建议先领完再配置跑通流程要花掉的 token 完全可以覆盖。3.2 创建 API Key 与计费要点在控制台左侧找到API 密钥或者API Keys模块点击创建新的 Key。智谱返回的 API Key 是id.secret这种两段式结构中间用点号拼接。复制的时候要把完整字符串都复制走不要手动输入因为 key 里面的点号和字母容易看漏。关于计费GLM-4.6V 是按 token 计费输入和输出价格不同。控制台里有对应的价格页和消费看板个人开发建议开启余额提醒或消费告警防止自己开了个长任务忘关一夜之间烧掉不少钱。这个 Key 非常重要后续所有配置都要用到。建议放到本地环境变量里不要写进代码库不要提交到 Git。万一泄露去控制台删掉重建就好。3.3 配置环境变量的两种方式Claude Code 通过环境变量知道三件事请求地址发到哪、认证密钥是什么、模型名是什么。核心变量如下ANTHROPIC_BASE_URL智谱的兼容端点地址值固定是https://open.bigmodel.cn/api/anthropicANTHROPIC_AUTH_TOKEN你的智谱 API KeyANTHROPIC_MODEL主模型名填glm-4.6vANTHROPIC_SMALL_FAST_MODEL后台快速任务使用的模型填glm-4.5v或glm-4.6vANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL覆盖 Claude Code 内部按模型层级分配的任务为什么要把后面这几个模型变量都配齐因为 Claude Code 内部不是所有请求都走同一个模型。比如对话主任务用大模型后台的标题生成、对话摘要这类轻任务用小模型如果不覆盖Claude Code 仍会用默认的claude-3-5-sonnet这类模型名去请求智谱结果就是报错 model not found。所以最稳妥的做法是把所有模型名都替换成 GLM 系列。Windows 用户可以在 PowerShell 里用 setx 配置持久化环境变量setx ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic setx ANTHROPIC_AUTH_TOKEN 你的智谱API Key setx ANTHROPIC_MODEL glm-4.6v setx ANTHROPIC_SMALL_FAST_MODEL glm-4.5v setx ANTHROPIC_DEFAULT_OPUS_MODEL glm-4.6v setx ANTHROPIC_DEFAULT_SONNET_MODEL glm-4.6v setx ANTHROPIC_DEFAULT_HAIKU_MODEL glm-4.5v注意 setx 设置的是持久化变量但当前终端窗口不会立即生效需要新开一个终端再验证。macOS 和 Linux 用户建议写入 shell 配置文件。以 zsh 为例echo export ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic export ANTHROPIC_AUTH_TOKEN你的智谱API Key export ANTHROPIC_MODELglm-4.6v export ANTHROPIC_SMALL_FAST_MODELglm-4.5v export ANTHROPIC_DEFAULT_OPUS_MODELglm-4.6v export ANTHROPIC_DEFAULT_SONNET_MODELglm-4.6v export ANTHROPIC_DEFAULT_HAIKU_MODELglm-4.5v ~/.zshrc source ~/.zshrc如果是 bash写到~/.bash_profile或~/.bashrc里。配置完建议执行env | grep ANTHROPIC确认变量已经加载。4. 在 VS Code 中的完整接入实操4.1 在 VS Code 终端启动 Claude Code配置完环境变量后打开 VS Code用code .打开一个项目目录然后按 Ctrl 调出终端。先确认环境变量是否生效env | grep ANTHROPIC如果输出里能看到 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 等变量就可以启动了。在终端输入claude首次启动会显示欢迎信息和一些使用说明确认接受相关条款后就进入了交互式对话界面。你会看到一个提示符这时候就可以直接用自然语言提需求了。如果你更喜欢命令行一步到位也可以直接把问题跟在 claude 后面claude 分析当前项目的目录结构并给出优化建议Claude Code 会进入工作模式自动读取项目文件然后输出分析结果。我一般更喜欢这种带参数的启动方式省去手动输入第一条 prompt。4.2 第一个实际任务生成一个 FastAPI 接口项目接入是否成功跑一个小任务马上就能看出来。假设你在一个空目录里输入下面的 prompt帮我在当前目录下初始化一个 Python 的 FastAPI 项目包含一个 /health 接口和一个对输入文本做倒序处理的 /reverse 接口并补上 requirements.txt 和 README.md正常情况下Claude Code 会调用 GLM-4.6V 的接口然后自动创建文件、安装依赖、给出运行说明。整个过程中你会看到它自己在终端里执行 pip install、创建目录不需要你手动干预。生成的 main.py 大概长这样from fastapi import FastAPI from pydantic import BaseModel app FastAPI() class TextRequest(BaseModel): text: str app.get(/health) def health(): return {status: ok} app.post(/reverse) def reverse(req: TextRequest): return {reversed: req.text[::-1]}这个任务虽然简单但它能验证最关键的一件事模型能不能正确理解需求、工具调用链路是否通畅、Claude Code 能不能正常操作本地文件系统。只要这个流程跑通说明接入没问题。4.3 进阶用法用 GLM-4.6V 看图改前端GLM-4.6V 的视觉能力是它区别于纯文本模型的杀手锏。日常开发里我经常遇到一种场景UI 设计稿给了截图要求按图还原页面。以前我要自己对着截图量尺寸、猜颜色现在直接把截图路径丢给 Claude Code。在项目终端里输入看下 docs/homepage-mockup.png 这张设计稿用 HTML 和 CSS 还原这个页面。布局要对齐颜色用 CSS 变量统一抽取到 :root 里。Claude Code 会读取图片文件GLM-4.6V 会识别出图中的布局结构、文案层级、配色风格然后直接生成页面代码。这种看图写代码的能力对写前端、落地页、后台管理面板帮助非常大推荐你拿到 key 之后第一个就试它。4.4 会话管理与常用命令进入交互界面后有几个斜杠命令非常实用。/help查看所有可用命令/status查看当前会话状态/clear清空当前对话上下文重新开始/compact压缩历史对话保留摘要适合上下文太长的时候用/cost或/usage查看当前会话消耗不同版本命令名略有差异我自己的习惯是每完成一个小任务就/clear一次避免之前的对话影响下一个任务。如果是一个大功能的拆解开发就等到阶段性完成后/compact压缩历史继续推进。5. 常见问题排查与效率技巧5.1 常见报错速查表我把这段时间遇到的报错整理成了一张表按提示信息检索就能定位问题。报错信息可能原因解决方案401 UnauthorizedAPI Key 错误或环境变量没生效检查ANTHROPIC_AUTH_TOKEN是否完整复制执行env | grep ANTHROPIC查看生效值404 model not found模型名填写错误确认模型名是glm-4.6v不要写成 glm-4.6 或者带时间戳版本号402 Payment Required余额不足或体验金失效去控制台检查资源包状态必要时充值Failed to fetch / fetch failed本机无法访问 open.bigmodel.cn检查网络、DNS、防火墙确保能正常访问该域名Invalid API Key新版 Claude Code 同时校验ANTHROPIC_API_KEY设置ANTHROPIC_API_KEY为与智谱 Key 相同的值或任意非空占位符EBADENGINE / node 版本过低Node.js 版本不满足要求安装 Node 20 LTS 或 22 LTS中文乱码Windows终端编码不对执行chcp 65001切换 UTF-8这里面最容易被忽略的是最后两条。新版 Claude Code 对认证字段的校验越来越严格如果只设置了ANTHROPIC_AUTH_TOKEN却漏了ANTHROPIC_API_KEY启动会直接报 Invalid API Key。这时候把ANTHROPIC_API_KEY也设置成智谱 Key或者设置为任意非空字符串就能绕过校验因为实际的认证走的是 base url 方向的智谱端点。5.2 我踩过的三个深坑第一个坑是 setx 设置了环境变量后没重启终端和 VS Code结果 claude 启动一直报 401。我一开始怀疑 Key 写错了反复复制粘贴好几次最后才想起来新终端才能读到新变量。这个是最浪费时间的一步记住任何环境变量修改后重开终端别在当前窗口里继续排错。第二个坑是我最初把 base url 配成了智谱的 OpenAI 兼容地址https://open.bigmodel.cn/api/paas/v4。这个地址在很多地方都能用但它不是 Anthropic 协议Claude Code 发出去的消息格式人家不认识结果就是各种奇怪的报错。后来我把 base url 换成了https://open.bigmodel.cn/api/anthropic问题直接消失。Claude Code 必须用 Anthropic 协议端点不要自作聪明拿 OpenAI 端点去试。第三个坑是模型名细节。我第一次配置时填的是glm-4.6而不是glm-4.6v结果报 model not found。智谱不同版本模型的后缀不同V 代表视觉版本必须完整写对。如果不确定准确模型名去控制台的模型列表里复制别凭记忆手打。5.3 让 GLM-4.6V 更好用的几个建议接入跑通只是开始真正提升效率的是怎么用好它。我强烈建议你在项目根目录放一个 CLAUDE.md 文件。Claude Code 每次启动时会自动读取这个文件作为项目级上下文相当于给模型一份项目说明书。你可以在里面写清技术栈、目录规范、测试命令、命名约定比如# 项目说明 - 后端使用 FastAPI SQLAlchemyPython 3.11 - 路由统一放在 /api 前缀下 - 数据库迁移使用 Alembic - 测试命令pytest tests/ - 代码风格遵循 Black 默认配置有了这份文件GLM-4.6V 生成的代码会更贴合你项目的实际风格减少来回修改。另外要注意任务粒度。一次给一个明确的小目标让它做完确认再给下一个任务。不要一次性甩给它帮我写一个完整的电商系统这种大目标容易跑偏而且中间很难纠正。把大需求拆成先建项目骨架、再写用户模块、再接支付三个步骤每一步都验证体验会完全不一样。最后是成本控制。GLM-4.6V 虽然便宜但长会话累积起来也不容小觑。我习惯每完成一个阶段就/clear一次避免之前的代码上下文反复计入 token。同时定期去控制台看消费记录发现异常消耗就检查是不是有后台任务一直挂着没关。接入这套方案之后我比较直观的感受是工具链的价值不完全在某一个模型多强而在于整个工作流顺不顺。VS Code Claude Code GLM-4.6V 这套组合我用下来最舒服的一点是写代码的过程不再频繁切割——需求在终端里说清楚它自己完成文件操作和命令执行我只需要 review 结果、提修改意见。最后再分享一个小技巧如果你手里有多个模型 API建议在~/.claude/settings.json里把不同项目的 env 分开配置比如后端项目默认走 GLM-4.6V快速原型项目走 GLM-4.5V这样既省钱又不会因为某个模型临时出问题影响所有项目。接入本身不难难的是把 AI 嵌进你真实的编码流程里希望这篇能帮你少走几个弯路。