企业官网建设流程全解析

1. Windows11 上跑 Claude Code，卡住的多半不是模型而是环境

Claude Code 是 Anthropic 出的命令行编程助手，能在终端里直接读你的项目、改文件、跑命令，适合习惯用 PowerShell 或 VS Code 写代码的人。它本身是个 npm 包，装起来就一行命令，但在 Windows11 上真正让人卡住的往往不是模型能力，而是三件事：Node 和 Git 没装对、全局包路径没进 PATH、以及网络通道没配好导致一执行就报连接失败。

我自己在 Windows11 上从零装过好几轮，踩过的坑集中在「claude 不是内部或外部命令」和「执行 claude 后一直转圈或直接报错」这两类。这篇就按从零到跑通的顺序走一遍：先确认 Node、Git、npm 三件套，再装 Claude Code 本体，然后用 TaoToken 的统一 Key 和 API 通道完成配置，最后给你一份可复制的 settings.json 骨架和分步验证动作。目标是一次跑通，并且留下一份以后换机器能直接复用的配置。

需要说明的是，Claude Code 只是客户端，它需要一个能接收 Anthropic 协议请求的入口。TaoToken 在这里扮演的就是这个统一入口：你拿一个 Key，配好 base_url，客户端就能正常发请求，不用在每台机器上折腾不同的通道。下面所有命令都可以直接复制到 PowerShell 里执行。

2. 前置准备：Node、Git、npm 三件套怎么确认

Claude Code 依赖 Node 运行时，同时它内部会调用 Git 来做版本相关操作，所以这两个必须先到位。npm 是随 Node 一起装的，一般不用单独处理。

2.1 检查 Node 是否安装

打开 PowerShell 或 CMD，运行：

node --version

正常会返回类似v22.14.0的版本号。如果提示「不是内部或外部命令」，说明没装或没进 PATH。去 Node 官网下载 Windows 安装包，安装时全部选默认参数即可，安装器会自动把 Node 和 npm 加进 PATH。装完关掉当前终端，重新开一个再验证。

2.2 检查 Git 是否安装

git --version

正常返回类似git version 2.46.2.windows.1。没有的话去 Git 官网下载 Windows 安装包，一路默认下一步即可。装完同样重开终端验证。

2.3 检查 npm 并处理下载慢

npm --version

npm 随 Node 一起装好，能返回版本号就说明三件套齐了。如果后面npm install下载很慢，可以切国内镜像：

npm config set registry https://registry.npmmirror.com

这条只是换下载源，不影响功能。切完可以用npm config get registry确认当前源。

3. 安装 Claude Code 本体并解决命令找不到

三件套确认后，安装本体就一行：

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

-g表示全局安装。装完先验证：

claude --version

3.1 「不是内部或外部命令」怎么定位

如果这里报'claude' 不是内部或外部命令，也不是可运行的程序或批处理文件，别急着重装，先找文件到底装哪了。全局包的落地目录可以用这条查：

npm config get prefix

假设返回C:\Program Files\nodejs\node_global，那claude.cmd大概率就在这个目录下。你可以直接去看一眼：

dir "C:\Program Files\nodejs\node_global\claude.cmd"

文件在、但命令用不了，就是 PATH 没包含这个目录。

3.2 把全局目录加进 PATH

按Win + R，输入sysdm.cpl回车，切到「高级」选项卡，点「环境变量」。优先改「用户变量」里的Path（不需要管理员权限）：选中 Path → 编辑 → 新建 → 粘贴C:\Program Files\nodejs\node_global\→ 一路确定。

改完必须重开终端，PATH 才会生效。再跑一次：

claude --version

返回类似2.1.62 (Claude Code)就说明本体装好了。这一步是整个流程里最容易漏的，很多人以为装失败，其实只是路径没配。

4. 用 TaoToken 统一 Key 完成配置

本体装好后直接执行claude通常会失败，因为客户端还不知道往哪发请求、用什么身份。这里需要配两样东西：认证 Token 和 API 入口地址。TaoToken 提供统一 Key 和 API 通道，你只需要在配置里填一次。

