尧图网站建设 
1. 为什么我把主力AI编程工具换成了 Claude Code GLM 5如果你平时用 Cursor、GitHub Copilot 或者 Windsurf 写代码一定遇到过这类窘境改完一个函数IDE 卡了半天让它重构代码它东改一处西改一处最后编译都过不了问到冷门框架的 API 用法回答总是参考文档第X页这种正确的废话。这就是我转向 Claude Code 的核心原因。Claude Code 是 Anthropic 官方的终端 AI 编程代理你直接在命令行里敲claude它就能读你的整个项目、理解上下文、修改文件、执行命令、提交 Git完全不用鼠标在 IDE 界面里点来点去。它擅长的恰恰是那些需要全局理解的任务跨文件重构、追查 bug 的根因、理解一堆古老代码再帮你现代化。用久了你会发现这种把工具当同事的工作方式效率上限远高于把工具当高级补全器。但我没直接用官方的 Claude 模型而是把后端换成了 GLM 5。原因很实际GLM 5 的代码生成与推理能力已经站在第一梯队API 价格比海外主流模型便宜一个量级而且 GLM 在国内模型的上下文理解和中文指令遵循上做得相当稳尤其适合处理中文注释多、命名随意、没有文档的历史项目。这套搭配下来我日常编码的开销大概是原来的零头体验却没有明显倒退——某些场景下甚至觉得 GLM 5 的代码风格更干净。这篇内容我会把从零开始的完整安装、GLM 5 接入的核心配置、最常见的报错排查以及我自己用了两个多月整理出的 10 个高频技巧一次讲透。不管你是想尝鲜的初学者还是打算把它引入团队工作流的老手照着做就能用。2. 安装前的环境准备先把脚下的地基打牢2.1 Node.js 版本选择与安装Claude Code 本质是一个通过 npm 分发的 Node.js 命令行工具所以第一步是把 Node.js 装好。很多人在这一步就卡住了——不是没装是版本不对。Claude Code 官方要求 Node.js 18 以上我实测下来 18.17 和 20.x 是最稳的区间22.x 也可以但你机器上如果还留着 16 或更老的版本别指望升级后一切顺畅有些全局依赖会和新版本打架。Windows 用户建议用 nvm-windows 来管理 Node 版本而不是直接去官网下载安装包。为什么因为后面你很可能需要在多个 Node 版本之间来回切换比如有些老项目需要 Node 16nvm 能一键切换省去反复卸载安装的麻烦。macOS 或 Linux 用户可以用 nvm 原版同样道理。装完之后在终端里分别执行node -v npm -v能看到版本号输出说明 Node 和 npm 都已经就位了。如果提示node 不是内部或外部命令Windows或 command not foundmacOS/Linux优先检查环境变量。这里必须提醒一句如果你之前在系统里装过其他 AI 命令行工具先检查一下它们的 Node 依赖有没有冲突。我遇到过的情况是全局装了很多包之后npm 的全局目录里出现版本错乱导致 Claude Code 启动时加载模块报错。干净的环境能省掉后续一半的麻烦。2.2 Git 安装与基础配置Claude Code 和 Git 的绑定非常深。它读 Git 历史来判断你改了哪些文件、自动生成 commit message、帮你做代码审查这些都依赖一个正常工作且配置了用户信息的 Git。没有 GitClaude Code 虽然能启动但很多核心功能会变成摆设。Windows 用户装 Git for Windows一路默认选项注意调整 PATH 环境变量那一步选 Git from the command line and also from 3rd-party software这样后面在 PowerShell 和 CMD 里都能直接调git命令。macOS 用户建议用brew install git别用自带的旧版。Linux 用户用发行版自带的包管理器装就行。装完以后在终端里设置全局用户信息git config --global user.name 你的名字 git config --global user.email 你的邮箱这两行不设置后面 Claude Code 帮你提交代码时会报错而且报错信息不太直观会绕一大圈才让你发现问题出在 Git 配置上。2.3 Windows 用户的 WSL2 环境建议如果你是 Windows 主力机我强烈建议你把 Claude Code 装进 WSL2。这不是折腾而是体验差异的问题。Claude Code 在 Linux 环境下的路径处理、文件监听、权限模型都更顺滑尤其当你项目里有一些 shell 脚本或者需要调用 Linux 命令的时候WSL2 里跑起来几乎不会遇到环境不对的尴尬。我自己的使用习惯是项目代码放在 WSL2 的 Linux 文件系统里即~/projects这种路径而不是放在/mnt/c/...下。放 Windows 盘符下虽然能访问但跨文件系统的文件读写性能有明显损耗Claude Code 要频繁读取项目文件这种损耗会被放大。如果还没装 WSL2管理员权限打开 PowerShell 执行wsl --install装完以后进入 WSL 终端在里面同样把 Node.js、Git 装好然后直接走下一节的安装步骤。这样你得到的是一套完全类 Linux 的开发环境后面配置 GLM 5 的时候环境变量的设置逻辑也更清晰。3. Claude Code 本体安装与 GLM 5 接入配置3.1 通过 npm 安装 Claude Code环境就绪后安装过程本身相当简单一条命令搞定npm install -g anthropic-ai/claude-code等待安装结束然后验证版本claude --version如果能看到类似 1.x.x 的版本号输出说明安装成功。这里出现概率最高的问题有两个一个是权限不够导致安装失败另一个是安装完了但claude命令找不到。前者通常是 macOS/Linux 上用系统 Node 装的权限问题后者多半是 npm 全局目录没在 PATH 里。这两个问题的具体解法我在后面第 5 节的报错排查里单独写因为那部分值得展开讲。安装完成后先别急着用因为默认的 Claude Code 启动后会去连官方 API而你大概率没有官方账号或不想为此付费。我们这一步的目标是把它指向 GLM 5。3.2 获取 GLM 5 的 API Key在配置之前你需要先去 GLM 的开放平台注册账号创建一个 API Key。这个 Key 是你调用 GLM 5 模型的凭证格式一般是一串以特定前缀开头的字符串。创建之后注意保存好它只在创建时完整显示一次丢了就得重新生成。如果你是在团队里使用建议让一个人创建 Key 然后统一分发不要让每个人各自注册、各自开通否则后续账单和权限管理会很混乱。3.3 环境变量配置把 Claude Code 指向 GLM 5Claude Code 支持通过两个环境变量来改写模型服务地址和密钥ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN。前者告诉 Claude Code 把请求发到哪里后者则是鉴权用的密钥。GLM 5 提供了兼容 Anthropic 协议的接口地址所以这两行配置就是整个接入过程的核心。macOS / Linux 在~/.bashrc或~/.zshrc中追加export ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic export ANTHROPIC_AUTH_TOKEN你的GLM_API_KEYWindows 用户在 PowerShell 里通过用户环境变量设置或者直接在系统设置里加这两个同名变量。设置完记得重启终端让它生效。这里解释一下原理Claude Code 原生使用 Anthropic 的消息协议与工具调用协议。GLM 5 对外开放了兼容这套协议的接口也就是说你不需要改 Claude Code 的任何代码它以为自己在跟官方 API 对话实际上请求被转发到了 GLM 的服务器。这也是这类模型后端替换方案普遍采用的做法。3.4 验证连通性首次启动 Claude Code完成上面的配置后在项目目录下运行claude正常启动后你会看到交互式界面的提示Claude Code 会加载当前目录的信息然后等你输入指令。这时候先不要急着让它写代码建议先发一条简单指令验证整个链路请说明你当前使用的模型名称然后输出一句连接成功。如果回应里能正确识别模型信息说明 Claude Code 和 GLM 5 的链路已经通了。如果它卡住、报错或者提示鉴权失败按第 5 节的排查清单来。有一点要认清Claude Code 的界面和支持的工具函数非常多默认情况下首次进入会有一堆初始化提示这是正常的。不要在这里选择用官方账号登录或绑定 Anthropic 账号因为你要走的是环境变量配置这条路登录反而会把配置搞乱。4. 用 CLAUDE.md 给项目建立记忆档案4.1 为什么 CLAUDE.md 是配置的重中之重很多人配置完模型接入后直接就开始让 Claude Code 干活然后很快发现一个问题它对项目的理解非常浅动不动给出跟现有代码风格完全不符的答案。这不是模型能力不行而是你少做了关键的初始化工作。Claude Code 自带一个机制它在启动时自动读取项目根目录下的CLAUDE.md文件把它当作关于这个项目的常识来理解。你可以在这份文件里写清楚项目的技术栈、目录结构、命名规范、注意事项。写完以后它每次进入项目都会先读这份文件相当于你给 AI 同事递了一份入职手册。我给它取了个名字叫AI 员工的入职文档这个比喻很贴切。你招了个新人第一天肯定要告诉他咱们用 Go 写后端、数据库连接串放哪、代码风格是驼峰还是下划线、哪块代码千万别动。这些信息写下来新人才能少犯错。Claude Code 也是一样你没给的信息它只能瞎猜。4.2 CLAUDE.md 应该包含哪些内容一份称职的 CLAUDE.md至少要覆盖这几类信息项目一句话简介以及当前的关键技术栈语言、框架、主要依赖代码目录结构特别是核心模块和容易混淆的目录说明每个目录的职责代码风格约定比如缩进、命名规范、注释语言中文还是英文、异常处理方式构建与测试命令告诉它用哪个命令跑测试、哪个命令打包禁忌事项比如不要改动 xxx 目录下的自动生成代码不要在 service 层写 SQL举个例子一个小型 Go 后端项目的 CLAUDE.md 可能长这样# 项目简介 用户积分系统后端服务提供积分发放、消费、流水查询接口。 ## 技术栈 - Go 1.21 Gin 框架 - MySQL 8.0 GORM - Redis 用于热点数据缓存 ## 目录说明 - cmd/ 启动入口 - internal/handler/ HTTP 层只做参数绑定和响应输出 - internal/service/ 业务逻辑层所有业务规则放这里 - internal/repository/ 数据访问层禁止直接写 SQL ## 命令 - 本地启动go run main.go - 跑测试go test ./... -v ## 注意 - 所有接口返回统一 JSON 格式 - 时间字段一律用时间戳不用字符串 - 禁止在 handler 中直接操作数据库这份文件看起来简单但它能显著提升 Claude Code 后续所有任务的准确率。你给出的指令越有上下文它就越不需要靠猜测补全信息出错的概率自然就下来了。4.3 让 Claude Code 自动生成 CLAUDE.md你没看错这份入职文档可以让 Claude Code 自己写。在项目根目录启动claude后输入/init它会自动扫描项目结构、读取关键配置、分析代码组织方式然后生成一份初步的 CLAUDE.md。生成之后自己过一遍把不适合的内容删掉把遗漏的细节补上这份文件就是你与工具之间最重要的桥梁。我个人的习惯是每接手一个老项目时先跑一次/init然后在生成的基础上手动增补那些只有人知道的信息——比如某些看似死代码其实不能删、某些接口有历史兼容包袱、某个服务依赖外部系统的时效性。这些隐性知识写进 CLAUDE.md作用比任何配置都大。5. 常见安装与配置报错排查实录以下是我在安装和使用过程中真实遇到过的问题也是这个工具群里被问得最多的几类整理成速查表方便你按图索骥。报错现象根本原因解决方案安装时报 npm ERR! code EACCES全局目录无写权限用 nvm 管理的 Node或 chown 目录权限运行 claude 提示 command not foundnpm 全局目录不在 PATH找到全局 bin 目录并加入 PATH重启终端auto-update failed: no write permission to npm prefix自动更新无权限修复 npm 全局目录写权限或手动升级启动后提示 authentication / unauthorizedAPI Key 错误或环境变量未生效核对 Key确认变量已加载重启终端对话时提示 connection / timeout网络无法访问模型接口确认服务地址可达检查网络连通性找不到 start in cowork on 3 p类似进程级报错残留进程或目录状态异常清掉残留进程检查辅助进程配置后重启5.1 npm 全局目录权限问题这个问题最常见的触发场景是用系统自带的 Node 直接全局安装默认装的路径是/usr/lib/node_modules这类系统级目录当前用户没有写权限。于是在 Windows 上报 EPERM在 macOS/Linux 上报 EACCES。我给你的建议是别去 chmod 系统目录因为治标不治本还容易搞坏其他东西。正确做法是先卸载干净改走 nvm 或 nvm-windows 安装 Node让 npm 全局目录落在用户目录下权限问题直接消失。如果你已经在用 nvm 还是遇到权限问题执行npm config get prefix看输出路径如果它指向系统目录说明 nvm 的默认配置没生效。重新安装一遍 nvm 环境或者手动把 prefix 改到用户目录npm config set prefix ~/.npm-global然后把~/.npm-global/bin加入 PATH。5.2 claude 命令找不到能安装成功但找不到命令多半是 npm 全局 bin 目录没在 PATH 里。macOS/Linux 上先执行npm prefix -g拿到全局路径后把它的bin子目录加进 shell 配置文件。Windows 上则是检查%APPDATA%\npm是否在系统环境变量的 PATH 里不在就手动添加然后重启终端。这里有个容易被忽视的细节PATH 修改后当前已经打开的终端窗口不会自动生效。我见过不少人改了 PATH 还继续在旧窗口里测试怎么测都是 command not found其实关掉重开就好了。5.3 auto-update failed 的处理Claude Code 启动时会检查更新如果它没有 npm 目录的写权限就会报出 auto-update failed: no write permission to npm prefix。这个问题尤其在 Windows 非管理员终端、或者 Linux 系统 Node 下高发。解决方案分两种一是从权限根源上解决把 npm 全局目录的写权限交给当前用户二是偷懒直接关闭自动更新需要升级时手动执行npm install -g anthropic-ai/claude-code。第二种方案更稳妥尤其适合经常在多个环境间切换的开发者。5.4 环境变量已设置但请求仍报鉴权错误这个排查要点我单独列出来因为特别容易踩。如果你在 Windows 上通过系统属性 - 环境变量添加了ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN但启动 Claude Code 仍然报 unauthorized先执行echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN如果输出为空说明你当前终端根本没加载新的环境变量重启终端再试。如果输出有值但还是鉴权失败那大概率是 Key 本身的问题——注意检查有没有把 Key 复制完整有没有多余的换行或空格。6. 10 个快速上手技巧用对时间直接翻倍6.1 用/init给项目建档别裸奔开工前面已经详细说了/init的作用这里单独再强调一次无论新项目还是老项目首次接入手动加载 CLAUDE.md 之后第一件事就是初始化。我见过太多人跳过这一步直接开工结果 AI 写的代码跟项目风格牛头不对马嘴返工的成本比初始化高十倍。花两分钟建立档案是最值得的投资。6.2 不做无谓的操作确认用权限白名单跑自动化Claude Code 默认为了安全执行文件修改或命令前会先征求你同意。这在探索阶段没问题但如果你已经明确信任当前任务每次弹确认窗口反而是效率杀手。启动时加参数--dangerously-skip-permissions可以跳过所有确认但这个名字也提示了危险属性。更稳的做法是在交互界面里输入/permissions配置白名单允许它对特定目录做修改、对特定命令直接执行其余操作仍然需要确认。我现在的配置是允许它在/workspace/project-a下直接改文件但禁止它执行rm -rf这类危险命令。平衡好安全与效率这才是长期可用的姿势。6.3 用文件路径精确指定上下文不做大锅烩Claude Code 会根据你的指令自动判断需要看哪些文件但它的判断不见得准确。一个技巧是在对话中明确用符号引用文件比如internal/service/order.go 帮我找出这里所有对数据库状态字段的直接赋值改成通过 OrderState 枚举的 SetState 方法这样它就会优先精读这个文件而不是把整个项目都塞进上下文。上下文越精准答案越准确同时 token 消耗也更少。这套上下文管理的意识越早建立越好。6.4 让子代理并行干活把长任务拆出去Claude Code 支持创建一个子代理让它自主处理一个完整子任务而你继续和主代理对话。这个能力在处理又要重构 A 模块又要改 B 模块测试这类多线任务时非常有用。实际操作中我会让主代理先拆任务然后明确说这部分独立模块交给子代理完成完成后汇总。子代理的执行结果会以摘要形式返回主代理根据结果继续推进。用这个功能的时候注意一点子代理适合边界清晰、依赖少的任务如果任务之间耦合度高强行并行反而增加返工。6.5 用/compact压缩长篇对话保住上下文窗口长时间对话后上下文会越积越多token 消耗越来越大响应也可能越来越慢。这时候可以用/compact把之前的对话摘要化压缩出空间给后续任务。它本质是拿摘要丢失细节换继续干活的能力所以压缩前最好确认当前任务的关键信息已经固化在项目文件里而不是只存在于聊天记录中。6.6/clear开新会话区别临时提问和正式任务如果你只是随手问一个语法问题或查一个函数签名不需要让 Claude Code 记忆项目上下文直接在当前对话里问就行。但如果是开启一项新任务我建议/clear开干净会话再开始。为什么因为旧对话的上下文会干扰它的思路可能把上一个任务的错误模式带进来。每次新任务都从干净状态开始准确性明显更高。6.7 让它生成 Git 提交不是替你写代码Claude Code 的代码修改能力很强但我用得最多的反而是一个轻量功能自动生成 commit message。项目改动完成后执行为当前的改动生成一条规范的 Git commit message它会自动读取git diff分析改动内容生成符合 Conventional Commits 风格的提交信息。这件事看着小但作用不小——它逼着你每次提交前重新审视自己的改动同时省掉了写提交信息的纠结时间。6.8 用/review做代码审查多一个不疲倦的评审员写代码的人自己检查自己的代码总有盲区。Claude Code 的/review会基于 Git 对比范围分析改动中的潜在问题边界条件、错误处理、重复代码、安全风险等。它的审查质量未必能替代资深同事的 code review但作为提交前的第一道自动检查能帮你挡掉相当一部分低级错误。我通常在写完一个功能后跑一次 review把发现的问题修完再提交。这个习惯让我 merge request 的被驳回率降了一大截。6.9 用 harness 模式免登录随时切换后端模型Claude Code 支持 harness 模式可以在不登录 Anthropic 账号的情况下通过环境变量直接对接第三方模型服务。这个能力让我能在 GLM 5、DeepSeek、以及其他兼容模型之间来回切换而不需要安装多套工具。具体做法是在环境变量中动态切换ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN的值或者在项目目录下放一个 .env 文件按项目加载。这样不同项目可以用不同模型后端价格和效果的差异化配置就变得很灵活。6.10 用多目录并行让模型服务不同仓库Claude Code 不是只能在一个目录里运行。你可以在终端里开多个标签页每个标签页进入不同项目目录各跑一个claude实例。它们之间互不干扰你可以同时维护两个项目的开发任务。这个技巧配合 sub-agent 尤其好用一个终端窗口处理项目 A 的主开发流另一个终端窗口跑项目 B 的代码审查。只要你的机器内存够这种多线程工作流能让人工智能同时服务多个上下文对自由职业者或维护多项目的人来说是效率神器。7. 实践经验与配置建议7.1 我的推荐配置项目级环境变量优先在配置后端模型这件事上我不建议把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN写死在系统环境变量里因为一旦你想在另一个项目里换一个模型就得改全局配置再重启终端。更好的方案是利用 Claude Code 对项目级配置的支持。在项目根目录创建.env文件写入ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic ANTHROPIC_AUTH_TOKEN你的GLM_API_KEY这样每个项目都可以有自己独立的模型配置。需要切换后端时只需要改对应项目的.env文件不影响全局环境。7.2 合理的 token 消耗控制用 GLM 5 虽然便宜但不代表可以随意挥霍 token。Claude Code 默认会加载大量项目文件到上下文项目一大token 消耗会肉眼可见地涨。我的控制手段有三个在 CLAUDE.md 里明确写不需要读取哪些目录比如node_modules、构建产物、日志目录避免上下文被无用文件填满任务描述精确到文件和函数而不是泛泛说优化这个项目的性能必要的时候用/compact压缩对话而不是任由上下文无限膨胀这套组合用下来我的月度 API 开销比原来用纯官方模型低了大概 90%效果上对齐度没让人失望。这个数字因人而异但方向是确定的工具本身省不省钱取决于你怎么用它。7.3 版本升级策略别追新但别太旧Claude Code 的迭代速度相当快几乎每周都有新版本。我的建议是别每次都第一时间升到最新版但也不要放任版本长期不升。比较合理的节奏是每个月手动升一次或者看到官方公告里有新功能明确能提升你工作流时再升级。升级命令很简单npm update -g anthropic-ai/claude-code升级后如果出现配置失效或行为变化先查 release notes一般都是环境变量或权限模型有了调整。自己之前写的 CLAUDE.md 和配置文件通常不需要改动但要留意新版本是否引入了更严格的默认权限。8. 最后再分享三个让我回不去的进阶场景8.1 老项目重构把考古交给 AI接手一个五年没动的老项目最痛苦的是理解它当初为什么这么写。以前我的做法是一边摸代码一边吐槽命名一整天下来连模块之间的关系都没理清。现在我的做法是让 Claude Code 先扫描整个项目生成架构说明和数据流梳理然后基于这些信息逐步推进重构。CLAUDE.md 在这个场景下价值巨大。我把从代码里挖出来的历史包袱、隐性约定全部写进去相当于给这份考古报告建了索引。后续每次改动它都能参考这份档案不会再犯用新架构强行套老代码的错误。重构这种事最难的不是写代码而是摸清哪些是设计、哪些是妥协、哪些是陈年 bug 但删了会崩的边界。AI 工具在这个场景里是真正的神队友。8.2 与团队共享工具配置如果你在一个小团队里用这套方案建议把 CLAUDE.md 和 .env 的模板纳入代码库的 docs 目录让每个成员初始化项目时都能快速拉起同一个助手环境。有三件事要列清楚CLAUDE.md 里写了哪些约定、.env 里的变量模板是什么、遇到权限问题该找谁处理。这样团队里的每个人都能在同一个 AI 助手的加持下工作风格一致性反而提高了。8.3 把它当编程伙伴而不是代码生成器最后这点算是我个人的价值观建议。Claude Code 这类工具最大的价值不是帮你把一段描述变成代码而是陪你把一个复杂问题拆解清楚、找到正确的实现路径。当我让它改一块逻辑时我会先跟它讨论方案取舍当我让它排查 bug 时我会让它先输出推理过程再动手。这个习惯让代码质量和可维护性都上了一个台阶也让这个工具真正成了我的搭档而不是一台输出机。从装好第一版到现在我在这个组合上投入的时间已经收到了非常明显的回报不只是省了钱更重要的是那些本来要花一整晚的繁琐改动现在半小时就能收尾。如果你正打算把 Claude Code 接入自己的项目我的建议很简单照着前面的步骤把环境搭起来然后用 CLAUDE.md 好好跟你的新同事做一次上岗培训剩下的就是让它陪你写第一段代码了。 Claude Code + GLM 5 接入指南：从环境配置到高效编码技巧
1. 为什么我把主力AI编程工具换成了 Claude Code GLM 5如果你平时用 Cursor、GitHub Copilot 或者 Windsurf 写代码一定遇到过这类窘境改完一个函数IDE 卡了半天让它重构代码它东改一处西改一处最后编译都过不了问到冷门框架的 API 用法回答总是参考文档第X页这种正确的废话。这就是我转向 Claude Code 的核心原因。Claude Code 是 Anthropic 官方的终端 AI 编程代理你直接在命令行里敲claude它就能读你的整个项目、理解上下文、修改文件、执行命令、提交 Git完全不用鼠标在 IDE 界面里点来点去。它擅长的恰恰是那些需要全局理解的任务跨文件重构、追查 bug 的根因、理解一堆古老代码再帮你现代化。用久了你会发现这种把工具当同事的工作方式效率上限远高于把工具当高级补全器。但我没直接用官方的 Claude 模型而是把后端换成了 GLM 5。原因很实际GLM 5 的代码生成与推理能力已经站在第一梯队API 价格比海外主流模型便宜一个量级而且 GLM 在国内模型的上下文理解和中文指令遵循上做得相当稳尤其适合处理中文注释多、命名随意、没有文档的历史项目。这套搭配下来我日常编码的开销大概是原来的零头体验却没有明显倒退——某些场景下甚至觉得 GLM 5 的代码风格更干净。这篇内容我会把从零开始的完整安装、GLM 5 接入的核心配置、最常见的报错排查以及我自己用了两个多月整理出的 10 个高频技巧一次讲透。不管你是想尝鲜的初学者还是打算把它引入团队工作流的老手照着做就能用。2. 安装前的环境准备先把脚下的地基打牢2.1 Node.js 版本选择与安装Claude Code 本质是一个通过 npm 分发的 Node.js 命令行工具所以第一步是把 Node.js 装好。很多人在这一步就卡住了——不是没装是版本不对。Claude Code 官方要求 Node.js 18 以上我实测下来 18.17 和 20.x 是最稳的区间22.x 也可以但你机器上如果还留着 16 或更老的版本别指望升级后一切顺畅有些全局依赖会和新版本打架。Windows 用户建议用 nvm-windows 来管理 Node 版本而不是直接去官网下载安装包。为什么因为后面你很可能需要在多个 Node 版本之间来回切换比如有些老项目需要 Node 16nvm 能一键切换省去反复卸载安装的麻烦。macOS 或 Linux 用户可以用 nvm 原版同样道理。装完之后在终端里分别执行node -v npm -v能看到版本号输出说明 Node 和 npm 都已经就位了。如果提示node 不是内部或外部命令Windows或 command not foundmacOS/Linux优先检查环境变量。这里必须提醒一句如果你之前在系统里装过其他 AI 命令行工具先检查一下它们的 Node 依赖有没有冲突。我遇到过的情况是全局装了很多包之后npm 的全局目录里出现版本错乱导致 Claude Code 启动时加载模块报错。干净的环境能省掉后续一半的麻烦。2.2 Git 安装与基础配置Claude Code 和 Git 的绑定非常深。它读 Git 历史来判断你改了哪些文件、自动生成 commit message、帮你做代码审查这些都依赖一个正常工作且配置了用户信息的 Git。没有 GitClaude Code 虽然能启动但很多核心功能会变成摆设。Windows 用户装 Git for Windows一路默认选项注意调整 PATH 环境变量那一步选 Git from the command line and also from 3rd-party software这样后面在 PowerShell 和 CMD 里都能直接调git命令。macOS 用户建议用brew install git别用自带的旧版。Linux 用户用发行版自带的包管理器装就行。装完以后在终端里设置全局用户信息git config --global user.name 你的名字 git config --global user.email 你的邮箱这两行不设置后面 Claude Code 帮你提交代码时会报错而且报错信息不太直观会绕一大圈才让你发现问题出在 Git 配置上。2.3 Windows 用户的 WSL2 环境建议如果你是 Windows 主力机我强烈建议你把 Claude Code 装进 WSL2。这不是折腾而是体验差异的问题。Claude Code 在 Linux 环境下的路径处理、文件监听、权限模型都更顺滑尤其当你项目里有一些 shell 脚本或者需要调用 Linux 命令的时候WSL2 里跑起来几乎不会遇到环境不对的尴尬。我自己的使用习惯是项目代码放在 WSL2 的 Linux 文件系统里即~/projects这种路径而不是放在/mnt/c/...下。放 Windows 盘符下虽然能访问但跨文件系统的文件读写性能有明显损耗Claude Code 要频繁读取项目文件这种损耗会被放大。如果还没装 WSL2管理员权限打开 PowerShell 执行wsl --install装完以后进入 WSL 终端在里面同样把 Node.js、Git 装好然后直接走下一节的安装步骤。这样你得到的是一套完全类 Linux 的开发环境后面配置 GLM 5 的时候环境变量的设置逻辑也更清晰。3. Claude Code 本体安装与 GLM 5 接入配置3.1 通过 npm 安装 Claude Code环境就绪后安装过程本身相当简单一条命令搞定npm install -g anthropic-ai/claude-code等待安装结束然后验证版本claude --version如果能看到类似 1.x.x 的版本号输出说明安装成功。这里出现概率最高的问题有两个一个是权限不够导致安装失败另一个是安装完了但claude命令找不到。前者通常是 macOS/Linux 上用系统 Node 装的权限问题后者多半是 npm 全局目录没在 PATH 里。这两个问题的具体解法我在后面第 5 节的报错排查里单独写因为那部分值得展开讲。安装完成后先别急着用因为默认的 Claude Code 启动后会去连官方 API而你大概率没有官方账号或不想为此付费。我们这一步的目标是把它指向 GLM 5。3.2 获取 GLM 5 的 API Key在配置之前你需要先去 GLM 的开放平台注册账号创建一个 API Key。这个 Key 是你调用 GLM 5 模型的凭证格式一般是一串以特定前缀开头的字符串。创建之后注意保存好它只在创建时完整显示一次丢了就得重新生成。如果你是在团队里使用建议让一个人创建 Key 然后统一分发不要让每个人各自注册、各自开通否则后续账单和权限管理会很混乱。3.3 环境变量配置把 Claude Code 指向 GLM 5Claude Code 支持通过两个环境变量来改写模型服务地址和密钥ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN。前者告诉 Claude Code 把请求发到哪里后者则是鉴权用的密钥。GLM 5 提供了兼容 Anthropic 协议的接口地址所以这两行配置就是整个接入过程的核心。macOS / Linux 在~/.bashrc或~/.zshrc中追加export ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic export ANTHROPIC_AUTH_TOKEN你的GLM_API_KEYWindows 用户在 PowerShell 里通过用户环境变量设置或者直接在系统设置里加这两个同名变量。设置完记得重启终端让它生效。这里解释一下原理Claude Code 原生使用 Anthropic 的消息协议与工具调用协议。GLM 5 对外开放了兼容这套协议的接口也就是说你不需要改 Claude Code 的任何代码它以为自己在跟官方 API 对话实际上请求被转发到了 GLM 的服务器。这也是这类模型后端替换方案普遍采用的做法。3.4 验证连通性首次启动 Claude Code完成上面的配置后在项目目录下运行claude正常启动后你会看到交互式界面的提示Claude Code 会加载当前目录的信息然后等你输入指令。这时候先不要急着让它写代码建议先发一条简单指令验证整个链路请说明你当前使用的模型名称然后输出一句连接成功。如果回应里能正确识别模型信息说明 Claude Code 和 GLM 5 的链路已经通了。如果它卡住、报错或者提示鉴权失败按第 5 节的排查清单来。有一点要认清Claude Code 的界面和支持的工具函数非常多默认情况下首次进入会有一堆初始化提示这是正常的。不要在这里选择用官方账号登录或绑定 Anthropic 账号因为你要走的是环境变量配置这条路登录反而会把配置搞乱。4. 用 CLAUDE.md 给项目建立记忆档案4.1 为什么 CLAUDE.md 是配置的重中之重很多人配置完模型接入后直接就开始让 Claude Code 干活然后很快发现一个问题它对项目的理解非常浅动不动给出跟现有代码风格完全不符的答案。这不是模型能力不行而是你少做了关键的初始化工作。Claude Code 自带一个机制它在启动时自动读取项目根目录下的CLAUDE.md文件把它当作关于这个项目的常识来理解。你可以在这份文件里写清楚项目的技术栈、目录结构、命名规范、注意事项。写完以后它每次进入项目都会先读这份文件相当于你给 AI 同事递了一份入职手册。我给它取了个名字叫AI 员工的入职文档这个比喻很贴切。你招了个新人第一天肯定要告诉他咱们用 Go 写后端、数据库连接串放哪、代码风格是驼峰还是下划线、哪块代码千万别动。这些信息写下来新人才能少犯错。Claude Code 也是一样你没给的信息它只能瞎猜。4.2 CLAUDE.md 应该包含哪些内容一份称职的 CLAUDE.md至少要覆盖这几类信息项目一句话简介以及当前的关键技术栈语言、框架、主要依赖代码目录结构特别是核心模块和容易混淆的目录说明每个目录的职责代码风格约定比如缩进、命名规范、注释语言中文还是英文、异常处理方式构建与测试命令告诉它用哪个命令跑测试、哪个命令打包禁忌事项比如不要改动 xxx 目录下的自动生成代码不要在 service 层写 SQL举个例子一个小型 Go 后端项目的 CLAUDE.md 可能长这样# 项目简介 用户积分系统后端服务提供积分发放、消费、流水查询接口。 ## 技术栈 - Go 1.21 Gin 框架 - MySQL 8.0 GORM - Redis 用于热点数据缓存 ## 目录说明 - cmd/ 启动入口 - internal/handler/ HTTP 层只做参数绑定和响应输出 - internal/service/ 业务逻辑层所有业务规则放这里 - internal/repository/ 数据访问层禁止直接写 SQL ## 命令 - 本地启动go run main.go - 跑测试go test ./... -v ## 注意 - 所有接口返回统一 JSON 格式 - 时间字段一律用时间戳不用字符串 - 禁止在 handler 中直接操作数据库这份文件看起来简单但它能显著提升 Claude Code 后续所有任务的准确率。你给出的指令越有上下文它就越不需要靠猜测补全信息出错的概率自然就下来了。4.3 让 Claude Code 自动生成 CLAUDE.md你没看错这份入职文档可以让 Claude Code 自己写。在项目根目录启动claude后输入/init它会自动扫描项目结构、读取关键配置、分析代码组织方式然后生成一份初步的 CLAUDE.md。生成之后自己过一遍把不适合的内容删掉把遗漏的细节补上这份文件就是你与工具之间最重要的桥梁。我个人的习惯是每接手一个老项目时先跑一次/init然后在生成的基础上手动增补那些只有人知道的信息——比如某些看似死代码其实不能删、某些接口有历史兼容包袱、某个服务依赖外部系统的时效性。这些隐性知识写进 CLAUDE.md作用比任何配置都大。5. 常见安装与配置报错排查实录以下是我在安装和使用过程中真实遇到过的问题也是这个工具群里被问得最多的几类整理成速查表方便你按图索骥。报错现象根本原因解决方案安装时报 npm ERR! code EACCES全局目录无写权限用 nvm 管理的 Node或 chown 目录权限运行 claude 提示 command not foundnpm 全局目录不在 PATH找到全局 bin 目录并加入 PATH重启终端auto-update failed: no write permission to npm prefix自动更新无权限修复 npm 全局目录写权限或手动升级启动后提示 authentication / unauthorizedAPI Key 错误或环境变量未生效核对 Key确认变量已加载重启终端对话时提示 connection / timeout网络无法访问模型接口确认服务地址可达检查网络连通性找不到 start in cowork on 3 p类似进程级报错残留进程或目录状态异常清掉残留进程检查辅助进程配置后重启5.1 npm 全局目录权限问题这个问题最常见的触发场景是用系统自带的 Node 直接全局安装默认装的路径是/usr/lib/node_modules这类系统级目录当前用户没有写权限。于是在 Windows 上报 EPERM在 macOS/Linux 上报 EACCES。我给你的建议是别去 chmod 系统目录因为治标不治本还容易搞坏其他东西。正确做法是先卸载干净改走 nvm 或 nvm-windows 安装 Node让 npm 全局目录落在用户目录下权限问题直接消失。如果你已经在用 nvm 还是遇到权限问题执行npm config get prefix看输出路径如果它指向系统目录说明 nvm 的默认配置没生效。重新安装一遍 nvm 环境或者手动把 prefix 改到用户目录npm config set prefix ~/.npm-global然后把~/.npm-global/bin加入 PATH。5.2 claude 命令找不到能安装成功但找不到命令多半是 npm 全局 bin 目录没在 PATH 里。macOS/Linux 上先执行npm prefix -g拿到全局路径后把它的bin子目录加进 shell 配置文件。Windows 上则是检查%APPDATA%\npm是否在系统环境变量的 PATH 里不在就手动添加然后重启终端。这里有个容易被忽视的细节PATH 修改后当前已经打开的终端窗口不会自动生效。我见过不少人改了 PATH 还继续在旧窗口里测试怎么测都是 command not found其实关掉重开就好了。5.3 auto-update failed 的处理Claude Code 启动时会检查更新如果它没有 npm 目录的写权限就会报出 auto-update failed: no write permission to npm prefix。这个问题尤其在 Windows 非管理员终端、或者 Linux 系统 Node 下高发。解决方案分两种一是从权限根源上解决把 npm 全局目录的写权限交给当前用户二是偷懒直接关闭自动更新需要升级时手动执行npm install -g anthropic-ai/claude-code。第二种方案更稳妥尤其适合经常在多个环境间切换的开发者。5.4 环境变量已设置但请求仍报鉴权错误这个排查要点我单独列出来因为特别容易踩。如果你在 Windows 上通过系统属性 - 环境变量添加了ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN但启动 Claude Code 仍然报 unauthorized先执行echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN如果输出为空说明你当前终端根本没加载新的环境变量重启终端再试。如果输出有值但还是鉴权失败那大概率是 Key 本身的问题——注意检查有没有把 Key 复制完整有没有多余的换行或空格。6. 10 个快速上手技巧用对时间直接翻倍6.1 用/init给项目建档别裸奔开工前面已经详细说了/init的作用这里单独再强调一次无论新项目还是老项目首次接入手动加载 CLAUDE.md 之后第一件事就是初始化。我见过太多人跳过这一步直接开工结果 AI 写的代码跟项目风格牛头不对马嘴返工的成本比初始化高十倍。花两分钟建立档案是最值得的投资。6.2 不做无谓的操作确认用权限白名单跑自动化Claude Code 默认为了安全执行文件修改或命令前会先征求你同意。这在探索阶段没问题但如果你已经明确信任当前任务每次弹确认窗口反而是效率杀手。启动时加参数--dangerously-skip-permissions可以跳过所有确认但这个名字也提示了危险属性。更稳的做法是在交互界面里输入/permissions配置白名单允许它对特定目录做修改、对特定命令直接执行其余操作仍然需要确认。我现在的配置是允许它在/workspace/project-a下直接改文件但禁止它执行rm -rf这类危险命令。平衡好安全与效率这才是长期可用的姿势。6.3 用文件路径精确指定上下文不做大锅烩Claude Code 会根据你的指令自动判断需要看哪些文件但它的判断不见得准确。一个技巧是在对话中明确用符号引用文件比如internal/service/order.go 帮我找出这里所有对数据库状态字段的直接赋值改成通过 OrderState 枚举的 SetState 方法这样它就会优先精读这个文件而不是把整个项目都塞进上下文。上下文越精准答案越准确同时 token 消耗也更少。这套上下文管理的意识越早建立越好。6.4 让子代理并行干活把长任务拆出去Claude Code 支持创建一个子代理让它自主处理一个完整子任务而你继续和主代理对话。这个能力在处理又要重构 A 模块又要改 B 模块测试这类多线任务时非常有用。实际操作中我会让主代理先拆任务然后明确说这部分独立模块交给子代理完成完成后汇总。子代理的执行结果会以摘要形式返回主代理根据结果继续推进。用这个功能的时候注意一点子代理适合边界清晰、依赖少的任务如果任务之间耦合度高强行并行反而增加返工。6.5 用/compact压缩长篇对话保住上下文窗口长时间对话后上下文会越积越多token 消耗越来越大响应也可能越来越慢。这时候可以用/compact把之前的对话摘要化压缩出空间给后续任务。它本质是拿摘要丢失细节换继续干活的能力所以压缩前最好确认当前任务的关键信息已经固化在项目文件里而不是只存在于聊天记录中。6.6/clear开新会话区别临时提问和正式任务如果你只是随手问一个语法问题或查一个函数签名不需要让 Claude Code 记忆项目上下文直接在当前对话里问就行。但如果是开启一项新任务我建议/clear开干净会话再开始。为什么因为旧对话的上下文会干扰它的思路可能把上一个任务的错误模式带进来。每次新任务都从干净状态开始准确性明显更高。6.7 让它生成 Git 提交不是替你写代码Claude Code 的代码修改能力很强但我用得最多的反而是一个轻量功能自动生成 commit message。项目改动完成后执行为当前的改动生成一条规范的 Git commit message它会自动读取git diff分析改动内容生成符合 Conventional Commits 风格的提交信息。这件事看着小但作用不小——它逼着你每次提交前重新审视自己的改动同时省掉了写提交信息的纠结时间。6.8 用/review做代码审查多一个不疲倦的评审员写代码的人自己检查自己的代码总有盲区。Claude Code 的/review会基于 Git 对比范围分析改动中的潜在问题边界条件、错误处理、重复代码、安全风险等。它的审查质量未必能替代资深同事的 code review但作为提交前的第一道自动检查能帮你挡掉相当一部分低级错误。我通常在写完一个功能后跑一次 review把发现的问题修完再提交。这个习惯让我 merge request 的被驳回率降了一大截。6.9 用 harness 模式免登录随时切换后端模型Claude Code 支持 harness 模式可以在不登录 Anthropic 账号的情况下通过环境变量直接对接第三方模型服务。这个能力让我能在 GLM 5、DeepSeek、以及其他兼容模型之间来回切换而不需要安装多套工具。具体做法是在环境变量中动态切换ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN的值或者在项目目录下放一个 .env 文件按项目加载。这样不同项目可以用不同模型后端价格和效果的差异化配置就变得很灵活。6.10 用多目录并行让模型服务不同仓库Claude Code 不是只能在一个目录里运行。你可以在终端里开多个标签页每个标签页进入不同项目目录各跑一个claude实例。它们之间互不干扰你可以同时维护两个项目的开发任务。这个技巧配合 sub-agent 尤其好用一个终端窗口处理项目 A 的主开发流另一个终端窗口跑项目 B 的代码审查。只要你的机器内存够这种多线程工作流能让人工智能同时服务多个上下文对自由职业者或维护多项目的人来说是效率神器。7. 实践经验与配置建议7.1 我的推荐配置项目级环境变量优先在配置后端模型这件事上我不建议把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN写死在系统环境变量里因为一旦你想在另一个项目里换一个模型就得改全局配置再重启终端。更好的方案是利用 Claude Code 对项目级配置的支持。在项目根目录创建.env文件写入ANTHROPIC_BASE_URLhttps://open.bigmodel.cn/api/anthropic ANTHROPIC_AUTH_TOKEN你的GLM_API_KEY这样每个项目都可以有自己独立的模型配置。需要切换后端时只需要改对应项目的.env文件不影响全局环境。7.2 合理的 token 消耗控制用 GLM 5 虽然便宜但不代表可以随意挥霍 token。Claude Code 默认会加载大量项目文件到上下文项目一大token 消耗会肉眼可见地涨。我的控制手段有三个在 CLAUDE.md 里明确写不需要读取哪些目录比如node_modules、构建产物、日志目录避免上下文被无用文件填满任务描述精确到文件和函数而不是泛泛说优化这个项目的性能必要的时候用/compact压缩对话而不是任由上下文无限膨胀这套组合用下来我的月度 API 开销比原来用纯官方模型低了大概 90%效果上对齐度没让人失望。这个数字因人而异但方向是确定的工具本身省不省钱取决于你怎么用它。7.3 版本升级策略别追新但别太旧Claude Code 的迭代速度相当快几乎每周都有新版本。我的建议是别每次都第一时间升到最新版但也不要放任版本长期不升。比较合理的节奏是每个月手动升一次或者看到官方公告里有新功能明确能提升你工作流时再升级。升级命令很简单npm update -g anthropic-ai/claude-code升级后如果出现配置失效或行为变化先查 release notes一般都是环境变量或权限模型有了调整。自己之前写的 CLAUDE.md 和配置文件通常不需要改动但要留意新版本是否引入了更严格的默认权限。8. 最后再分享三个让我回不去的进阶场景8.1 老项目重构把考古交给 AI接手一个五年没动的老项目最痛苦的是理解它当初为什么这么写。以前我的做法是一边摸代码一边吐槽命名一整天下来连模块之间的关系都没理清。现在我的做法是让 Claude Code 先扫描整个项目生成架构说明和数据流梳理然后基于这些信息逐步推进重构。CLAUDE.md 在这个场景下价值巨大。我把从代码里挖出来的历史包袱、隐性约定全部写进去相当于给这份考古报告建了索引。后续每次改动它都能参考这份档案不会再犯用新架构强行套老代码的错误。重构这种事最难的不是写代码而是摸清哪些是设计、哪些是妥协、哪些是陈年 bug 但删了会崩的边界。AI 工具在这个场景里是真正的神队友。8.2 与团队共享工具配置如果你在一个小团队里用这套方案建议把 CLAUDE.md 和 .env 的模板纳入代码库的 docs 目录让每个成员初始化项目时都能快速拉起同一个助手环境。有三件事要列清楚CLAUDE.md 里写了哪些约定、.env 里的变量模板是什么、遇到权限问题该找谁处理。这样团队里的每个人都能在同一个 AI 助手的加持下工作风格一致性反而提高了。8.3 把它当编程伙伴而不是代码生成器最后这点算是我个人的价值观建议。Claude Code 这类工具最大的价值不是帮你把一段描述变成代码而是陪你把一个复杂问题拆解清楚、找到正确的实现路径。当我让它改一块逻辑时我会先跟它讨论方案取舍当我让它排查 bug 时我会让它先输出推理过程再动手。这个习惯让代码质量和可维护性都上了一个台阶也让这个工具真正成了我的搭档而不是一台输出机。从装好第一版到现在我在这个组合上投入的时间已经收到了非常明显的回报不只是省了钱更重要的是那些本来要花一整晚的繁琐改动现在半小时就能收尾。如果你正打算把 Claude Code 接入自己的项目我的建议很简单照着前面的步骤把环境搭起来然后用 CLAUDE.md 好好跟你的新同事做一次上岗培训剩下的就是让它陪你写第一段代码了。