Windows 上跑 ClaudeCode 的安装指南：从环境准备到 TaoToken 接入

1. Windows 上跑 ClaudeCode 到底卡在哪ClaudeCode 是 Anthropic 推出的命令行编程助手能在终端里直接读写项目文件、跑命令、改代码适合习惯用 CLI 干活的开发者。但它原生面向 macOS/Linux 设计Windows 上直接装会遇到一堆坑Git Bash 路径找不到、环境变量不生效、npm 全局包权限报错、终端重启后配置丢失。很多人装到一半就放弃了。这篇面向 Windows 开发者把 ClaudeCode 从零到能跑通的完整流程拆开讲包括 Node/Git 环境准备、npm 安装、settings.json 配置骨架、TaoToken 统一 Key 接入以及几个高频报错的排查方法。装完之后你可以用一条命令验证是否真的调通了而不是装完发现claude -v能出版本号、一对话就报 401。适合人群Windows 10/11 开发者、想用 ClaudeCode 做日常编码或 Agent 任务、之前装过但被环境变量或 shell 报错劝退的人。全程命令可直接复制配置骨架可直接改 Key 使用。2. 装 ClaudeCode 前先把 TaoToken 通道准备好ClaudeCode 本身只是个客户端它需要往一个兼容 Anthropic 协议的 API 地址发请求。默认走官方地址但国内直连经常超时或额度受限。TaoToken 提供统一的 Key 和 API 通道把模型调用收敛到一个入口ClaudeCode、Coding Plan、模型对话都共用同一套凭证省得每个工具单独配一遍。你需要提前拿到两样东西一个 API Key以及确认接入地址。Key 在控制台的 API Keys 页面创建接入文档里有各客户端的配置示例。地址方面官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个不加 UTM。注意ClaudeCode 走的是 Anthropic 协议配置时填的是ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN这两个变量不要和 OpenAI 那套OPENAI_API_KEY混用。填错变量名是最常见的 401 来源。如果你后面还要跑长期编码任务或 Agent 工作流可以顺带了解 Coding Plan它和 ClaudeCode 共用同一套 Key切换成本很低。先把 Key 建好下一步直接进配置。3. 可复制的安装与配置步骤3.1 装 Git 和 Node.jsClaudeCode 依赖 Git Bash 作为 shell也依赖 Node 的 npm 来安装。两个都从官网下 Windows 安装包一路下一步不要改路径——改路径是后面No suitable shell found的高发原因。Git 下载页https://git-scm.com/downloads/win Node.js 下载页https://nodejs.org/zh-cn/download装完打开 Windows PowerShell蓝色图标那个验证node -v npm -v两条都能输出版本号就说明环境 OK。如果node -v报「不是内部或外部命令」说明 Node 没进 PATH重装并勾选 Add to PATH。3.2 安装 ClaudeCode先卸掉可能存在的旧版本避免版本冲突npm uninstall -g anthropic-ai/claude-code再装官方包npm install -g anthropic-ai/claude-code如果 npm 报权限错误EACCES 或 EPERM用管理员身份打开 PowerShell 再执行一次。装完先别急着配 Key先确认命令存在claude -v能出版本号说明二进制装好了。这一步报No suitable shell found的话往下看第 5 节的排查。3.3 设置系统环境变量在 Windows 开始菜单搜「编辑系统环境变量」打开系统属性窗口点「环境变量」。这里有个容易踩的坑用户变量和系统变量里可能已经存在同名变量新建前先完整检查两处有就先删掉再建否则旧值会覆盖新值。需要设置三个变量变量名变量值ANTHROPIC_BASE_URLhttps://taotoken.net/apiANTHROPIC_API_KEY你的 TaoToken KeyANTHROPIC_AUTH_TOKEN你的 TaoToken KeyANTHROPIC_API_KEY和ANTHROPIC_AUTH_TOKEN填同一个 Key 即可ClaudeCode 在不同版本里读的变量名略有差异两个都配上最稳。新建完变量必须重启终端才生效重启终端还不行就重启电脑。3.4 settings.json 配置骨架除了环境变量ClaudeCode 还支持用settings.json做更细的控制。文件放在用户目录下的.claude文件夹里路径是C:\Users\你的用户名\.claude\settings.json。没有这个文件夹就手动建一个。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的 TaoToken Key, ANTHROPIC_API_KEY: 你的 TaoToken Key }, permissions: { allow: [], deny: [] } }env块里的变量会覆盖系统环境变量优先级更高适合你想给 ClaudeCode 单独指定通道的场景。permissions用来控制它能自动执行哪些操作初期留空即可等熟悉了再按需放开。改完保存重启终端。提示settings.json 里 Key 是明文别把这个文件提交到 Git 仓库。可以在项目.gitignore里加上.claude/。4. 验证安装与调用是否成功配置完重启 PowerShell先确认版本claude -v然后进一个测试目录直接发起一次对话验证 API 通道是否真的通cd D:\test-project claude 用一句话说明这个目录里有哪些文件如果返回了模型生成的回答说明 Key、Base URL、shell 全部打通。如果报 401是 Key 或变量名的问题报连接超时是 Base URL 填错或网络问题报No suitable shell found回到第 5 节。想更直观地验证模型通道也可以直接在模型对话页面发一条消息确认同一个 Key 在网页端能正常返回这样能把「Key 本身有效」和「ClaudeCode 配置有误」两种情况区分开。5. 本篇常见报错排查5.1 No suitable shell found这是 Windows 上最高频的报错根因是 ClaudeCode 找不到 Git Bash。解决方法是显式指定 bash 路径新建系统环境变量CLAUDE_CODE_GIT_BASH_PATHC:\Program Files\git\bin\bash.exe设完重启终端。如果还报说明 Git 装的位置不对或装坏了重装 Git保持默认路径再重启终端。确认路径是否存在可以在 PowerShell 里跑Test-Path C:\Program Files\git\bin\bash.exe返回 True 才说明路径对。5.2 401 Unauthorized按顺序排查Key 是否复制完整前后别带空格ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY是否都填了Base URL 是否写成https://taotoken.net/api而不是带/v1或其他后缀settings.json 和环境变量是否冲突。改完必须重启终端。5.3 环境变量改了不生效Windows 的环境变量对已打开的终端不生效。关掉所有 PowerShell 窗口重新开还不行就重启电脑。另外检查用户变量和系统变量里是否有同名旧变量旧值会优先删掉再建。5.4 npm 全局安装权限错误用管理员身份打开 PowerShell 再执行npm install -g。如果公司电脑锁了管理员权限可以改用 nvm-windows 管理 Node 版本把全局包目录指到用户目录下避开系统目录写权限问题。6. 配好之后怎么继续用装通只是第一步。日常用 ClaudeCode 做编码建议把常用项目的权限在 settings.json 的permissions.allow里逐步放开减少每次确认的打断。Key 和通道统一走 TaoToken 之后ClaudeCode、Coding Plan、模型对话共用一套凭证换工具不用重新配。如果后面要跑长时间编码或 Agent 任务直接看 Coding Plan 的接入方式它和 ClaudeCode 是同一套 Key配置逻辑一致。接入过程中遇到变量名或路径问题对照 API Keys 页面和接入文档核对一遍多数报错都能定位到具体是 Key、URL 还是 shell 路径的问题。