最近我把 GLM 5 接进了 Claude Code直接在终端里用 Claude Code 的交互界面跑 GLM 5 的代码生成和推理。这套组合让我日常改 bug、读工程、写测试脚本的效率明显上了一个台阶最关键的是 API 成本比默认方案可控不少。所以这篇就把整个安装配置过程从头拆开讲清楚再整理 10 个我实际用下来最值得掌握的快速上手技巧。适合正在折腾 AI 编程助手、想省成本、或者想在同一套终端工作流里切换不同模型的开发者参考。我踩过不少坑才把环境彻底跑顺尤其是环境变量配置和权限管理这两块官方文档写得比较简略很多细节得自己试。这篇文章尽量把这些细节都补齐你照着抄作业就行。1. 方案解读为什么要用 Claude Code 跑 GLM 51.1 核心需求解析先说清楚这套组合是什么。Claude Code 是 Anthropic 推出的终端 AI 编程代理它跟网页版对话不一样是直接跑在你的命令行里能读你当前项目目录的文件、改代码、执行终端命令、跑 Git 操作相当于一个住在终端里的 AI 结对程序员。GLM 5 是智谱推出的新一代大模型代码生成、指令理解、长文本推理这几个方面做得相当不错而且官方开放平台提供了兼容 Anthropic 接口的接入方式所以它可以被当成 Claude Code 的后端引擎来用。为什么要把这两样凑到一起我最初的想法很简单Claude Code 的交互体验是真的好但默认绑定的模型在 API 调用上成本不低尤其是我这种整天让 AI 跑长任务、塞大上下文的重度用户。而 GLM 5 在代码场景的能力本身就很能打接入方式又兼容那我为什么不直接用 Claude Code 的壳换上 GLM 5 的心实测下来读代码、写业务逻辑、做重构这些高频操作GLM 5 都能接得住预算压力却小了很多。1.2 这套组合适合哪些人不是所有人都需要这套方案我整理了几类典型场景日常写业务代码的开发者需要 AI 帮忙快速生成胶水代码、写测试用例、查日志定位问题又不想频繁切换网页对话框。需要快速理解陌生工程的人Claude Code 可以直接读仓库GLM 5 的上下文窗口足够大一次性塞进几个核心模块没问题适合接手旧项目时做全局梳理。想省 API 成本的个人开发者GLM 5 的定价在这类模型里相对友好跑 Claude Code 工作流的成本压力小很多。做团队工具链统一的技术负责人给团队配一套统一的终端 AI 工具模型换成成本可控的 GLM 5大家的工作习惯一致也方便沉淀 prompt 和配置。当然这套方案也有门槛。第一Claude Code 依赖 Node.js 环境你得先把 Node 装好第二接入 GLM 5 需要准备好 API Key并且会涉及环境变量配置第三命令行操作对纯新手来说有一个适应期但只要把这篇文章里的步骤走一遍基本就能跑通。2. 环境准备与基础依赖2.1 先装好 Node.js 和 npmClaude Code 本身是 npm 包发布的分发方式所以 Node.js 是绕不开的依赖。很多人在这一步就卡住了主要是 Node 版本太老或者 npm 权限有问题。我强烈建议用 nvm 来管理 Node 版本而不是直接去官网下载安装包。原因很简单nvm 装的 Node 在用户目录下不需要 sudo 权限后面基本不会遇到 npm 全局安装报权限问题。macOS 和 Linux 装 nvm 用这条命令curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bashWindows 用户我没有直接推荐 nvm 原版因为它在 Windows 上的支持不完整建议用 nvm-windows或者干脆去 Node 官网下载 LTS 版本的安装包装的时候记得勾选Add to PATH。装完验证一下node -v npm -v我见过有人卡在 node 版本太低Claude Code 启动直接报错。目前建议 Node 版本至少 18 以上20 LTS 最稳。2.2 准备好 Git 和终端环境Claude Code 大量使用 Git 来做变更管理比如自动生成 commit message、查看 diff、回滚代码所以 Git 必须提前装好并配置好用户信息git --version git config --global user.name your name git config --global user.email your email终端方面macOS 直接用自带的 Terminal 或者 iTerm2 都行Windows 我更建议用 PowerShell 7 或者 Windows Terminal如果之前装了 WSL2 也可以直接在 WSL2 里操作。这里有个实际经验Windows 环境下如果遇到路径分隔符或编码问题多半是终端和系统编码的锅切到 UTF-8 编码的终端能省很多事。2.3 环境变量设置的两种方式环境变量是接入 GLM 5 的关键后面会频繁用到这里先讲清楚配置方法。临时生效的方式是在当前终端会话里执行 export关闭终端就失效适合做验证测试export ANTHROPIC_BASE_URLhttps://api.z.ai/api/anthropic export ANTHROPIC_AUTH_TOKEN你的GLM API Key持久化方式是写进 shell 配置文件macOS 和 Linux 用户写入 ~/.bashrc 或 ~/.zshrcWindows 用户可以用系统环境变量面板添加或者用 setx 命令。我建议先临时配置跑通确认无误后再持久化避免一开始写错变量污染全局环境。3. 安装 Claude Code 并用 GLM 5 驱动它3.1 三种安装方式对比Claude Code 的安装方式主要有三种我分别说下适用场景。第一种是 npm 全局安装最通用也最好管理npm install -g anthropic-ai/claude-code装完直接执行claude --version验证。如果你之前已经装过但不是最新版可以用claude update在线升级或者重新执行一次 npm 全局安装来覆盖。第二种是官方安装脚本适合不想碰 npm 的场景curl -fsSL https://claude.ai/install.sh | bash这个脚本会自动处理安装路径和可执行文件链接。我一般推荐 npm 方式因为升级和卸载都方便。第三种是直接用 npm 指定版本安装适合需要锁定版本的团队场景npm install -g anthropic-ai/claude-code版本号我实际用下来有个体会安装本身不难难的是安装完之后网络不通或者权限不对导致启动失败。所以装完第一件事就是claude --version看到版本号输出就说明基础环境没问题。3.2 获取 GLM 5 的 API Key要接 GLM 5得先去 GLM 开放平台注册账号然后在控制台里创建 API Key。这个过程比较简单但有几个细节需要注意API Key 是敏感信息别写进代码仓库也别截图发群里。创建 Key 时一般会让你选模型权限或额度按需选择即可。Key 生成后只会完整显示一次务必先复制保存好再关闭页面。不同平台的 Key 管理界面可能略有差异但核心就是拿到一串以特定前缀开头的密钥串。这串东西就是后面环境变量里 ANTHROPIC_AUTH_TOKEN 的值。关于模型标识符比如具体是glm-5还是glm-5-plus以 GLM 官方文档的最新公示为准我一般会去文档中心确认一次再写进配置。3.3 配置环境变量把 GLM 5 接到 Claude Code这是整个过程中最容易出问题的一步但原理其实很简单Claude Code 默认会把请求发到 Anthropic 的接口地址我们通过环境变量把接口地址和鉴权令牌都替换成 GLM 5 的这样 Claude Code 发的请求就会走 GLM 5 的通道。具体配置如下export ANTHROPIC_BASE_URLhttps://api.z.ai/api/anthropic export ANTHROPIC_AUTH_TOKEN你的GLM API Key export ANTHROPIC_MODELglm-5这里的 ANTHROPIC_BASE_URL 指向 GLM 提供的 Anthropic 兼容接口这个地址以官方文档为准如果后面官方调整了域名你只需要改这一行。ANTHROPIC_AUTH_TOKEN 填你刚申请的 API Key。ANTHROPIC_MODEL 用于指定模型。有些版本的 Claude Code 还支持 ANTHROPIC_SMALL_FAST_MODEL 这类环境变量来指定轻量模型用于处理标题生成等辅助任务这个也可以按需配置。配置完成后关键的一步是如果之前用 Claude Code 登录过 Anthropic 账号建议先执行claude logout退出登录再重新启动 claude。否则登录态可能会干扰环境变量的优先级导致请求还是打到默认接口上。3.4 验证配置是否真的生效配置完别急着干活先做个最小验证。在项目目录下运行claude等进入交互界面后输入一句简单的测试指令比如请简单介绍你自己并说明你当前使用的模型如果 GLM 5 接入成功它会以 GLM 的模型身份回应你。你也可以让它读一下当前目录的文件结构进一步确认文件访问能力正常。我碰到过一种情况环境变量配了启动也没报错但一问它“你是谁”它回答“我是 Claude”。这就是环境变量没生效基本是登录态干扰或者当前终端没加载新配置。解决方法是退出重开终端或者确认 claude logout 已执行。4. 10个快速上手技巧从入门到高频实战4.1 技巧1到技巧3交互方式与上下文控制技巧1文字指令用起来别当聊天框用新手最容易犯的错误是把 Claude Code 当网页聊天框一句话说完整段需求就等回复。实际上 Claude Code 在终端里的工作方式是你给它一个目标它会自动规划步骤、读取文件、执行命令。比如你想给项目加一个工具函数直接说“在 utils 目录下新增一个日期格式化函数处理 YYYY-MM-DD 和时间戳两种输入并补上测试”它就会自己去建文件、写代码、跑测试。所以指令要带上下文、带目标、带验收标准越具体越好。技巧2用 # 符号精确指定文件别让它漫无目的地扫全库Claude Code 支持用 # 加文件名的方式把某个文件直接加入上下文比如# src/utils/date.ts 这个文件里的格式化逻辑帮我重构一下保持对外接口不变这个技巧的价值在于当项目很大或者你只想让 AI 聚焦某个文件时显式指定能显著提升响应质量和速度。我自己在改一个几百个文件的老项目时如果不指定文件AI 往往会自己挑一堆不相关的文件读浪费时间也浪费上下文。指定文件后它就会集中火力处理你真正关心的地方。技巧3用 /clear 重置会话用 /compact 压缩上下文上下文窗口再大也有上限尤其是长时间对话、让 AI 读了很多文件之后上下文会被占满后续回复质量和速度都会下降。这时候有两条路/clear直接清空当前会话上下文归零适合开启一个全新任务。/compact把当前对话历史压缩成摘要保留关键信息继续当前任务的上下文。我习惯在任务切换时用 /clear在同一个大任务进行很久时用 /compact。GLM 5 的上下文窗口本身很富裕但合理的上下文管理能让它跑得更快更准。4.2 技巧4到技巧6能力模式与权限掌控技巧4需要大任务时用 Agent 模式让它自主干活Claude Code 的 Agent 模式是它最值钱的地方。在这个模式下AI 不只是回答问题而是像一个真正的工程师自己分析任务、拆解步骤、读取相关文件、修改代码、执行测试和命令直到任务完成或遇到它无法解决的问题。比如“帮我修复测试文件里所有失败的用例”它会自己去跑测试、看报错、改代码、再跑测试。在 Windows 和 Linux 环境中这个模式跑得都很顺我实际用它处理过跨多个文件的 API 迁移省了很多重复劳动。技巧5用 Plan 模式先规划再动手让 AI 先给方案后改代码Plan 模式是安全网。开启后AI 不会直接改文件或执行命令而是先分析任务输出一份详细执行计划等你确认后再进入执行环节。这个功能我基本每次都用让 AI 先给出重构方案我确认思路没问题再让它继续。遇到复杂需求时Plan 模式能避免 AI 自作主张改错代码特别是在多人协作、代码有规范约束的项目里价值非常大。你只需要在交互中输入“使用 Plan 模式”或通过相关命令切换即可。技巧6权限白名单配好工作流顺畅又安全Claude Code 执行终端命令、读写文件都需要权限默认情况下它会逐个询问你是否允许每条命令。这样最安全但频繁点确认非常打断节奏。我建议两种方式结合初次使用时耐心点逐条审批观察 AI 通常会请求哪些命令。对于可信的命令类型在配置中加入白名单让它自动执行比如文件读取、测试运行、git status 这类低风险操作。你可以通过/permissions查看和管理权限状态也可以在项目配置中的 settings 文件的 permissions 字段里维护 allow 规则。安全上有一条底线凡是删除文件、强制推送、修改全局配置这类高风险命令不要进白名单。这条经验是我实际踩过坑总结出来的有一次白名单配置太宽AI 自动执行了一个批量替换命令差点把一堆文件改坏从那以后我对白名单就保守多了。4.3 技巧7到技巧8会话状态与资源感知技巧7用 /status 看看上下文占用和资源消耗Claude Code 里输入 /status它会展示当前会话的一些状态信息包括上下文使用情况、会话时长等。这个命令的价值在于让你心里有数当前任务是不是已经让上下文接近饱和了是不是该 /compact 了长任务做到一半突然变笨先别怀疑模型能力看一眼 /status大概率是上下文快满了。技巧8用 -c 或 --continue 接着上次会话干活Claude Code 支持会话续接。你可以在启动时使用claude --continue它会自动回到最近一次会话保留之前的上下文和任务状态。这个功能特别适合跨天的任务今天让 AI 分析了一个模块并给出了修改方案第二天早上打开终端直接 --continue它还能记得昨天聊到哪继续往下干活。我推荐在 Git 分支切换不频繁的日常开发中把“中断任务后 --continue 续接”形成习惯能省掉大量重复描述上下文的时间。4.4 技巧9到技巧10工程化与自动化进阶技巧9用 Git 集成自动管理变更提交信息不用手写Claude Code 和 Git 的集成是我舍不得换掉它的核心原因之一。我在改完代码后可以直接让它生成 commit message它会看 diff、总结变更、按规范生成提交信息。还可以让它做批量操作比如把某个功能分支的多个提交整理合并或者查找某段代码的历史变更原因。实际场景我写一个底层工具库的时候连续改了七八个文件直接发指令“帮我查看所有改动、生成一个规范的 commit message不要提交只给我命令”它就把相关命令和 message 都准备好了我确认后执行效率非常高。技巧10用 hooks 配置自动化跑完工具后自动整理代码Claude Code 的 hooks 机制可以在特定事件触发后执行脚本比如在 AI 每次修改完文件后自动跑格式化工具。配置在项目根目录的.claude/settings.json里。举个例子每次修改文件后自动执行 ESLint 修复和 Prettier 格式化{ hooks: { PostToolUse: [ { matcher: Edit|Write|MultiEdit, hooks: [ { type: command, command: npx prettier --write \$CLAUDE_FILE_PATHS\ npx eslint --fix \$CLAUDE_FILE_PATHS\ } ] } ] } }这个技巧属于“配置一次长期受益”的类型。AI 写完代码格式化工具自动跟上代码风格始终保持一致省掉了代码评审时因为格式问题来回扯皮的场景。5. 常见问题与排错实录5.1 auto-update failed: no write permission to npm prefix这是搜索热词里很多人遇到的报错。原因是 Claude Code 自动更新时发现 npm 全局目录没有写权限常见于通过系统包管理器安装 Node、npm 全局目录是 /usr/lib/node_modules 这类需要 root 权限的位置。解决办法有三种改用 nvm 管理 Nodenvm 安装的 Node 全局目录在用户目录下不需要特殊权限。手动修复 npm 目录权限执行npm config get prefix查看目录然后调整目录属主但不推荐直接用 sudo chmod。忽略自动更新改为手动更新定期执行npm update -g anthropic-ai/claude-code。我实测最省心的是换成 nvm 方案彻底铲除这类权限问题。这也再次印证了第 2 章强烈推荐 nvm 的原因。5.2 启动时报 workspace 相关错误找不到 start in cowork这类报错比较少见我遇到过的场景是在某个工具目录或非项目目录下启动了 claude而当前路径没有有效的项目结构导致它无法确定起始工作区。解决办法很简单先cd到你的真实项目目录再执行 claude。检查终端当前路径里是不是有空格或特殊字符偶尔会干扰路径解析。如果是 WSL2 环境确认你进入的是 Linux 文件系统路径而不是 /mnt/c 下的 Windows 目录某些文件操作在跨文件系统时表现异常。切到 Linux 侧路径再启动通常就恢复正常了。我习惯在项目根目录专门开一个终端标签页跑 claude这样既不会污染其他终端也不会搞混工作目录。5.3 接入 GLM 5 后请求报错 401 或 404环境变量配置好后请求依然失败常见原因就三类鉴权失败、接口地址错误、模型标识错误。401API Key 不对检查有没有复制完整、有没有多余空格环境变量名拼写是否正确。404接口路径或模型名不对去 GLM 官方文档确认当前最新的 Anthropic 兼容接口地址和模型标识符。连接超时或 5xx网络到目标服务不稳定或者服务端暂时繁忙稍后重试同时确认本机网络能正常访问相关域名。我自己排错时有个习惯先用 curl 单独测一下接口连通性和鉴权有效性把问题隔离在 Claude Code 之外。curl -sSL https://api.z.ai/api/anthropic/v1/messages \ -H x-api-key: 你的GLM API Key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:glm-5,max_tokens:32,messages:[{role:user,content:ping}]}这个命令能直接看到接口返回的内容比在 Claude Code 里盲猜高效得多。5.4 Windows 环境下的编码与终端问题Windows 上跑 Claude Code我遇到最多的两类问题一是中文乱码二是终端初始位置不对。乱码基本是代码页问题把终端切成 UTF-8 编码就好chcp 65001PowerShell 7 和 Windows Terminal 默认就是 UTF-8所以优先用它们而不是老版 conhost。终端初始位置问题一般是用户目录被放在 OneDrive 下导致路径有特殊字符建议把你的项目目录放在一个纯净的路径下比如 D:\Projects不要放在桌面或者带空格的长路径里能省掉很多不必要的麻烦。5.5 常见错误速查表我整理了这份排查表覆盖平时在社区和实操里遇到的高频问题方便快速对照报错或现象核心原因推荐解法auto-update failed: no write permissionnpm 全局目录无写权限改用 nvm 管理 Node找不到起始工作区启动失败当前目录不是有效项目路径cd 到项目根目录再启动请求返回 401API Key 错误或环境变量未生效核对 Key 和环境变量curl 单测接口请求返回 404接口地址或模型标识错误查官方文档更新配置中文乱码终端编码非 UTF-8执行 chcp 65001问了模型是谁回答说 Claude登录态或环境变量优先级被干扰claude logout 后重开终端再启动长任务做到一半变慢变笨上下文接近上限用 /compact 压缩上下文6. 最后再分享一点个人体会这套“Claude Code GLM 5”组合我实际跑了挺长时间最大的感受是工具链的价值不在于哪个模型最强而在于你能否把它的能力稳定地用到日常流程里。默认的 Claude 模型很强但成本在那里摆着GLM 5 在代码场景的表现完全配得上“平替”甚至在某些场景里更好接入 Claude Code 后整个开发闭环的体感非常顺滑——读代码、改代码、跑测试、生成 commit全在终端里完成不用来回切换窗口。踩过几次坑之后我个人的建议是第一次配置务必走完“最小闭环”也就是 Node 环境验证、CLI 安装验证、环境变量配置、curl 接口验证、启动 claude 测试对话这五步都通过再开始干大活能让你后续少掉很多头发。还有一个实用技巧在项目根目录维护一份.claude/settings.json把常用的权限白名单、hooks 自动格式化配置固定下来换项目或换机器时直接复制过去就能保持一致的体验这是我在多台设备之间切换时总结出的最大便利。希望这篇能帮你把环境搭顺空出的精力多花在代码本身。