1. ClaudeCode 安装及运行到底卡在哪从零到接入 GLM 的真实链路ClaudeCode 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码适合习惯在命令行里干活、又想让模型帮忙处理多文件任务的开发者。它本身是个 npm 全局包装完之后靠settings.json里的环境变量决定请求发往哪个兼容 Anthropic 协议的模型服务。GLM 系列模型提供了 Anthropic 兼容接口所以只要把地址和 Token 配对ClaudeCode 就能跑在 GLM 上。问题在于很多人第一次装的时候会连续踩几个坑Node.js 装到 C 盘导致后续权限报错、npm 全局目录没配好导致claude命令找不到、settings.json放错位置导致配置完全不生效、Token 和 BASE_URL 抄错一个字符就 401。这些坑单独看都不难但串在一起就很容易让人卡在“装完了但跑不起来”的状态。这篇就按真实操作顺序走一遍先把 Node.js 和 npm 环境弄干净再装 ClaudeCode然后写settings.json接入 GLM最后用一次真实对话验证整条链路通不通。每一步都给可复制的命令和配置你照着做就行。如果你后面想换成别的兼容模型改settings.json里两三个字段就能切换不用重装。2. 前置准备Node.js 与 npm 环境配置ClaudeCode 依赖 Node.js 运行时所以第一步是把 Node.js 装好。Windows 上直接去 Node.js 官网下载 LTS 版本的.msi安装包双击安装。安装路径建议改到非系统盘比如E:\ClaudeC\Nodejs这样后面配全局目录和权限时不容易被系统目录限制卡住。装完之后验证。按WinR输入cmd打开命令行依次执行node -v npm -v两条命令都能打印出版本号说明 Node.js 和 npm 都就绪了。如果node -v报“不是内部或外部命令”基本是安装时没勾选加入 PATH重新跑一遍安装包勾上即可。接下来配 npm 的全局目录和缓存目录。默认情况下 npm 全局包会装到用户目录下路径深、权限也容易出问题。我习惯在 Node.js 安装目录下新建两个文件夹node_cache和node_global然后用管理员身份打开 cmd把 npm 指过去npm config set prefix E:\ClaudeC\Nodejs\node_global npm config set cache E:\ClaudeC\Nodejs\node_cache注意路径要换成你自己的实际路径。设置完查看一下确认生效npm get prefix npm get cache输出应该和你设置的一致。如果还是旧路径说明命令没执行成功或者用了非管理员权限。镜像源也顺手配一下国内拉包会快很多npm config set registry https://registry.npmmirror.com npm config get registry最后是环境变量。右键“此电脑”→“属性”→“高级系统设置”→“环境变量”在系统变量的Path里加上E:\ClaudeC\Nodejs\node_global这样全局安装的命令行工具才能被找到。同时给 Node.js 安装目录设置完全控制权限避免后面全局安装时写文件被拒。3. 安装 ClaudeCode 并接入 GLM 的 settings.json 配置骨架环境好了就开始装 ClaudeCode。先随便装个包测试 npm 全局安装是否正常npm install express -g没报错就说明全局安装链路通了。然后装 ClaudeCodenpm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com装完验证claude --version能打印版本号就说明安装成功。如果提示claude不是内部或外部命令回去检查第 2 步的Path有没有加对加完要重开命令行窗口才生效。接下来是接入 GLM 的关键一步写settings.json。这个文件放在用户目录下的.claude文件夹里Windows 上就是C:\Users\你的用户名\.claude\settings.json。如果文件夹或文件不存在就手动新建。配置骨架长这样{ env: { ANTHROPIC_AUTH_TOKEN: 你的GLM_API_KEY, ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/anthropic, CLAUDE_CODE_ATTRIBUTION_HEADER: 0 } }三个字段的作用分别是ANTHROPIC_AUTH_TOKEN填你在 GLM 平台创建的 API KeyANTHROPIC_BASE_URL填 GLM 的 Anthropic 兼容接口地址CLAUDE_CODE_ATTRIBUTION_HEADER设为0关掉归因头避免多余请求头干扰。如果你要指定具体模型再加一个字段{ env: { ANTHROPIC_AUTH_TOKEN: 你的GLM_API_KEY, ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/anthropic, ANTHROPIC_MODEL: glm-4.6, CLAUDE_CODE_ATTRIBUTION_HEADER: 0 } }ANTHROPIC_MODEL填你要用的模型名不填的话走服务端默认。这里有个容易忽略的点settings.json必须是合法 JSON不能有注释、不能有多余逗号否则 ClaudeCode 启动时会静默忽略配置表现就是一直报鉴权失败但看不出原因。如果你手上暂时没有 GLM 的 Key或者想先拿一个统一入口把 ClaudeCode 跑通再决定用哪个模型可以走 TaoToken 的 API Key 体系它兼容 Anthropic 协议配置方式完全一样把ANTHROPIC_BASE_URL换成对应地址、Token 换成自己的 Key 即可。接入文档里有各协议的地址说明照着填不会错。4. 验证请求跑一次真实对话确认链路通配置写完进 PowerShell 或 cmd直接输入claude第一次启动会进交互界面。输入一句“你好”如果模型正常返回内容、没有报错说明整条链路通了。想更明确地验证是不是真的走了 GLM可以问一个带身份的问题比如“你是什么模型”。返回里如果出现 GLM 相关标识就确认请求确实发到了 GLM 而不是默认端点。再进一步可以在一个真实项目目录里跑一次文件操作验证 ClaudeCode 的工具调用能力cd E:\你的项目目录 claude然后输入“列出当前目录下的文件并说明项目结构”。如果它能正确读取目录、返回文件列表和分析说明不只是对话通了文件读写这条链路也正常。验证通过后日常使用就是cd到项目目录、输入claude进入交互或者用claude 帮我改一下这个函数这种一次性命令模式。如果你打算长期在编码和 Agent 场景里用可以考虑 Coding Plan 这类按量方案比每次单独配 Key 省事。5. 本篇常见报错排查报错一claude不是内部或外部命令。原因是 npm 全局目录没加进系统Path。解决确认npm get prefix输出的路径已加入系统变量Path加完重开命令行窗口。报错二401 Unauthorized 或鉴权失败。九成是settings.json里的 Token 或 BASE_URL 抄错了。检查 Token 有没有多余空格、BASE_URL 是不是https://open.bigmodel.cn/api/anthropic这个完整地址。另外确认settings.json放在C:\Users\你的用户名\.claude\下放错位置配置不生效。报错三配置改了但没生效。ClaudeCode 只在启动时读一次settings.json改完要退出重进。另外 JSON 格式错误会导致整个配置被忽略用编辑器格式化一下确认没有语法问题。报错四npm 全局安装报 EACCES 或权限错误。说明全局目录权限不够。给 Node.js 安装目录设置完全控制权限或者用管理员身份运行命令行。报错五请求超时或连接失败。检查网络是否能正常访问配置的 BASE_URL以及ANTHROPIC_BASE_URL有没有多写或少写路径段。地址末尾不要加斜杠。报错六模型返回内容为空或报模型不存在。如果配了ANTHROPIC_MODEL确认模型名拼写正确、该模型在你的账号下有权限。不确定就先删掉这个字段走默认模型。6. 跑通之后把 ClaudeCode 用顺手的几个建议链路通了只是开始。实际用下来有几个习惯能让 ClaudeCode 顺手很多。一是把settings.json备份一份换机器或重装时直接复制省得重新配。二是项目里放一个CLAUDE.md写上项目约定、技术栈、常用命令ClaudeCode 启动时会读它回答和改代码会更贴合你的项目。三是善用一次性命令模式小改动不用进交互界面直接claude 把 utils.js 里的日期格式化函数改成支持时区更快。如果你后面想换模型只改settings.json里的ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN和ANTHROPIC_MODEL三个字段就行ClaudeCode 本身不用动。这也是走 Anthropic 兼容协议的好处工具链和模型解耦切换成本很低。需要 Key 和接入地址的话API Keys 页面能直接创建接入文档里有各协议的完整地址和字段说明对着填就行。先把这篇的配置跑通再按自己的项目需求慢慢调比一上来就折腾一堆参数要稳得多。
1. ClaudeCode 安装及运行到底卡在哪从零到接入 GLM 的真实链路ClaudeCode 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码适合习惯在命令行里干活、又想让模型帮忙处理多文件任务的开发者。它本身是个 npm 全局包装完之后靠settings.json里的环境变量决定请求发往哪个兼容 Anthropic 协议的模型服务。GLM 系列模型提供了 Anthropic 兼容接口所以只要把地址和 Token 配对ClaudeCode 就能跑在 GLM 上。问题在于很多人第一次装的时候会连续踩几个坑Node.js 装到 C 盘导致后续权限报错、npm 全局目录没配好导致claude命令找不到、settings.json放错位置导致配置完全不生效、Token 和 BASE_URL 抄错一个字符就 401。这些坑单独看都不难但串在一起就很容易让人卡在“装完了但跑不起来”的状态。这篇就按真实操作顺序走一遍先把 Node.js 和 npm 环境弄干净再装 ClaudeCode然后写settings.json接入 GLM最后用一次真实对话验证整条链路通不通。每一步都给可复制的命令和配置你照着做就行。如果你后面想换成别的兼容模型改settings.json里两三个字段就能切换不用重装。2. 前置准备Node.js 与 npm 环境配置ClaudeCode 依赖 Node.js 运行时所以第一步是把 Node.js 装好。Windows 上直接去 Node.js 官网下载 LTS 版本的.msi安装包双击安装。安装路径建议改到非系统盘比如E:\ClaudeC\Nodejs这样后面配全局目录和权限时不容易被系统目录限制卡住。装完之后验证。按WinR输入cmd打开命令行依次执行node -v npm -v两条命令都能打印出版本号说明 Node.js 和 npm 都就绪了。如果node -v报“不是内部或外部命令”基本是安装时没勾选加入 PATH重新跑一遍安装包勾上即可。接下来配 npm 的全局目录和缓存目录。默认情况下 npm 全局包会装到用户目录下路径深、权限也容易出问题。我习惯在 Node.js 安装目录下新建两个文件夹node_cache和node_global然后用管理员身份打开 cmd把 npm 指过去npm config set prefix E:\ClaudeC\Nodejs\node_global npm config set cache E:\ClaudeC\Nodejs\node_cache注意路径要换成你自己的实际路径。设置完查看一下确认生效npm get prefix npm get cache输出应该和你设置的一致。如果还是旧路径说明命令没执行成功或者用了非管理员权限。镜像源也顺手配一下国内拉包会快很多npm config set registry https://registry.npmmirror.com npm config get registry最后是环境变量。右键“此电脑”→“属性”→“高级系统设置”→“环境变量”在系统变量的Path里加上E:\ClaudeC\Nodejs\node_global这样全局安装的命令行工具才能被找到。同时给 Node.js 安装目录设置完全控制权限避免后面全局安装时写文件被拒。3. 安装 ClaudeCode 并接入 GLM 的 settings.json 配置骨架环境好了就开始装 ClaudeCode。先随便装个包测试 npm 全局安装是否正常npm install express -g没报错就说明全局安装链路通了。然后装 ClaudeCodenpm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com装完验证claude --version能打印版本号就说明安装成功。如果提示claude不是内部或外部命令回去检查第 2 步的Path有没有加对加完要重开命令行窗口才生效。接下来是接入 GLM 的关键一步写settings.json。这个文件放在用户目录下的.claude文件夹里Windows 上就是C:\Users\你的用户名\.claude\settings.json。如果文件夹或文件不存在就手动新建。配置骨架长这样{ env: { ANTHROPIC_AUTH_TOKEN: 你的GLM_API_KEY, ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/anthropic, CLAUDE_CODE_ATTRIBUTION_HEADER: 0 } }三个字段的作用分别是ANTHROPIC_AUTH_TOKEN填你在 GLM 平台创建的 API KeyANTHROPIC_BASE_URL填 GLM 的 Anthropic 兼容接口地址CLAUDE_CODE_ATTRIBUTION_HEADER设为0关掉归因头避免多余请求头干扰。如果你要指定具体模型再加一个字段{ env: { ANTHROPIC_AUTH_TOKEN: 你的GLM_API_KEY, ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/anthropic, ANTHROPIC_MODEL: glm-4.6, CLAUDE_CODE_ATTRIBUTION_HEADER: 0 } }ANTHROPIC_MODEL填你要用的模型名不填的话走服务端默认。这里有个容易忽略的点settings.json必须是合法 JSON不能有注释、不能有多余逗号否则 ClaudeCode 启动时会静默忽略配置表现就是一直报鉴权失败但看不出原因。如果你手上暂时没有 GLM 的 Key或者想先拿一个统一入口把 ClaudeCode 跑通再决定用哪个模型可以走 TaoToken 的 API Key 体系它兼容 Anthropic 协议配置方式完全一样把ANTHROPIC_BASE_URL换成对应地址、Token 换成自己的 Key 即可。接入文档里有各协议的地址说明照着填不会错。4. 验证请求跑一次真实对话确认链路通配置写完进 PowerShell 或 cmd直接输入claude第一次启动会进交互界面。输入一句“你好”如果模型正常返回内容、没有报错说明整条链路通了。想更明确地验证是不是真的走了 GLM可以问一个带身份的问题比如“你是什么模型”。返回里如果出现 GLM 相关标识就确认请求确实发到了 GLM 而不是默认端点。再进一步可以在一个真实项目目录里跑一次文件操作验证 ClaudeCode 的工具调用能力cd E:\你的项目目录 claude然后输入“列出当前目录下的文件并说明项目结构”。如果它能正确读取目录、返回文件列表和分析说明不只是对话通了文件读写这条链路也正常。验证通过后日常使用就是cd到项目目录、输入claude进入交互或者用claude 帮我改一下这个函数这种一次性命令模式。如果你打算长期在编码和 Agent 场景里用可以考虑 Coding Plan 这类按量方案比每次单独配 Key 省事。5. 本篇常见报错排查报错一claude不是内部或外部命令。原因是 npm 全局目录没加进系统Path。解决确认npm get prefix输出的路径已加入系统变量Path加完重开命令行窗口。报错二401 Unauthorized 或鉴权失败。九成是settings.json里的 Token 或 BASE_URL 抄错了。检查 Token 有没有多余空格、BASE_URL 是不是https://open.bigmodel.cn/api/anthropic这个完整地址。另外确认settings.json放在C:\Users\你的用户名\.claude\下放错位置配置不生效。报错三配置改了但没生效。ClaudeCode 只在启动时读一次settings.json改完要退出重进。另外 JSON 格式错误会导致整个配置被忽略用编辑器格式化一下确认没有语法问题。报错四npm 全局安装报 EACCES 或权限错误。说明全局目录权限不够。给 Node.js 安装目录设置完全控制权限或者用管理员身份运行命令行。报错五请求超时或连接失败。检查网络是否能正常访问配置的 BASE_URL以及ANTHROPIC_BASE_URL有没有多写或少写路径段。地址末尾不要加斜杠。报错六模型返回内容为空或报模型不存在。如果配了ANTHROPIC_MODEL确认模型名拼写正确、该模型在你的账号下有权限。不确定就先删掉这个字段走默认模型。6. 跑通之后把 ClaudeCode 用顺手的几个建议链路通了只是开始。实际用下来有几个习惯能让 ClaudeCode 顺手很多。一是把settings.json备份一份换机器或重装时直接复制省得重新配。二是项目里放一个CLAUDE.md写上项目约定、技术栈、常用命令ClaudeCode 启动时会读它回答和改代码会更贴合你的项目。三是善用一次性命令模式小改动不用进交互界面直接claude 把 utils.js 里的日期格式化函数改成支持时区更快。如果你后面想换模型只改settings.json里的ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN和ANTHROPIC_MODEL三个字段就行ClaudeCode 本身不用动。这也是走 Anthropic 兼容协议的好处工具链和模型解耦切换成本很低。需要 Key 和接入地址的话API Keys 页面能直接创建接入文档里有各协议的完整地址和字段说明对着填就行。先把这篇的配置跑通再按自己的项目需求慢慢调比一上来就折腾一堆参数要稳得多。
