1. Windows 上跑 Claude Code卡住你的往往不是模型Claude Code 是 Anthropic 推出的命令行 AI 编程助手能在终端里直接读写项目文件、执行命令、按自然语言改代码适合习惯在 PowerShell 里干活、又想让 AI 真正“动手”的开发者。但 Windows 用户第一次装它十有八九不是被模型能力劝退而是被三件事拦住Node.js 环境没配好、PowerShell 执行策略把脚本拦了、API Key 和网关地址不知道往哪填。这篇就把从零到能跑通claude的完整链路拆开每一步都给可复制的命令和配置目标是一次跑通。我试过在一台干净的 Windows 11 上重装一遍发现真正花时间的不是敲命令而是搞清“哪个变量该写在哪、哪个策略该改到哪一级”。下面按环境准备、统一 Key 接入、配置文件骨架、验证、排错的顺序来你可以边看边操作。2. 装之前先把 Node.js 和 npm 确认干净Claude Code 是 npm 包所以 Node.js 是硬前提。推荐直接去 Node.js 官网下 LTS 版本安装时保持默认勾选会自动配好 npm 和 PATH。装完先别急着装 Claude Code先验证环境node -v npm -v正常会返回类似v20.x.x和10.x.x。如果node提示“不是内部或外部命令”说明 PATH 没生效关掉当前 PowerShell 重开一次还不行就手动把 Node 安装目录加进系统环境变量。这里有个容易忽略的点如果你之前用 nvm-windows 装过多个 Node 版本确认当前node -v指向的是 LTS 而不是某个老版本否则后面全局安装的claude可能落在另一个版本的目录里命令找不到。环境确认后全局安装 Claude Codenpm install -g anthropic-ai/claude-code claude --version能打印出版本号说明二进制已经就位。如果这一步报权限错误用管理员身份开一个 PowerShell 再执行一次。3. 用 TaoToken 统一 Key别把密钥散在各处Claude Code 默认要连 Anthropic 官方端点国内直连体验不稳定而且密钥管理也麻烦。更省事的做法是通过 TaoToken 这类统一网关来接入一个 Key 管多个模型端点固定配置只写一次。TaoToken 的定位就是给开发者和 AI 工具研究者提供统一的模型调用入口Claude Code、Coding Agent 这类工具都能接。你需要先去控制台拿一个 API Key。打开 TaoToken 控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite登录后在 API Keys 页面新建一个密钥复制出来先存好。这个 Key 就是后面ANTHROPIC_AUTH_TOKEN的值。拿到 Key 之后Claude Code 需要两个核心环境变量一个是网关地址ANTHROPIC_BASE_URL一个是认证令牌ANTHROPIC_AUTH_TOKEN。在 PowerShell 里用SetEnvironmentVariable写到用户级这样重开终端也还在[Environment]::SetEnvironmentVariable( ANTHROPIC_BASE_URL, https://taotoken.net/api, User ) [Environment]::SetEnvironmentVariable( ANTHROPIC_AUTH_TOKEN, sk-你的密钥, User )注意ANTHROPIC_BASE_URL这里填的是https://taotoken.net/api不要多加路径后缀。写完之后必须重开 PowerShell因为SetEnvironmentVariable对当前已打开的窗口不生效。重开后验证$env:ANTHROPIC_BASE_URL $env:ANTHROPIC_AUTH_TOKEN -ne $null第一条应回显网关地址第二条应返回True。如果返回空或False说明变量没写进用户级检查是不是漏了User参数或者当前窗口没重启。4. 配置文件骨架settings.json 与 config.toml环境变量能跑通基本调用但要让 Claude Code 行为稳定、可复用建议把配置落到文件里。Claude Code 在 Windows 下会读取用户目录下的配置常见位置是%USERPROFILE%\.claude\。先建目录New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude然后是settings.json用来声明模型、网关和权限策略。一个可用的骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的密钥 }, model: claude-sonnet-4-5, permissions: { allow: [ Read, Edit, Bash(git status), Bash(npm run *) ], deny: [] } }把这段保存为%USERPROFILE%\.claude\settings.json。permissions.allow里列的是允许 Claude Code 自动执行的操作建议先只放读文件和只读类命令等熟悉了再逐步放开写操作避免它在你没确认时改动项目。如果你还想用 config.toml 形式管理部分工具链会读这个可以放一份等价配置[env] ANTHROPIC_BASE_URL https://taotoken.net/api ANTHROPIC_AUTH_TOKEN sk-你的密钥 [model] name claude-sonnet-4-5 [permissions] allow [Read, Edit] deny []两份文件不冲突按你实际工具读取的那份为准。密钥写在文件里要注意别把.claude目录提交进 Git最好在全局.gitignore里加一行.claude/。5. 验证安装是否真的生效配置写完进一个测试项目目录跑一遍完整链路cd D:\your_project claude如果一切正常会进入交互式界面。此时输入一句自然语言指令比如让它读一下当前目录结构列出当前项目的文件结构并说明入口文件在哪能正常返回结果说明网关、Key、模型三者都通了。再验证一次非交互调用确认脚本化场景也能用claude -p 用一句话说明这个项目是做什么的-p是打印模式适合在 CI 或批处理里调用。返回内容正常就说明安装彻底跑通。如果你更想先在网页里确认模型和 Key 是否可用可以打开 TaoToken 的模型对话页面https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite发一条消息试试能回就说明 Key 本身没问题问题就缩小到本地配置了。6. 本篇常见报错排查报错一无法加载文件 claude.ps1系统禁止运行脚本这是 PowerShell 执行策略拦的不是 Claude Code 的问题。先看当前策略Get-ExecutionPolicy如果是Restricted改成RemoteSigned管理员身份执行Set-ExecutionPolicy RemoteSigned -Force Get-ExecutionPolicyRemoteSigned的意思是本地脚本可跑、从网上下载的脚本需签名安全性和便利性平衡得比较好。企业环境如果被组策略锁死改不动就用会话级绕过Set-ExecutionPolicy Bypass -Scope Process这只对当前窗口生效关掉就恢复适合临时调试。报错二claude 命令找不到先确认命令实际路径Get-Command claude | Format-List Path如果找不到说明 npm 全局目录不在 PATH 里。查一下全局目录npm config get prefix把这个路径加进系统 PATH重开终端再试。报错三API 连接失败或 401先确认环境变量在重启后的窗口里存在$env:ANTHROPIC_BASE_URL $env:ANTHROPIC_AUTH_TOKEN -ne $null如果变量在但依然 401多半是 Key 复制时带了空格或换行重新去控制台复制一次。如果变量不在说明写的是当前会话级而不是用户级回到第 3 节用User参数重写。报错四模型名不识别settings.json里的model字段要和网关支持的模型名一致。不确定的话先去掉model字段用默认值跑通再回来指定。7. 长期编码就上 Coding Plan接入细节看文档如果你只是偶尔用 Claude Code 改改脚本按上面的环境变量加settings.json就够了。但如果你打算把它当成日常编码和 Agent 工作流的主力频繁调用、多项目切换建议直接上 TaoToken 的 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite配额和模型调度更适合长期跑。接入过程中如果遇到变量、策略、模型名对不上的情况先去 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite核对密钥状态再翻接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite对照参数。Windows 这套链路最容易翻车的就是执行策略和变量作用域两处把这两点确认死剩下的基本一次过。