
1. Windows 上从零跑通 Claude Code先搞清楚它到底解决什么问题Claude Code 是 Anthropic 推出的命令行编程代理你在终端里用自然语言描述需求它会读文件、改代码、跑命令、提交 Git。它不是一个编辑器插件而是一个能直接操作你项目目录的 Agent。对 Windows 用户来说它的价值在于不用离开终端就能完成「读代码 → 改代码 → 跑测试 → 提交」这条链路尤其适合维护老项目、批量重构、写脚本这类重复劳动多的场景。但 Windows 上直接装完 Claude Code 会遇到一个现实问题默认模型通道在国内网络环境下不可用终端会卡在鉴权或超时。所以完整的搭建路径其实是三段装 Node.js 和 Git 打底装 Claude Code 本体再用 CC-Switch 把模型通道切到可用的统一 Key 上。这篇就按这个顺序走一遍每一步都给可复制的命令和配置最后用claude --version加一次最小对话验证连通性。适合谁看刚接触 Claude Code 的 Windows 开发者、想把团队模型调用统一到一个 Key 上的工程负责人、以及被多环境切换搞烦了的人。前置依赖只有两个——Node.js 和 Git都是常规安装不涉及任何特殊网络工具。下面从环境准备开始。2. 前置依赖与 TaoToken 统一 Key 准备Node.js、Git 与 API 通道2.1 装 Node.js 并确认版本Claude Code 是 npm 全局包所以 Node.js 是硬依赖。去 Node.js 官网下 LTS 版本安装时勾选「Add to PATH」。装完开一个新的 PowerShell 窗口验证node -v npm -v正常会输出类似v20.11.0和10.2.4。如果提示「不是内部或外部命令」说明 PATH 没生效重开终端或重启一次。Node 版本建议 18 以上低于 18 有些依赖会报错。2.2 装 Git 并配置基础信息Git 同样是必需项Claude Code 的很多操作依赖它做版本控制。去 Git 官网下载 Windows 安装包一路默认下一步即可。装完验证git --version git config --global user.name 你的名字 git config --global user.email 你的邮箱git --version能输出git version 2.4x.x就说明装好了。后面两条是提交时的身份信息不配的话 Claude Code 帮你提交时会报错。2.3 设置 npm 镜像源加速下载国内直连 npm 官方源装全局包经常超时先切到国内镜像npm config get registry npm config set registry https://registry.npmmirror.com/ npm config get registry最后一条应该输出https://registry.npmmirror.com/。这一步只是加速包下载和模型调用通道是两回事别混淆。2.4 准备 TaoToken 统一 Key模型通道这边我用 TaoToken 做统一入口好处是一个 Key 管多个模型切换环境时不用到处改配置。先去控制台创建 API Key控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI Key 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite创建后复制那串 Key形如sk-xxxxxxxx先存到记事本里下一步配置要用。Base URL 统一用https://taotoken.net/api注意这个地址后面不加任何参数。如果你不确定该用哪个模型 ID可以先去模型对话页试一下模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite在对话页里选一个模型发一句话确认能正常返回再把这个模型 ID 填进 Claude Code 配置。这样能避免「配置写完了但模型名不对」这种低级返工。3. 安装 Claude Code 与 CC-Switch可复制的 settings.json 配置3.1 全局安装 Claude Code镜像源配好后直接全局装npm install -g anthropic-ai/claude-code装完验证版本claude --version正常输出类似2.1.81 (Claude Code)。如果报claude : 无法将“claude”项识别为 cmdlet...说明 npm 全局 bin 目录不在 PATH 里。用npm config get prefix看全局目录把它加到系统环境变量 Path 里重开终端再试。3.2 安装 CC-Switch 做多环境切换CC-Switch 是一个图形化的配置切换工具支持 Claude Code、Codex、Gemini 等多个客户端核心作用是让你在多个供应商/多套 Key 之间一键切换不用手动改配置文件。去它的 releases 页面下载 Windows 安装包项目地址https://github.com/farion1231/cc-switch下载页https://github.com/farion1231/cc-switch/releases找到 Windows 版本的安装包一般是.exe或.msi下载后直接安装。打开后默认没有任何供应商点右上角加号添加。3.3 手写 settings.json不装 CC-Switch 也能用CC-Switch 的本质是帮你改settings.json所以你完全可以跳过它直接手写配置文件。Claude Code 在 Windows 下的配置文件路径是C:\Users\你的用户名\.claude\settings.json如果.claude目录不存在手动建一个。写入以下内容把 Key 和模型 ID 换成你自己的{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_DEFAULT_HAIKU_MODEL: claude-haiku-4-5, ANTHROPIC_DEFAULT_SONNET_MODEL: claude-sonnet-4-5, ANTHROPIC_DEFAULT_OPUS_MODEL: claude-opus-4-5, ANTHROPIC_MODEL: claude-sonnet-4-5 }, includeCoAuthoredBy: false, language: 简体中文 }参数对照表参数名示例值作用说明ANTHROPIC_BASE_URLhttps://taotoken.net/apiAPI 网关地址所有请求走这里ANTHROPIC_AUTH_TOKENsk-你的密钥鉴权 Token访问通道的凭证ANTHROPIC_MODELclaude-sonnet-4-5默认主模型ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-4-5对应 Opus 档位ANTHROPIC_DEFAULT_SONNET_MODELclaude-sonnet-4-5对应 Sonnet 档位ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5对应 Haiku 档位轻量快速注意模型 ID 必须和 TaoToken 通道里实际可用的名称一致写错了会报模型不存在。不确定就去模型对话页确认。3.4 用 CC-Switch 管理多套配置如果你有多个项目、多套 Key手改 settings.json 很烦。CC-Switch 的做法是每套配置存一份点「启用」就实时写入 settings.json不用重启 Claude Code。添加供应商时把 Base URL 填https://taotoken.net/apiKey 填你的 TaoToken 密钥模型 ID 按上表填。保存后点启用它会自动同步到配置文件。3.5 Codex 用户的 auth.json 三件套如果你同时用 Codex它的配置在C:\Users\你的用户名\.codex\auth.json同样需要三件套Base URL、Key、Model ID。格式如下{ OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: sk-你的TaoToken密钥, OPENAI_MODEL: gpt-5 }Base URL、Key、Model ID 这三样在 Claude Code、Codex、Cline 里都是核心缺一个就连不上。Cline 的 MCP 配置也是同理在 MCP 设置里填这三项即可。4. 验证连通性claude --version 与最小对话请求4.1 版本检查配置写完后先确认 Claude Code 本身没问题claude --version输出2.1.81 (Claude Code)这类信息就说明本体正常。这一步不涉及网络纯粹验证安装。4.2 最小对话请求进入一个空目录启动 Claude Codecd D:\test-claude claude第一次启动会进入交互界面。直接输入一句最简单的话比如你好请回复连通成功四个字如果配置正确几秒内会返回内容。这一步验证的是「Key Base URL 模型 ID」三件套是否全部生效。返回正常就说明通道打通了。4.3 验证文件操作能力再试一个能体现 Agent 能力的动作。在目录里让它创建一个文件帮我创建一个 hello.py内容是打印 Hello TaoToken它会请求你确认写入操作确认后查看目录dir type hello.py能看到文件内容就说明读写链路正常。这一步比单纯对话更能验证 Claude Code 的完整能力。4.4 验证 Git 集成初始化一个仓库让它帮你提交git init然后在 Claude Code 里输入把当前目录的文件提交到 gitcommit message 写 init它会执行git add和git commit。如果报身份错误回到 2.2 检查user.name和user.email是否配了。5. 常见报错排查401、local proxy failed、reading choices、OAuth5.1 401 Unauthorized最常见。原因通常是 Key 写错、Key 过期、或者 Base URL 末尾多了斜杠。检查顺序打开settings.json确认ANTHROPIC_AUTH_TOKEN是完整的sk-开头字符串没有多余空格确认ANTHROPIC_BASE_URL是https://taotoken.net/api末尾不要加/v1或斜杠去控制台确认这个 Key 还有效、额度没耗尽改完保存重启 Claude Code 再试。CC-Switch 用户点一下「启用」重新写入即可。5.2 local proxy failed这个报错说明 Claude Code 尝试走本地代理但连不上。检查系统环境变量里有没有残留的HTTP_PROXY、HTTPS_PROXY指向一个已经关掉的本地端口。在 PowerShell 里查echo $env:HTTP_PROXY echo $env:HTTPS_PROXY如果有值且指向不存在的端口清掉Remove-Item Env:HTTP_PROXY Remove-Item Env:HTTPS_PROXY然后重开终端。注意这里说的是清理无效的本地代理残留不是让你去配代理。5.3 reading choices 相关报错这个通常出现在流式响应解析阶段报错信息里带reading choices或类似字段。原因一般是通道返回的响应格式和 Claude Code 预期的不一致多半是 Base URL 指错了端点。确认你填的是https://taotoken.net/api而不是某个具体模型的路径。如果换了模型 ID 后出现说明该模型 ID 在当前通道下不可用换回对话页验证过的模型名。5.4 OAuth 相关报错Claude Code 默认会尝试 OAuth 登录流程如果你用的是 API Key 模式这个流程会失败并报 OAuth 错误。解决办法是确保settings.json里配了ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL让它走 Key 鉴权而不是 OAuth。如果之前登录过官方账号可以清掉C:\Users\你的用户名\.claude下的凭据缓存文件再试。5.5 模型不存在 / model not found模型 ID 拼写错误或者该 ID 在你的通道下没有开通。回到模型对话页确认可用模型名复制准确的 ID 填进配置。注意大小写和连字符claude-sonnet-4-5和claude-sonnet-4.5是两回事。5.6 切换配置后不生效CC-Switch 点启用后如果没反应检查它写入的路径是不是C:\Users\你的用户名\.claude\settings.json。有些版本会写到项目级配置导致全局不生效。手动打开这个文件确认内容已经更新。另外 Claude Code 需要重启才能读取新的环境变量切换后关掉终端重开。6. 长期编码与 Agent 场景把统一 Key 用顺手的几个建议环境搭好只是开始真正提效在于把 Claude Code 用进日常流程。几个实操建议第一把settings.json纳入版本管理。团队里每个人用自己的 Key但 Base URL 和模型 ID 保持一致这样换人不用重新调通道。CC-Switch 的多配置功能适合在「个人 Key」和「团队 Key」之间切换。第二模型档位按任务分配。简单改错别字、写注释用 Haiku 档复杂重构、跨文件分析用 Sonnet 或 Opus 档。在 Claude Code 里可以用/model命令临时切换不用改配置文件。第三长任务用 Coding Plan。如果你要跑持续性的 Agent 任务、批量重构、或者让 Claude Code 长时间自主工作按量计费可能不好控成本包月式的 Coding Plan 更合适Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite第四接入文档常备。通道的端点、参数、模型列表会更新遇到不确定的先查文档接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite第五Claude Code 的 Agent 能力适合配合 Git 分支用。让它在一个 feature 分支上干活干完你 review diff 再合并比直接在主分支上改安全得多。它执行有风险的操作前会征求确认但养成分支习惯更稳妥。最后说一个我踩过的坑Windows 下路径分隔符和 Linux 不同Claude Code 执行 shell 命令时偶尔会因为路径写法报错。遇到这种情况在提示里明确说「用 Windows 路径格式」或者让它用 PowerShell 语法而不是 bash 语法能省不少来回。环境搭好之后剩下的就是多用让它熟悉你的项目结构效率会越来越明显。