我这两天干了一件挺折腾但又很值的事把 Claude Code 接到了 GLM5 Coding Plan 上并且顺手把安装、模型切换、踩坑的整个过程完整捋了一遍。这篇文章不是官方文档的复读而是我作为一个天天用 AI 写代码的普通开发者的实际记录。先给结论Claude Code 这套终端智能体确实好用GLM5 Coding Plan 的性价比和可用性也撑得起日常开发两者之间通过 Anthropic 兼容接口接起来十来分钟就能跑通。教程覆盖三块核心内容——Claude Code 的安装与基础配置、GLM5 Coding Plan 的接入方法、以及 cc switch 模型切换的具体操作最后会专门讲一个很多人在切完模型后遇到的“原对话不停跳闪”问题我会把原因和解决办法完整拆开。适合已经在用或想尝试 Claude Code、同时又希望在模型选择上保留灵活性的人。1. 动手之前先把整体方案想清楚1.1 Claude Code到底是什么它和普通聊天客户端有什么区别Claude Code 是 Anthropic 出的一款终端内的 AI 编程智能体不是你想象中那种“在对话框里问问题”的工具。它可以直接读取你项目目录里的代码、跑终端命令、修改文件、提交代码甚至能自主完成一小条完整的开发链路。你给它一个任务它会自己规划步骤、调用工具、检查结果、再迭代。这个“agent 式”的工作方式和 ChatGPT 网页版是完全不同的逻辑。正因为它是智能体它对底层模型的能力要求也更高模型得能识别工具调用、能处理长上下文、能按 system prompt 约束行动。换句话说你换成别的模型时不是“换个人聊天”而是“换一个帮你写代码的实习生”。GLM5 Coding Plan 之所以能接进来核心就是因为智谱开放平台提供了 Anthropic 协议兼容的接口Claude Code 通过这些接口就能像调用官方 Claude 一样调用 GLM 模型。1.2 GLM5 Coding Plan是什么为什么我会选它GLM5 Coding Plan 是智谱面向开发者推出的编程套餐买下来之后你会拿到一个 API Key并且得到一个专门为编码场景调优的模型访问额度。它和普通按 token 计费的 API 不同走的是订阅制适合每天高频使用代码助手的开发者。我选它的理由很朴素第一它提供的模型在代码生成、代码理解、工具调用这些任务上确实够强不是那种“能对话但不会干活”的模型第二Coding Plan 的计费方式是包月制不用盯着 token 数字过日子第三也是最重要的一点它的接口是 Anthropic 兼容的这意味着我不用写任何适配代码Claude Code 的安装配置改几个环境变量就能直接干活。当然也要说清楚接入 GLM 之后你得到的不是“翻版 Claude”。系统提示词、工具定义、模型自身的行为习惯都不一样某些偏主观的任务上体验差异会比较明显。但从“能干活、省钱、稳定”的角度看这个组合完全站得住脚。1.3 接入方案的选型环境变量、cc switch、还是自定义配置Claude Code 之所以能切换模型是因为它在启动时会读取一组环境变量。最关键的有两个ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN。前者告诉 Claude Code 把所有 API 请求发到哪个地址后者是鉴权用的密钥。你只要把这两个变量指向 GLM Coding Plan 提供的 Anthropic 兼容端点Claude Code 就不再走 Anthropic 官方服务器了。基于这个原理接入方案有三种直接向终端导入环境变量一劳永逸适合只用一个模型的人用 cc switch 这类社区工具管理多套配置适合像我这样要在 GLM、DeepSeek、Qwen、本地模型之间来回切换的人在 Claude Code 自己的配置文件里写 proxy 或自定义 base URL适合有固定团队规范的人。我个人建议第一次接入时先用手动环境变量验证通路跑通之后再上 cc switch。这样出问题的时候你能清楚地区分“接口配置错了”和“切换工具的问题”。我在后面的章节会按这个顺序写。2. 从零安装Claude Code一条龙实操记录2.1 安装前提Node.js和npm的检查与安装Claude Code 是 npm 全局包所以你得先有 Node.js 环境。很多人在这一步就卡住了因为系统里的 Node 版本太老或者压根没装。Claude Code 对 Node 版本的要求比较高最好在 18 以上20 甚至 22 更稳。先检查一下你现在的环境终端里执行node -v npm -v如果两个命令都能正常输出版本号并且 node 版本在 18 以上那就可以直接跳到 2.2。如果你还没装不同的系统有不同的装法。Windows 用户去 Node.js 官网下载对应架构的 MSI 安装包双击安装即可。安装过程中记得勾选 Add to PATH 那一项很多教程没强调这个结果装完node命令找不到就以为自己装失败了。装完之后重新开一个终端窗口让 PATH 生效。注意环境变量的刷新是强制性的我见过好几个同事在同一台机器上死活执行不了npm最后发现是终端没重开。macOS 用户最简单的方式是用 Homebrewbrew install node一条命令解决。Linux 用户我不建议直接用 distro 自带的版本Ubuntu 默认源里的 Node 往往很旧。推荐先用 nvm 装curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 20 nvm use 20这里说个经验尽量别用 sudo 去改全局 npm 目录。如果你已经碰到EACCES: permission denied的问题与其 sudo不如直接用 nvm 重装一套 Node。sudo 能解决眼前的问题但也可能带来后续文件权限的混乱。2.2 安装Claude Code本体环境就绪之后安装本身非常快npm install -g anthropic-ai/claude-code装完之后确认一下版本claude --version能输出版本号就说明装好了。如果你的输出是command not found多半是 npm 的全局 bin 目录没有在 PATH 里。用npm prefix -g查一下全局目录再把对应的 bin 目录加到 PATH 环境变量里就行了。这里有件事值得单独提醒Claude Code 是命令行工具不是桌面应用不需要额外的 GUI 窗口。我第一次找它的图标找了半天后来才反应过来这货就活在终端里。你在项目目录下敲claude它会先分析当前目录结构然后进入一个交互式命令行界面你在这里面用自然语言给它下达编程任务。2.3 两种使用姿势终端直跑和VS Code插件终端直跑是最原汁原味的方式。进入项目目录执行claude它会自动识别项目的语言、框架、git 状态。第一次运行会在项目根目录生成一份CLAUDE.md作为项目记忆文件你可以手动往里写项目的约定、命令、注意事项Claude Code 在后续对话中会参考它。VS Code 插件的方式适合不想切窗口的人。在扩展商店搜 Claude Code for VS Code也有叫 Claude Code 插件的安装后在左侧面板里就能看到会话窗口它本质上还是调用同一个 CLI 后端。连接的基本逻辑没变还是那套环境变量和配置。我的实际用法是两者混用重度操作、需要 AI 反复执行命令和改文件时用终端单纯想在一个窗口里聊需求和看代码时用 VS Code 面板。这两种方式读的是同一套配置不需要单独设置。3. GLM5 Coding Plan的接入与模型切换实战3.1 获取GLM5 Coding Plan的API凭证接入前先得有一个有效的 Coding Plan。去智谱开放平台开通对应套餐然后进到 API Key 管理页面创建一个新的 Key。创建的时候建议单独建一个用途明确的 Key不要把自己所有的 Key 混在一起这样就算泄露了也能单独吊销。创建成功之后你手里会有一串形如xxxxxxxx.api-key的密钥这个字符串就是ANTHROPIC_AUTH_TOKEN的值。关于端点地址Coding Plan 的说明文档里会给出 Anthropic 兼容接口的 base URL大致形态是https://open.bigmodel.cn/api/anthropic这样的地址。注意别把它的 OpenAI 兼容地址和 Anthropic 兼容地址搞混虽然都是同一个账号体系但协议路径不一样。填错地址的表现通常是接口返回 404 或一大堆协议解析错误。然后就是模型标识。套餐对应的模型名会在后台或文档里列出来常见的是带glm-5-coding或类似字样的名字。这个值会填到ANTHROPIC_MODEL环境变量里。3.2 方法一用环境变量直连GLM最快上手这个方法的核心就三条命令。在 Linux/macOS 的终端里先写入环境变量再启动export ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic export ANTHROPIC_AUTH_TOKEN你的_API_Key export ANTHROPIC_MODELglm-5-coding claudeWindows 用户用 PowerShell 的话等价的写法是$env:ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic $env:ANTHROPIC_AUTH_TOKEN你的_API_Key $env:ANTHROPIC_MODELglm-5-coding claude注意这里必须用ANTHROPIC_AUTH_TOKEN而不是ANTHROPIC_API_KEY。Claude Code 在识别到自定义 base URL 时会优先读取ANTHROPIC_AUTH_TOKEN作为 Bearer Token 发送如果你只设了ANTHROPIC_API_KEY它可能会走官方登录逻辑或者把 Key 放到不正确的请求头里导致 401。这个细节我在第一次配的时候踩过网上很多旧教程写的还是ANTHROPIC_API_KEY已经过时了。启动之后先别急着派活。在交互界面里输入/status确认当前使用的模型和端点信息都指向了 GLM。然后随便给一个小任务比如“读取这个目录下所有文件告诉我项目用了哪些技术栈”。如果它能正常列出来说明通路已经打通。3.3 方法二用cc switch管理多套配置日常切换最舒服环境变量直连虽然简单但只适合一台机器只用一个模型的情况。我日常会在 GLM、DeepSeek、Qwen 甚至本地模型之间来回切每次去敲 export 命令太容易出错。cc switch 就是解决这个问题的社区工具它把多套“API 提供商配置”统一管理切换的时候只需要选中对应配置它会自动帮你改好 Claude Code 的相关文件或环境变量。cc switch 通常提供两种方式运行一种是全局安装npm install -g cc-switch另一种是不安装、直接用 npx 拉起来跑npx cc-switchlatest具体以项目 README 为准。启动之后界面一般会有一个配置列表你按它的提示新增一个配置配置名称填GLM5 Coding PlanBase URL填 Anthropic 兼容端点API Key填你的智谱 Key模型标识填glm-5-coding保存之后把它设为当前激活配置。此时 cc switch 会改写 Claude Code 的配置文件常见的落点是~/.claude/settings.json或环境变量文件。设置完成后退出终端里的 claude重新启动让配置彻底刷新。随后用/status验证。这里有一个我用下来的重要心得cc switch 改的是磁盘配置而手动 export 改的是当前终端进程的环境变量两者叠加时进程内环境变量的优先级通常更高。如果你发现 cc switch 明明激活了 GLM但 claude 里看到的仍是别的东西十有八九是你启动 claude 的那个终端窗口里残留了旧的 export。最简单的处理办法在干净的终端窗口启动或者先unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL再启动。3.4 配置生效后的验证清单接入完成后我建议按下面的清单做一遍验证免得用到一半才发现配置不对劲claude --list-models或/models确认客户端能拉到 GLM 的模型列表发送一个“读文件 改文件”的复合任务验证工具调用是否正常检查智谱开放平台的用量页面看有没有实时产生请求记录跑一个稍微长一点的上下文任务比如让 AI 总结整个项目确认长文本不吃亏连续对话几轮确认多轮交互时不会出现历史消息丢失。第 2 点是风险最高的。因为普通对话接口和工具调用接口对协议细节要求不同如果端点不支持 tool callingClaude Code 会表现为“AI 一直在思考但不输出修改结果”。这条验证到位了基本可以放心用。4. 踩坑实录与问题速查4.1 cc switch切换模型后原对话不停跳闪怎么办这是我在热搜词里看到的槽点我也亲手复现过。现象是用 cc switch 把模型从 A 切到 B再回到原对话终端里会话内容开始像抽风一样不停重绘一会儿出现一会儿消失输入命令也卡顿看起来像界面在反复刷新。我排查之后给你的结论这大概率不是 cc switch 的 bug而是 Claude Code 的会话历史和新后端配置不匹配导致的渲染循环。原对话里存着旧模型产生的完整消息记录、工具调用结果、上下文 token 等切模型后客户端试图把这些旧消息重新发送给新端点但新端点的系统提示词、工具定义和模型行为都不一样于是客户端在等响应和重绘界面两个状态之间反复横跳视觉效果就是“不停跳闪”。解决步骤如下按顺序试在会话内执行/clear清空当前对话上下文这是最快的止血方式完全退出 claude注意不要只输入/exit要彻底 CtrlC 杀掉进程重新启动启动后不要用--resume恢复旧会话直接开新会话把刚才的任务重新描述一遍如果跳闪依旧看看是不是旧会话的本地缓存文件损坏了清理~/.claude下对应的会话记录文件最后再检查 cc switch 的配置版本如果它允许不同提供商之间共享一套会话历史要找找有没有“切换后自动新开会话”的选项。另外我的操作习惯是切换模型之前先结束当前对话不要“边聊边切”。Claude Code 是强状态应用你切配置的瞬间它可能正拿着旧模型的历史在等新模型的回复出什么幺蛾子都不奇怪。4.2 提示 not available in your country 或订阅被拒绝怎么办不少人在启动 claude 时见过一句提示大意是 “Claude Code might not be available in your country” 或 “your organization has disabled claude subscription access”。先说明这句提示在你用官方账号登录流程时会冒出来。我们的思路是用 API Key 直连第三方端点直接绕开官方订阅鉴权流程所以这句话至多是启动时的警告不影响后续使用。关键点在于一定要在启动前的环境里同时设好ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN并且不要手动执行官方登录操作。如果启动时它还在引导你进浏览器登录说明有一条配置没被识别到先停下来检查端点和 Key 是否真的在变量里。等 claude 进入对话界面后用/status确认模型来源只要显示的是第三方端点这个警告就可以无视了。4.3 API返回401/403或一直超时怎么办401 和 403 都是鉴权失败但含义略有差别。401 是 Key 不被识别403 是 Key 有效但权限不够。排查顺序检查 Key 有没有复制错智谱的 Key 是一长串带前缀的字符串很容易在复制的时候丢掉末尾字符确认 Key 对应的套餐是 Coding Plan普通 API Key 不一定有权限访问 Anthropic 兼容端点确认请求发到了正确的 base URL多一个/或少一个/都可能导致路由不对直接用 curl 验证端点连通性排除 Claude Code 本身的问题curl https://open.bigmodel.cn/api/anthropic/v1/messages \ -H x-api-key: 你的_API_Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:glm-5-coding,max_tokens:64,messages:[{role:user,content:ping}]}这段请求如果返回正常的 JSON 结构说明接口和 Key 都没问题问题在 Claude Code 侧的配置。如果超时优先检查网络策略公司网络/代理环境里需要确保把 base URL 加入放行列表同时确认终端没有残留旧的代理环境变量把请求带偏。4.4 想用本地模型或其它国内模型怎么办和 GLM 的接入原理一模一样Claude Code 不认“这是什么品牌”它只认“你的端点能不能说 Anthropic 协议”。接 LM Studio 这类本地模型时把 base URL 指向本机地址就行export ANTHROPIC_BASE_URLhttp://localhost:1234 export ANTHROPIC_AUTH_TOKENlocal export ANTHROPIC_MODEL你的本地模型名 claudeToken 随便填一个占位符因为本地服务通常不校验。但这里有个容易被忽略的坑本地模型必须支持工具调用否则 Claude Code 的 agent 流程根本走不通。模型列表里写着 Gemini 或 GPT 架构的模型不一定能直接用。实测下来能跑工具调用的 7B 以上本地模型配合 Claude Code 做简单重构还可以做复杂多文件改动就力不从心了。其它国内模型厂商的接入逻辑也一样关键是看有没有 Anthropic 兼容端点。如果没有你还可以用 one-api / new-api 这类网关把各家 API 统一转换成 Anthropic 协议然后把网关地址填进 base URL。这个思路可以让你用一个 cc switch 配置接好几家模型切换成本进一步降低。4.5 常见问题速查表我把这阵子高频遇到的问题整理成一张表方便你遇到时快速定位现象可能原因处理办法切换模型后对话不停跳闪旧会话历史与新模型配置冲突/clear退出后重开新会话不要--resume启动提示 not available in your country官方登录流程发起的区域检查确认已设置自定义 base URL auth token跳过登录API 返回 401Key 复制错误或无权限检查 Key 和套餐类型用 curl 独立验证API 返回 404base URL 协议路径错误确认填的是 Anthropic 兼容端点而不是 OpenAI 端点一直超时网络策略拦截或环境变量残留放行 base URL清理代理/网络相关环境变量claude 命令找不到npm 全局 bin 目录未在 PATHnpm prefix -g查全局目录并加入 PATHnpm 全局安装报权限错误使用了系统级 Node 目录改用 nvm 重装 Node避免 sudoAI 不执行文件操作模型不支持工具调用换支持 tool calling 的模型或服务端点最后再分享一个小技巧每次切换完模型我的习惯是先跑一条固定的探针指令比如“请列出当前目录下修改时间最近的文件并告诉我它们是什么”既能验证整体通路又能很快暴露工具调用是否失效。这比直接丢一个重构任务过去省时间得多。这套 Claude Code GLM5 Coding Plan 的组合现在是我日常的主力方案希望这份记录能帮你少走一点弯路。