企业官网建设流程全解析

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，这样后面配全局目录和权限时不容易被系统目录限制卡住。

装完之后验证。按Win+R输入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

没报错就说明全局安装链路通了。然后装 ClaudeCode：

npm install -g @anthropic-ai/claude-code --registry=https://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 Key；ANTHROPIC_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 页面能直接创建，接入文档里有各协议的完整地址和字段说明，对着填就行。先把这篇的配置跑通，再按自己的项目需求慢慢调，比一上来就折腾一堆参数要稳得多。