企业官网建设流程全解析

1. 为什么 Claude Code 第一次安装总卡在 npm 和 node.js

Claude Code 是 Anthropic 推出的命令行 AI 编程工具，能在终端里直接读写项目文件、跑命令、改代码，适合刚接触 AI 编程工具、想把它接进本地工作流的新手。但很多人第一次装它，卡住的地方根本不是工具本身，而是前置环境：npm 全局安装报错、node.js 版本太低、装完找不到可执行文件、环境变量没配导致claude命令不识别，最后连 Key 该写在哪都找不到。

我自己第一次装的时候，npm install -g @anthropic-ai/claude-code跑完提示成功，结果敲claude --version直接来一句「不是内部或外部命令」。当时以为是没装上，卸载重装了三遍，后来才发现是 npm 全局目录没进 PATH。这类问题在社区里出现频率极高，本质都是环境问题，不是 Claude Code 本身的问题。

这篇按「先修环境 → 再装工具 → 再配 Key → 最后验证」的顺序走一遍，每一步都给可复制的命令和配置。Key 部分用 TaoToken 统一接入，一个 Key 就能跑通 Claude 系列模型，省得在多个平台之间来回切。目标很明确：让你在本地一次装完，并且能自检连通性。

2. 装之前先把 node.js 和 npm 环境理顺

Claude Code 依赖 Node.js 运行，官方要求 18.0 以上。版本不够会在安装阶段就报EBADENGINE或者装完运行直接崩。先确认版本：

node -v npm -v

如果node -v输出低于 v18，或者提示命令不存在，就去 Node.js 官网下 LTS 版本重装。Windows 用户建议直接下.msi安装包，安装时勾选「Add to PATH」，能省掉后面手动配环境变量的麻烦。

版本没问题后，先看一眼 npm 的全局安装目录在哪，这个路径后面排查「找不到 claude」时要用：

npm config get prefix

Windows 上默认一般是C:\Users\你的用户名\AppData\Roaming\npm，但如果你以前改过 npm 配置，可能被指到别的盘。记住这个输出，第 5 节排错会反复用到。

注意：如果你用的是 nvm 管理 node 版本，切换版本后全局包不会跟着走，需要在新版本下重新装一次 Claude Code。这是很多人「明明装过却找不到」的隐藏原因。

3. 安装 Claude Code 并确认它到底装哪了

安装命令有两种写法，社区里都有人用：

npm install -g @anthropic-ai/claude-code

另一种是npm install -g claude-code。推荐用带 scope 的@anthropic-ai/claude-code，包名更明确，不容易和同名包冲突。装完先别急着运行，确认一下它落在哪：

npm ls -g @anthropic-ai/claude-code

这条命令会打印出全局包的安装路径。如果输出里能看到版本号，说明包装上了，问题只可能出在 PATH。想卸载重来就用：

npm uninstall -g @anthropic-ai/claude-code

装完后执行版本检查：

claude --version

如果这里报「'claude' 不是内部或外部命令」，别慌，包大概率是装好的，只是系统找不到它。往下看第 5 节的 PATH 修法。

4. 用 settings.json 骨架配好 TaoToken 统一 Key

Claude Code 的 Key 和模型配置有两种方式：环境变量，或者settings.json。环境变量适合临时测试，settings.json适合长期用，配置集中、好管理。先拿到 TaoToken 的 Key：进控制台创建 API Key，地址是 https://taotoken.net/api-keys ，创建后复制那串sk-开头的字符串。

然后在用户目录下建配置。Windows 是C:\Users\你的用户名\.claude\settings.json，macOS/Linux 是~/.claude/settings.json。目录不存在就手动建一个。骨架如下：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_API_KEY": "", "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929" } }

几个字段的作用说清楚：ANTHROPIC_BASE_URL指向 TaoToken 的 API 入口，所有请求走这里；ANTHROPIC_AUTH_TOKEN填你刚创建的 Key；ANTHROPIC_API_KEY留空，避免和 AUTH_TOKEN 冲突；ANTHROPIC_MODEL指定默认模型，不写会用默认值，写上更可控。

