1. Windows 上跑 Claude Code先解决环境这道坎Claude Code 是 Anthropic 推出的命令行 AI 编程工具能在终端里直接读项目、改文件、跑命令适合习惯用 PowerShell 或 CMD 的 Windows 开发者。它和网页版聊天最大的区别是它把当前目录当成工作区能理解项目结构也能调用工具完成多步任务。但 Windows 上的安装体验和 macOS、Linux 不太一样PATH 刷新、PowerShell 执行策略、网络连通性这三件事经常卡住新手。我试过在一台全新的 Windows 11 机器上从零装一遍踩过的坑基本集中在「命令找不到」和「脚本被禁止运行」两类。这篇就按真实操作顺序走一遍先检查 Node.js 和 npm再全局安装 Claude Code然后写一份 settings.json 骨架把请求通道指向 TaoToken最后用 PowerShell 发一条验证请求确认整条链路通了。全程命令可直接复制预期输出我也会标出来方便你对照。需要提前说明的是Claude Code 本身是一个客户端工具它需要一个可用的 API 通道才能工作。TaoToken 在这里扮演的是统一 Key 和 API 入口的角色你拿到一个 Key 之后在 settings.json 里配置好 base URL 和认证信息Claude Code 就会把请求发到这条通道上。下面从环境检查开始。2. 前置检查Node.js、npm 与 PowerShell 权限2.1 确认 Node.js 版本Claude Code 依赖 Node.js 运行官方建议 18 以上。打开 PowerShell先看版本node -v npm -v正常输出类似v20.11.1 10.2.4如果提示node 不是内部或外部命令说明 Node.js 没装或者没进 PATH。去 Node.js 官网下载 LTS 版本安装时务必勾选Add to PATH。装完关掉当前 PowerShell 窗口重新开一个PATH 才会刷新。这一步很多人忽略结果一直报命令找不到。2.2 处理 PowerShell 执行策略Windows 默认会拦截.ps1脚本Claude Code 安装后生成的claude.ps1启动脚本可能被挡住。先看当前策略Get-ExecutionPolicy -Scope CurrentUser如果返回Restricted改成RemoteSignedSet-ExecutionPolicy RemoteSigned -Scope CurrentUser这条命令只影响当前用户不需要管理员权限也不会把整台机器的策略放开。改完再查一次确认变成RemoteSigned。2.3 全局安装 Claude Code环境没问题后用 npm 全局安装npm install -g anthropic-ai/claude-code成功时末尾会看到类似added 3 packages in 12s的提示。装完验证claude --version能打印出版本号就说明可执行文件已经进 PATH。如果这一步报claude 不是内部或外部命令先执行where.exe claude看有没有路径返回没有的话重启终端或者手动把 npm 全局目录加进 PATH。3. TaoToken 前置拿 Key 与 settings.json 骨架3.1 获取统一 KeyClaude Code 需要一个 API Key 才能发请求。到 TaoToken 控制台创建一个 Key复制出来备用。这个 Key 后面会写进 settings.json不要直接贴在命令行里避免进历史记录。控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite3.2 settings.json 放哪Claude Code 在 Windows 上读取的用户级配置目录通常是C:\Users\你的用户名\.claude\settings.json如果.claude目录不存在手动建一个。这个文件是 JSON 格式写错一个逗号都会导致解析失败建议用 VS Code 编辑并开启 JSON 校验。3.3 可复制配置骨架下面是一份最小可用骨架把ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你刚拿到的 Key{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [], deny: [] } }几个字段的作用对照字段作用注意ANTHROPIC_BASE_URL请求发往的 API 入口固定为 https://taotoken.net/apiANTHROPIC_AUTH_TOKEN身份认证填控制台创建的 KeyANTHROPIC_MODEL默认模型按通道支持的模型名填写permissions.allow免确认的工具白名单初期留空按需加permissions.deny禁止调用的工具可先留空注意ANTHROPIC_BASE_URL不要带末尾斜杠也不要拼上/v1客户端会自己补路径。写错会导致 404。保存后Claude Code 下次启动会读取这份配置。如果你同时用多个项目也可以在每个项目根目录放一份.claude/settings.json做覆盖用户级配置作为兜底。4. PowerShell 验证请求与成功结果4.1 用 curl 直接打一条请求在配置生效前先用 PowerShell 的curl.exe注意是 exe不是 alias验证通道本身通不通curl.exe -X POST https://taotoken.net/api/v1/messages -H Content-Type: application/json -H x-api-key: sk-你的Key -H anthropic-version: 2023-06-01 -d {\model\:\claude-sonnet-4-20250514\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\ping\}]}预期返回是一段 JSON包含content数组和usage字段。如果返回401检查 Key 是否复制完整返回404检查 URL 路径返回超时检查本机网络是否能访问该域名。4.2 启动 Claude Code 做端到端验证通道通了之后进任意一个项目目录启动cd D:\projects\demo claude首次启动会进入交互界面。输入一句简单指令比如「列出当前目录的文件」观察它是否能正常返回。能返回就说明 settings.json 被正确读取请求走的是 TaoToken 通道。4.3 用 /status 确认配置来源在 Claude Code 交互界面里输入/status它会打印当前使用的模型、API 地址来源等信息。确认 base URL 显示为https://taotoken.net/api就说明配置生效了。如果还显示默认地址说明 settings.json 没被读到检查文件路径和 JSON 格式。5. 本篇常见报错排查5.1 claude 不是内部或外部命令这是最高频的问题。原因通常是 npm 全局目录没进 PATH。先查npm config get prefix返回的路径就是全局安装目录把它加进系统环境变量 PATH重启终端。或者直接用完整路径调用验证 $(npm config get prefix)\claude.cmd --version5.2 PowerShell 禁止运行脚本报错信息里出现无法加载文件 claude.ps1因为在此系统上禁止运行脚本就是执行策略问题。按 2.2 节改成RemoteSigned即可。如果公司机器有组策略限制改不了可以改用 CMD 启动或者用claude.cmd而不是claude.ps1。5.3 settings.json 解析失败启动时报 JSON 解析错误多半是多了尾逗号、少了引号或者用了中文引号。把文件贴进 VS Code看底部状态栏有没有红色波浪线。也可以用 PowerShell 快速校验Get-Content $env:USERPROFILE\.claude\settings.json -Raw | ConvertFrom-Json能正常输出对象就说明格式没问题。5.4 请求返回 401 或 403认证失败。检查三件事Key 是否复制完整前后不要有空格、ANTHROPIC_AUTH_TOKEN字段名是否写对、Key 是否在控制台被禁用。改完 settings.json 后要重启 Claude Code 才会重新读取。5.5 请求超时或连接被重置先确认本机能正常访问https://taotoken.net/api。用 PowerShell 测Test-NetConnection taotoken.net -Port 443TcpTestSucceeded为True说明端口通。如果通但请求仍超时检查是否有本地安全软件拦截了 curl 或 node 的出站请求。6. 配好之后怎么用得更顺环境跑通只是第一步。日常使用中建议把项目规则写进项目根目录的CLAUDE.md让 Claude Code 每次启动都读到你的编码约定减少来回解释。权限白名单也可以逐步加比如把常用的只读命令放进permissions.allow减少每次确认的打断。如果你打算长期在多个项目里用或者要接 Agent 类工作流可以了解一下 Coding Plan它把额度和通道做了统一管理省去每个项目单独配 Key 的麻烦Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite模型对话体验https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite最后留一个实用习惯每次改完 settings.json先在 PowerShell 里用 4.1 节的 curl 命令打一发确认通道没问题再启动 Claude Code。这样能把「配置问题」和「客户端问题」分开定位排障效率会高很多。