企业官网建设流程全解析

1. 为什么 Windows 用户装 Claude Code 总在第一步卡住

Claude Code 是 Anthropic 推出的终端 AI 编程助手，能直接读写你项目里的文件、执行 shell 命令、按你的规范改代码。它适合已经习惯命令行、想让 AI 真正“动手”而不是只聊天的开发者。但很多人第一次装它，卡的不是命令本身，而是环境：Windows 原生终端跑不起来、npm 全局包装完claude命令找不到、认证走不通、项目里没有 CLAUDE.md 导致 AI 每次都要重新理解代码库。

我实测下来，这套流程在 macOS 和 WSL2 上都能跑通，核心就三件事：装 CLI、初始化认证、把请求通道统一到一个稳定的 Key 上。这篇把每一步拆到可复制，包括 settings.json 骨架和三条验证命令，让你从零跑通第一个对话请求。全程不需要你懂 Bun 或 Node 内部机制，照着敲就行。

需要先说明一点：Claude Code 官方分发包体积约 50MB，内含独立运行时，所以它对 Node 版本不敏感，但 npm 本身要能用。Windows 用户请务必在 WSL2 里操作，不要用 PowerShell 或 CMD 直接装，否则后面路径和权限问题会把你拖进坑里。

2. 前置准备：TaoToken 统一 Key 通道与环境检查

在装 CLI 之前，先把“请求往哪发”这件事定下来。Claude Code 默认走官方端点，但很多人在国内网络下会遇到连接不稳定、认证反复失败。TaoToken 提供统一的 API Key 通道，你只需要在配置里把 base URL 和 Key 指向它，CLI 的其他行为完全不变。

先去官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 注册，然后在控制台创建 API Key。创建入口在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，Key 只显示一次，复制到安全的地方。API 基础地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，配置时原样填入即可。

环境侧你需要确认三样东西。第一，Node.js 和 npm 可用，终端执行node -v && npm -v能出版本号。第二，macOS 需要 11 以上，WSL2 建议 Ubuntu 22.04。第三，终端支持 UTF-8 和颜色，Windows Terminal 或 iTerm2 都行。

WSL2 的准备如果你还没做，在管理员 PowerShell 里执行：

wsl --install -d Ubuntu-22.04 wsl --set-default-version 2

装完重启，进入 Ubuntu 后先更新包索引：

sudo apt update && sudo apt install -y curl git

验证 WSL2 网络能通到 TaoToken 的 API 域名，这一步很关键，通不了后面认证必挂：

curl -I https://taotoken.net/api

返回 200 或 401 都算网络通，401 只是说明你没带 Key，不影响后续配置。

3. 可复制配置：npm 安装 Claude Code 与 settings.json 骨架

3.1 安装 CLI

macOS 和 WSL2 都用同一条 npm 全局安装命令：

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

如果下载慢，换镜像源重试：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

装完验证：

claude --version

能输出版本号就说明二进制已进 PATH。如果提示command not found，把 npm 全局 bin 目录加进 PATH：

export PATH="$PATH:$(npm prefix -g)/bin" echo 'export PATH="$PATH:'"$(npm prefix -g)"'/bin"' >> ~/.bashrc source ~/.bashrc

3.2 写 settings.json 骨架

Claude Code 读取用户级配置的位置在~/.claude/settings.json。这个文件控制模型端点、认证方式和一些行为开关。下面是我实测可用的骨架，把YOUR_TAOTOKEN_KEY换成你在控制台创建的 Key：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "YOUR_TAOTOKEN_KEY" }, "permissions": { "allow": [ "Read", "Bash(ls:*)", "Bash(cat:*)" ] }, "model": "claude-sonnet-4-20250514" }

创建目录和文件：

mkdir -p ~/.claude nano ~/.claude/settings.json

把上面内容粘进去，保存退出。注意ANTHROPIC_BASE_URL结尾不要带斜杠，ANTHROPIC_API_KEY不要有多余空格。这个配置的作用是让 CLI 把所有请求发到 TaoToken 的通道，而不是官方端点，这样你只需要维护一个 Key。