如果你更习惯用环境变量，Windows PowerShell 里可以这样设（永久生效，重启终端后起作用）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://taotoken.net/api", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的TaoToken密钥", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5-20250929", "User")

macOS/Linux 写进~/.zshrc或~/.bashrc：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="sk-你的TaoToken密钥" export ANTHROPIC_API_KEY="" export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"

改完记得source ~/.zshrc或者重开终端。环境变量和 settings.json 二选一即可，同时配可能互相覆盖，建议只用一种。

5. 验证请求：从 claude --version 到真实对话

配置写完，先验证命令能跑：

claude --version

能打印版本号，说明 PATH 和安装都没问题。接着进一个空目录启动：

claude

首次启动会问一些初始化选项，一路确认即可。如果配置正确，会进入交互界面。这时发一句简单的话测试连通性，比如「用一句话说明这个目录里有什么文件」。如果模型正常返回，说明 Key、BASE_URL、模型名三者都对上了。

想更直接地验证 API 层，可以用 curl 打一次请求：

curl https://taotoken.net/api/v1/messages \ -H "x-api-key: sk-你的TaoToken密钥" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-5-20250929", "max_tokens": 64, "messages": [{"role": "user", "content": "ping"}] }'

返回里带content字段和文本，就说明链路完全通了。这一步能把「Claude Code 客户端问题」和「Key/网络问题」分开，排错时特别有用。如果你只是想先在网页里确认模型可用，也可以直接开模型对话页面 https://taotoken.net/models 发一条消息试试，比命令行更直观。

6. 本篇常见报错逐条排查

报错一：claude不是内部或外部命令。这是 PATH 问题。先跑npm config get prefix拿到全局目录，比如输出是D:\nodejsnew\node_global，就把这个路径加进系统环境变量的 Path 里。Windows 在「此电脑 → 属性 → 高级系统设置 → 环境变量」里改，改完重开终端。macOS/Linux 在 shell 配置里加export PATH="$PATH:$(npm config get prefix)/bin"。

报错二：EBADENGINE或安装时提示 node 版本不符。node.js 低于 18。升级到 LTS 版本，nvm 用户执行nvm install --lts && nvm use --lts，然后重新装 Claude Code。

报错三：启动时Unable to connect to Anthropic services或ERR_BAD_REQUEST。先确认ANTHROPIC_BASE_URL写的是https://taotoken.net/api，没有多余斜杠或空格。再确认 Key 没写错、没过期。如果用的是 settings.json，检查 JSON 格式是否合法，多一个逗号都会导致整个配置不生效。

报错四：找不到 settings.json，不知道 Key 写哪。这个文件不会自动生成，需要你手动在~/.claude/下创建。目录不存在就先mkdir -p ~/.claude。Windows 上路径是C:\Users\你的用户名\.claude\settings.json，注意.claude是带点的隐藏目录。

报错五：改了环境变量但没生效。环境变量改完必须重开终端，当前会话不会自动刷新。Windows 上如果用了set而不是SetEnvironmentVariable，那只对当前窗口有效，关掉就没了。

报错六：模型名写错导致 404。ANTHROPIC_MODEL要填完整模型标识，比如claude-sonnet-4-5-20250929。不确定有哪些可用模型，去 https://taotoken.net/models 看列表，别凭记忆瞎填。

7. 长期用下去：把 Key 和编码工作流固定下来

装通只是第一步。如果你打算把 Claude Code 当成日常编码助手，长期跑 Agent 任务、批量改代码，建议把接入方式固定成一套：Key 用 TaoToken 统一管理，模型按任务切换，配置写进 settings.json 而不是每次敲环境变量。这样换机器、重装系统时，复制一份配置文件就能恢复。

需要看完整接入参数和字段说明，翻接入文档 https://taotoken.net/doc 。如果后面要跑更重的编码任务、想让 Claude Code 长时间在项目里干活，可以了解下 Coding Plan https://taotoken.net/coding-plan ，按用量规划比零散调用更省心。配置这件事，一次弄对，后面就只剩写代码了。