先去控制台创建 API Key：访问 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，登录后新建一个 Key 并复制保存。API 入口地址用 https://taotoken.net/api 。

4.1 可复制的 settings.json 骨架

Claude Code 会读取用户目录下的配置文件。创建或编辑C:\Users\你的用户名\.claude\settings.json，填入：

{ "env": { "ANTHROPIC_AUTH_TOKEN": "替换为你的 TaoToken API Key", "ANTHROPIC_BASE_URL": "https://taotoken.net/api" }, "permissions": { "allow": [], "deny": [] } }

注意两点：ANTHROPIC_AUTH_TOKEN填你刚复制的 Key，ANTHROPIC_BASE_URL填 TaoToken 的 API 地址，不要带多余斜杠。permissions先留空，后面按需放开。

4.2 用批处理一次性写环境变量

除了 settings.json，也可以把 Token 和地址写进系统环境变量，双保险。新建一个.bat文件，内容如下：

@echo off echo ======================================== echo Claude Code Environment Setup echo ======================================== echo. set /p API_KEY=Please enter your API Key: if "%API_KEY%"=="" ( echo Error: API Key cannot be empty! pause exit /b 1 ) echo. echo Setting environment variables... setx ANTHROPIC_AUTH_TOKEN "%API_KEY%" setx ANTHROPIC_BASE_URL "https://taotoken.net/api" echo. echo ======================================== echo Setup Complete! echo ======================================== echo. echo Please restart your terminal for changes to take effect. echo. pause

双击运行，粘贴你的 Key，回车即可。setx写入的是持久环境变量，写完要重开终端才生效。settings.json 和环境变量同时配好，能避免某些场景下只读其中一处导致的认证失败。

5. 分步验证：从版本检查到连通性测试

配置完成后不要直接开干，按下面顺序验证，出问题好定位。

第一步，确认版本：

claude --version

第二步，确认环境变量已写入当前会话（重开终端后执行）：

echo $env:ANTHROPIC_BASE_URL

应返回https://taotoken.net/api。如果为空，说明环境变量没生效，检查是否重开了终端。

第三步，直接启动：

claude

首次启动会进入交互界面。如果配置正确，你能正常对话并让它读文件、改代码。想先单独验证模型通道是否通，可以打开模型对话页面发一条测试消息： https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，能正常返回就说明 Key 和通道没问题，问题只可能在客户端配置。

第四步，在项目里实测。进入任意代码目录，执行claude，让它读一个文件，比如「读一下 package.json 并告诉我依赖」。能正常读取并回答，说明整条链路通了。

如果你打算长期用它做编码或接 Agent 工作流，可以了解下 Coding Plan： https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，按用量规划更省心。

6. 本篇常见报错排查

报错一：'claude' 不是内部或外部命令回到 3.1 和 3.2，用npm config get prefix找到全局目录，确认claude.cmd存在，再把该目录加进用户 Path，重开终端。

报错二：执行 claude 后一直转圈或超时多半是 base_url 或 Token 不对。检查 settings.json 里ANTHROPIC_BASE_URL是否为https://taotoken.net/api，Token 是否复制完整（前后无空格）。改完保存，重开终端再试。

报错三：认证失败 / 401Key 失效或填错。去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite 重新生成一个，替换 settings.json 和环境变量里的值。注意两处都要改，只改一处可能仍读到旧值。

报错四：npm 安装卡住不动切镜像：npm config set registry https://registry.npmmirror.com，然后重跑安装命令。

报错五：VS Code 里插件一直转圈先确认终端里claude能正常跑。终端通了插件一般就通；插件侧如果仍异常，检查 VS Code 是否继承了系统环境变量，必要时重启 VS Code 甚至重启系统让环境变量彻底生效。

接入相关的完整说明可以对照文档： https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite ，里面有各客户端的配置示例，遇到字段不确定时翻一下比猜快。

整套流程走下来，真正花时间的不是安装命令，而是 PATH 和配置这两处。把 settings.json 骨架存好，下次换机器直接复制，改个 Key 就能用。