3.3 生成 CLAUDE.md 项目说明文件

CLAUDE.md 是 Claude Code 的项目“说明书”，放在项目根目录，启动时自动加载进系统提示词。没有它，AI 每次都要重新猜你的技术栈和命令。在项目根目录执行：

cat > CLAUDE.md << 'EOF' # 项目：My API Service ## 技术栈 - Node.js 20 + TypeScript - Express 框架 - Prisma ORM + PostgreSQL ## 常用命令 - `npm run dev`：启动开发服务器，监听 3000 端口 - `npm test`：运行 Jest 单元测试 - `npm run build`：编译 TypeScript ## 代码规范 - 使用 ESLint + Prettier - 函数命名 camelCase - 所有 API 路由定义在 src/routes/ 下 ## 注意事项 - 不要直接改 prisma/schema.prisma 而不跑迁移 - 环境变量写在 .env.local，不要提交到 Git EOF

这份文件建议提交到 Git，团队共享同一份 AI 行为指南，新人拉下来就能用。

4. 验证请求：三条命令跑通首个对话

配置写完别急着开聊，先用三条命令确认链路是通的。

第一条，确认 CLI 能读到你的配置：

claude config list

输出里应该能看到ANTHROPIC_BASE_URL指向https://taotoken.net/api。如果显示的是官方地址，说明 settings.json 没被加载，检查文件路径和 JSON 格式。

第二条，发一个最小请求验证认证：

claude -p "只回复两个字：通了"

-p是 print 模式，不进入交互界面，直接返回结果。如果返回“通了”，说明 Key 和端点都正确。如果报 401，回到控制台确认 Key 是否复制完整。

第三条，进入项目目录做真实对话：

cd your-project claude

看到Claude Code >提示符后，输入：

打印当前目录下的文件列表

CLI 会调用内置工具读取目录并返回结果。再试一条更有用的：

用注释帮我分析这个项目是做什么的，不要改代码

它会读 package.json、README.md 和入口文件，给你一份项目摘要。到这里，你的第一个对话请求就跑通了。

5. 本篇常见错排查

command not found: claude：npm 全局 bin 没进 PATH。执行npm prefix -g看路径，把/bin加进 shell 配置，重开终端。

认证后仍提示 unauthorized：Key 无效或过期，或者 settings.json 里 Key 带了引号外的空格。重新生成 Key，用cat ~/.claude/settings.json检查内容。

第一次对话响应极慢：首次请求需要建立连接和加载上下文，等 10 到 20 秒正常，后续会快。

WSL2 里 curl 不通 TaoToken：检查 WSL2 网络模式，执行cat /etc/resolv.conf看 DNS。如果公司网络有限制，换手机热点测试排除本地网络问题。

settings.json 改了不生效：JSON 语法错误会导致整个文件被忽略。用python3 -m json.tool ~/.claude/settings.json校验格式。

CLAUDE.md 没被加载：确认文件名大小写完全一致，且放在你运行claude的目录下。子目录里的 CLAUDE.md 不会自动向上查找。

6. 下一步：把通道固定下来，再学斜杠命令

装完只是开始。你现在有了一个能读文件、跑命令、按 CLAUDE.md 规范工作的终端 AI 工程师。接下来要做的，是把 Key 通道固定成日常习惯：所有项目共用一份~/.claude/settings.json，项目差异写进各自的 CLAUDE.md，这样换电脑只需要迁移配置文件和 Key。

如果你打算长期在多个项目里用，建议看一下 Coding Plan，它把额度和通道管理做得更省心：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。想先验证模型行为，可以直接在模型对话页试：https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model-chat&utm_campaign=rewrite 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，遇到配置问题先查这里。

下一篇会讲必知必会的 5 个斜杠命令：/help、/compact、/clear、/cost、/exit，它们控制上下文压缩、成本统计和会话清理。在那之前，先把今天这三步在你的机器上跑一遍，确认claude -p能返回结果，再进项目目录做一次真实对话。跑通了，后面的高级功能才有地基。