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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册然后在控制台创建 API Key。创建入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 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 安装 CLImacOS 和 WSL2 都用同一条 npm 全局安装命令npm install -g anthropic-ai/claude-code如果下载慢换镜像源重试npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.com装完验证claude --version能输出版本号就说明二进制已进 PATH。如果提示command not found把 npm 全局 bin 目录加进 PATHexport PATH$PATH:$(npm prefix -g)/bin echo export PATH$PATH:$(npm prefix -g)/bin ~/.bashrc source ~/.bashrc3.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: claudenpm 全局 bin 没进 PATH。执行npm prefix -g看路径把/bin加进 shell 配置重开终端。认证后仍提示 unauthorizedKey 无效或过期或者 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_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。想先验证模型行为可以直接在模型对话页试https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到配置问题先查这里。下一篇会讲必知必会的 5 个斜杠命令/help、/compact、/clear、/cost、/exit它们控制上下文压缩、成本统计和会话清理。在那之前先把今天这三步在你的机器上跑一遍确认claude -p能返回结果再进项目目录做一次真实对话。跑通了后面的高级功能才有地基。
