1. Windows 上跑 Claude Code卡住新手的三个地方Claude Code 是 Anthropic 官方推出的终端 AI 编程助手能直接读取整个项目、改文件、跑命令和网页版对话最大的区别是它真的“动手”。但它在 Windows 上的安装链路比 macOS 长一截Node.js 环境、PowerShell 脚本策略、npm 全局路径、环境变量刷新每一步都可能让claude命令找不到。更麻烦的是很多人装完之后想换一个 API 通道手动改ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY改到崩溃终端重启一次就失效。这篇教程面向 Windows 10 1809 / Windows 11 的零基础用户把从零到可用的完整链路拆开先装 Git 和 Node.js再装 Claude Code然后用 cc-switch 做多通道切换最后把 TaoToken 的统一 Key 接进去。全程给可复制的settings.json、config.toml骨架和逐条验证命令遇到报错直接对照第五节排查。适合谁刚接触命令行、想用 Claude Code 写代码但被环境劝退的 Windows 用户以及需要在国内网络环境下稳定调用模型的开发者。2. 前置准备TaoToken 统一 Key 与 API 通道在动手装 Claude Code 之前先把“钥匙”准备好。Claude Code 默认走 Anthropic 官方接口但官方订阅和网络条件对不少人不友好。TaoToken 提供统一的 API 通道一个 Key 就能对接 Claude 系列模型配合 cc-switch 可以在多个供应商之间一键切换不用每次手改环境变量。你需要先拿到两样东西Base URL 和 API Key。访问官网注册后在控制台创建 API Key复制出来备用。Base URL 统一使用https://taotoken.net/api注意这个地址不带任何查询参数填进配置时不要画蛇添足加斜杠或路径。注意API Key 只在创建时完整显示一次复制后先存到记事本或密码管理器后面 cc-switch 和settings.json都要用。如果你还没创建 Key可以走这个入口API Keys 管理页https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。创建时给 Key 起个能识别的名字比如windows-claude-code方便以后在 cc-switch 里对应。3. 可复制配置从 Node.js 到 cc-switch 全链路3.1 安装 Git 与 Node.jsClaude Code 的部分功能依赖 Git先装它。到 Git 官网下载 Windows 安装包安装时 PATH 环境那一步选 “Git from the command line and also from 3rd-party software”其余保持默认。装完打开新的命令提示符验证git --version看到git version 2.x.x.windows.1就对了。接着装 Node.js去官网点 LTS 版本下载.msi安装时务必保留 npm 和 Add to PATH 两个组件。装完必须开一个新终端窗口执行node --version npm --version两个版本号都出来才算成功。如果提示“不是内部或外部命令”说明 PATH 没生效关掉所有终端重开仍不行就手动把C:\Program Files\nodejs加到系统变量 Path 里。3.2 安装 Claude Code推荐用原生安装脚本比 npm 全局安装少踩权限坑。以管理员身份打开 PowerShell先放开脚本执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认然后执行官方安装脚本irm https://claude.ai/install.ps1 | iex等下载安装完成验证claude --version有版本号输出即安装成功。如果你更习惯 npm也可以npm install -g anthropic-ai/claude-code但 Windows 上偶尔会遇到全局路径不在 PATH 的问题原生脚本更省心。3.3 用 cc-switch 管理多通道cc-switch 是一个开源桌面工具专门解决 Claude Code 多 API 配置切换的问题。去它的 GitHub Releases 页面下载 Windows 版推荐.msi安装版双击按向导走完。启动后它会自动检测已安装的 Claude Code并最小化到系统托盘。打开 cc-switch左侧选 Claude 分组点右上角 “” 添加供应商选“自定义配置”。各字段这样填字段填写内容Provider NameTaoTokenBase URLhttps://taotoken.net/apiAPI Key你在控制台创建的 KeyAPI FormatAnthropic Messages原生env.ANTHROPIC_API_KEY与上方 API Key 一致env.ANTHROPIC_BASE_URL与上方 Base URL 一致填完保存点“应用”或“切换”cc-switch 会自动把环境变量写进 Claude Code 的配置。切换后必须开一个新的终端窗口再启动claude旧窗口的环境变量不会更新。3.4 settings.json 与 config.toml 骨架如果你不想依赖 cc-switch 的自动写入也可以手动维护配置文件。Claude Code 在 Windows 下的用户级配置通常位于C:\Users\你的用户名\.claude\settings.json骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key }, permissions: { allow: [], deny: [] } }如果你同时用 Codex 类工具config.toml可以这样写model claude-sonnet-4-5 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key ANTHROPIC_API_KEY提示手动改完settings.json后同样要重开终端。JSON 里不要写注释尾逗号也会导致解析失败。4. 验证请求确认通道真的通了配置写完不算完得验证请求能打到模型上。开一个新的 PowerShell 窗口先确认环境变量已经生效echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_API_KEY第一条应该输出https://taotoken.net/api第二条输出你的 Key部分显示即可。如果为空说明 cc-switch 没写入或你改的是用户级配置但当前终端没加载重开终端再试。然后启动 Claude Codeclaude首次启动会提示登录如果你已经通过环境变量配好了 Key通常可以直接进入对话。输入一句测试你好请用一句话介绍你自己能正常回复就说明通道打通了。再做一个更贴近实际的动作让它读当前目录列出当前目录下的文件并说明这个项目大概是什么如果它能调用工具读取文件并给出合理回答说明不仅 API 通了工具调用链路也正常。这一步很关键因为有些通道只支持纯对话不支持 tool useClaude Code 的核心能力就废了一半。想单独验证模型对话是否正常也可以走模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite在网页里发一条消息对照结果。5. 本篇常见报错逐条排查报错一claude : 无法加载文件因为在此系统上禁止运行脚本这是 PowerShell 执行策略拦的。执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认然后重新跑安装脚本。报错二claude不是内部或外部命令先关掉所有终端窗口重开。仍不行就检查 Node.js 安装时有没有勾 Add to PATH或者手动把 npm 全局目录加进 Path。用npm config get prefix能看到全局路径。报错三启动后提示401 Unauthorized或invalid api key九成是 Key 复制时带了空格或换行。重新在控制台复制一次粘贴到 cc-switch 或settings.json时注意首尾不要有空白。另外确认 Base URL 是https://taotoken.net/api不要多加/v1之类的路径。报错四cc-switch 切换后 Claude Code 仍走旧通道旧终端的环境变量是启动时快照的切换后必须开新终端。如果新终端还是旧值去 cc-switch 里确认当前选中的供应商是 TaoToken并点一次“应用”。报错五npm install -g报权限不足用管理员身份打开 PowerShell 再执行。或者干脆改用原生安装脚本绕开 npm 全局路径问题。报错六对话能通但工具调用失败说明当前通道不支持 Anthropic 的 tool use 格式。确认 cc-switch 里 API Format 选的是 “Anthropic Messages原生”而不是 OpenAI 兼容格式。格式选错会导致 Claude Code 读文件、跑命令全部失效。报错七Windows Defender 拦截安装包属于误报点“更多信息”→“仍要运行”。如果反复拦截把安装目录临时加入 Defender 排除项。6. 长期编码与 Agent 场景的接入建议如果你只是偶尔用 Claude Code 改改脚本上面的配置够用了。但如果你打算把它当成日常编码主力或者跑 Agent 类任务建议把通道和额度管理做得更规范一些。长期高频调用时Coding Plan 比按量计费更划算也方便团队统一管理 Key。入口在这里Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。接入文档里有更完整的参数说明和不同客户端的配置示例遇到本文没覆盖的客户端可以对照查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。如果你用的是 Claude Code 的 Anthropic 原生协议也可以参考 ClaudeCodeAnthropic 专项说明https://taotoken.net/doc/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_anthropicutm_campaignrewrite。最后留一个我踩过的坑cc-switch 的配置是写进用户级环境变量的如果你同时在 WSL 里跑 Claude CodeWSL 不会继承 Windows 的用户环境变量需要在 WSL 的~/.bashrc里单独 export 一遍。两边共用同一个 Key 没问题但配置要各写各的。
Windows版Claude Code保姆级安装与配置教程：用TaoToken统一Key打通cc-switch
1. Windows 上跑 Claude Code卡住新手的三个地方Claude Code 是 Anthropic 官方推出的终端 AI 编程助手能直接读取整个项目、改文件、跑命令和网页版对话最大的区别是它真的“动手”。但它在 Windows 上的安装链路比 macOS 长一截Node.js 环境、PowerShell 脚本策略、npm 全局路径、环境变量刷新每一步都可能让claude命令找不到。更麻烦的是很多人装完之后想换一个 API 通道手动改ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY改到崩溃终端重启一次就失效。这篇教程面向 Windows 10 1809 / Windows 11 的零基础用户把从零到可用的完整链路拆开先装 Git 和 Node.js再装 Claude Code然后用 cc-switch 做多通道切换最后把 TaoToken 的统一 Key 接进去。全程给可复制的settings.json、config.toml骨架和逐条验证命令遇到报错直接对照第五节排查。适合谁刚接触命令行、想用 Claude Code 写代码但被环境劝退的 Windows 用户以及需要在国内网络环境下稳定调用模型的开发者。2. 前置准备TaoToken 统一 Key 与 API 通道在动手装 Claude Code 之前先把“钥匙”准备好。Claude Code 默认走 Anthropic 官方接口但官方订阅和网络条件对不少人不友好。TaoToken 提供统一的 API 通道一个 Key 就能对接 Claude 系列模型配合 cc-switch 可以在多个供应商之间一键切换不用每次手改环境变量。你需要先拿到两样东西Base URL 和 API Key。访问官网注册后在控制台创建 API Key复制出来备用。Base URL 统一使用https://taotoken.net/api注意这个地址不带任何查询参数填进配置时不要画蛇添足加斜杠或路径。注意API Key 只在创建时完整显示一次复制后先存到记事本或密码管理器后面 cc-switch 和settings.json都要用。如果你还没创建 Key可以走这个入口API Keys 管理页https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。创建时给 Key 起个能识别的名字比如windows-claude-code方便以后在 cc-switch 里对应。3. 可复制配置从 Node.js 到 cc-switch 全链路3.1 安装 Git 与 Node.jsClaude Code 的部分功能依赖 Git先装它。到 Git 官网下载 Windows 安装包安装时 PATH 环境那一步选 “Git from the command line and also from 3rd-party software”其余保持默认。装完打开新的命令提示符验证git --version看到git version 2.x.x.windows.1就对了。接着装 Node.js去官网点 LTS 版本下载.msi安装时务必保留 npm 和 Add to PATH 两个组件。装完必须开一个新终端窗口执行node --version npm --version两个版本号都出来才算成功。如果提示“不是内部或外部命令”说明 PATH 没生效关掉所有终端重开仍不行就手动把C:\Program Files\nodejs加到系统变量 Path 里。3.2 安装 Claude Code推荐用原生安装脚本比 npm 全局安装少踩权限坑。以管理员身份打开 PowerShell先放开脚本执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认然后执行官方安装脚本irm https://claude.ai/install.ps1 | iex等下载安装完成验证claude --version有版本号输出即安装成功。如果你更习惯 npm也可以npm install -g anthropic-ai/claude-code但 Windows 上偶尔会遇到全局路径不在 PATH 的问题原生脚本更省心。3.3 用 cc-switch 管理多通道cc-switch 是一个开源桌面工具专门解决 Claude Code 多 API 配置切换的问题。去它的 GitHub Releases 页面下载 Windows 版推荐.msi安装版双击按向导走完。启动后它会自动检测已安装的 Claude Code并最小化到系统托盘。打开 cc-switch左侧选 Claude 分组点右上角 “” 添加供应商选“自定义配置”。各字段这样填字段填写内容Provider NameTaoTokenBase URLhttps://taotoken.net/apiAPI Key你在控制台创建的 KeyAPI FormatAnthropic Messages原生env.ANTHROPIC_API_KEY与上方 API Key 一致env.ANTHROPIC_BASE_URL与上方 Base URL 一致填完保存点“应用”或“切换”cc-switch 会自动把环境变量写进 Claude Code 的配置。切换后必须开一个新的终端窗口再启动claude旧窗口的环境变量不会更新。3.4 settings.json 与 config.toml 骨架如果你不想依赖 cc-switch 的自动写入也可以手动维护配置文件。Claude Code 在 Windows 下的用户级配置通常位于C:\Users\你的用户名\.claude\settings.json骨架如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的Key }, permissions: { allow: [], deny: [] } }如果你同时用 Codex 类工具config.toml可以这样写model claude-sonnet-4-5 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key ANTHROPIC_API_KEY提示手动改完settings.json后同样要重开终端。JSON 里不要写注释尾逗号也会导致解析失败。4. 验证请求确认通道真的通了配置写完不算完得验证请求能打到模型上。开一个新的 PowerShell 窗口先确认环境变量已经生效echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_API_KEY第一条应该输出https://taotoken.net/api第二条输出你的 Key部分显示即可。如果为空说明 cc-switch 没写入或你改的是用户级配置但当前终端没加载重开终端再试。然后启动 Claude Codeclaude首次启动会提示登录如果你已经通过环境变量配好了 Key通常可以直接进入对话。输入一句测试你好请用一句话介绍你自己能正常回复就说明通道打通了。再做一个更贴近实际的动作让它读当前目录列出当前目录下的文件并说明这个项目大概是什么如果它能调用工具读取文件并给出合理回答说明不仅 API 通了工具调用链路也正常。这一步很关键因为有些通道只支持纯对话不支持 tool useClaude Code 的核心能力就废了一半。想单独验证模型对话是否正常也可以走模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite在网页里发一条消息对照结果。5. 本篇常见报错逐条排查报错一claude : 无法加载文件因为在此系统上禁止运行脚本这是 PowerShell 执行策略拦的。执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认然后重新跑安装脚本。报错二claude不是内部或外部命令先关掉所有终端窗口重开。仍不行就检查 Node.js 安装时有没有勾 Add to PATH或者手动把 npm 全局目录加进 Path。用npm config get prefix能看到全局路径。报错三启动后提示401 Unauthorized或invalid api key九成是 Key 复制时带了空格或换行。重新在控制台复制一次粘贴到 cc-switch 或settings.json时注意首尾不要有空白。另外确认 Base URL 是https://taotoken.net/api不要多加/v1之类的路径。报错四cc-switch 切换后 Claude Code 仍走旧通道旧终端的环境变量是启动时快照的切换后必须开新终端。如果新终端还是旧值去 cc-switch 里确认当前选中的供应商是 TaoToken并点一次“应用”。报错五npm install -g报权限不足用管理员身份打开 PowerShell 再执行。或者干脆改用原生安装脚本绕开 npm 全局路径问题。报错六对话能通但工具调用失败说明当前通道不支持 Anthropic 的 tool use 格式。确认 cc-switch 里 API Format 选的是 “Anthropic Messages原生”而不是 OpenAI 兼容格式。格式选错会导致 Claude Code 读文件、跑命令全部失效。报错七Windows Defender 拦截安装包属于误报点“更多信息”→“仍要运行”。如果反复拦截把安装目录临时加入 Defender 排除项。6. 长期编码与 Agent 场景的接入建议如果你只是偶尔用 Claude Code 改改脚本上面的配置够用了。但如果你打算把它当成日常编码主力或者跑 Agent 类任务建议把通道和额度管理做得更规范一些。长期高频调用时Coding Plan 比按量计费更划算也方便团队统一管理 Key。入口在这里Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。接入文档里有更完整的参数说明和不同客户端的配置示例遇到本文没覆盖的客户端可以对照查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。如果你用的是 Claude Code 的 Anthropic 原生协议也可以参考 ClaudeCodeAnthropic 专项说明https://taotoken.net/doc/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_anthropicutm_campaignrewrite。最后留一个我踩过的坑cc-switch 的配置是写进用户级环境变量的如果你同时在 WSL 里跑 Claude CodeWSL 不会继承 Windows 的用户环境变量需要在 WSL 的~/.bashrc里单独 export 一遍。两边共用同一个 Key 没问题但配置要各写各的。