1. Windows 下 Claude Code 与 CC-Switch 到底解决什么问题
如果你在 Windows 上想用 Claude Code 写代码，大概率会卡在三个地方：CLI 装不上、装上了不知道去哪配 Key、配好了 VS Code 里又调不通。Claude Code 本身是一个跑在终端里的 AI 编程 Agent，它能读你项目里的文件、执行命令、改代码，适合把「理解项目结构 + 批量改文件 + 跑测试」这类活交给它。CC-Switch 则是一个配置管理工具，帮你把不同供应商的 API Key 统一管起来，切换的时候不用手动改配置文件。
这套组合适合谁？一是刚接触 AI 编程助手、不想折腾 Anthropic 官方账号的 Windows 用户；二是手里已经有 TaoToken 这类统一 Key 通道、想让 Claude Code 和 VS Code 插件共用一套配置的开发者；三是需要在多个模型供应商之间来回切换、又不想每次重启 CLI 的人。我试过在 Windows 11 + PowerShell 7 环境下从零走一遍，下面把安装链路、配置文件骨架、连通性验证和常见报错都拆开讲，你跟着做基本能跑通。
核心检索词先明确：Claude Code 是 CLI 形态的 AI Agent，CC-Switch 是它的配置切换器，PowerShell 是 Windows 下的安装入口，VS Code 是最终验证调用的 IDE。整条链路的目标是：一条命令装好 CLI，一份配置接上 TaoToken 统一 Key，然后在 VS Code 里发一条请求确认通了。
2. TaoToken 前置准备：统一 Key 与 API 通道
在装 Claude Code 之前，先把 Key 和 API 通道准备好，否则装完 CLI 会直接弹 Anthropic 登录，卡在第一步。TaoToken 的作用是提供一个统一的 API 入口，你拿一个 Key 就能走 Claude 系列模型的调用通道，不用单独去开官方账号。
你需要做两件事：拿到 API Key，确认 API 基地址。官网入口在这里：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册后在控制台里创建 Key。API 基地址是 https://taotoken.net/api ，注意这个地址后面不加任何 UTM 参数，配置里要写干净。
具体操作路径：进控制台 → 找到 API Keys 管理页 → 新建一个 Key → 复制保存。这个 Key 后面要填进 CC-Switch 或者直接写进 Claude Code 的配置文件。如果你打算长期用 Claude Code 做编码和 Agent 任务，可以顺带看一下 Coding Plan 页面，它针对高频编码场景有更合适的额度方案；只是临时验证模型通不通，用普通 Key 就够了。
注意：Key 只在创建时完整显示一次，复制后存到密码管理器里。配置文件里不要把它提交到 Git 仓库。
拿到 Key 之后，先别急着装 CLI。很多人装完 Claude Code 直接运行claude，结果被引导去登录 Anthropic 账号，这是因为配置文件还没写。正确顺序是：先装 CLI，再用 CC-Switch 或手写配置把 Key 和 API 地址填进去，最后才启动。
3. 可复制配置：PowerShell 安装 + settings.json + config.toml
3.1 PowerShell 一键安装 Claude Code
Windows 下打开 PowerShell，建议用管理员身份运行，因为安装脚本要写环境变量。先设置执行策略，否则脚本会被拦：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser然后执行官方安装脚本：
irm https://claude.ai/install.ps1 | iex这条命令会下载最新版并配置环境变量。如果你想像我一样自定义安装目录，可以用社区维护的脚本，先给权限再指定目录：
.\update-cc.ps1 -InstallDir "F:\software\ClaudeCode"安装完成后，关掉当前 PowerShell 重新开一个，输入claude --version确认版本号能打印出来。如果提示找不到命令，说明环境变量没生效，重启终端或者手动把安装目录加进 PATH。
3.2 CC-Switch 安装与供应商配置
CC-Switch 下载地址在它的 GitHub 发布页，Windows 下直接下 exe 安装包。装完后打开，右上角加号添加供应商。在供应商类型里选自定义或对应的预设，填入两样东西：API Key 填你从 TaoToken 拿到的 Key，Base URL 填https://taotoken.net/api。保存后点测速，能返回延迟数字就说明通道通了。
CC-Switch 的好处是它常驻系统托盘，右键就能切换供应商，Claude Code 不用重启。它还支持 Skill 同步，你在 CC-Switch 里装一个 Skill，Claude Code 和 Codex 会自动同步，删改也同步。
3.3 settings.json 骨架
Claude Code 的配置分两层，一层是全局 settings.json，一层是项目级 config.toml。全局配置放在用户目录下的.claude文件夹里。一个可复制的最小骨架：
{ "apiKey": "sk-你的TaoToken密钥", "baseUrl": "https://taotoken.net/api", "model": "claude-sonnet-4-20250514", "env": { "ANTHROPIC_API_KEY": "sk-你的TaoToken密钥", "ANTHROPIC_BASE_URL": "https://taotoken.net/api" } }这里apiKey和env里的ANTHROPIC_API_KEY保持一致，baseUrl和ANTHROPIC_BASE_URL保持一致。有些版本只读 env 字段，有些只读顶层字段，两个都写上最稳。
3.4 config.toml 骨架
项目级配置放在项目根目录的.claude/config.toml，用来覆盖全局设置或指定项目专属模型：
[api] provider = "taotoken" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoToken密钥" [model] name = "claude-sonnet-4-20250514" max_tokens = 8192 [behavior] auto_approve_read = true auto_approve_write = falseauto_approve_read设成 true 表示读文件不用每次确认，写文件仍然要确认，这样既省事又不会让 Agent 乱改代码。参数对照可以看这张表：
| 配置项 | 作用 | 建议值 |
|---|---|---|
| base_url | API 通道地址 | https://taotoken.net/api |
| api_key | 统一 Key | 控制台创建的 Key |
| model | 默认模型 | claude-sonnet-4-20250514 |
| max_tokens | 单次输出上限 | 8192 |
| auto_approve_read | 读文件免确认 | true |
| auto_approve_write | 写文件免确认 | false |
4. 验证请求：一条命令确认连通性
配置写完后，最直接的验证方式是在终端里跑一条非交互命令。Claude Code 支持-p参数直接传 prompt：
claude -p "用一句话说明当前目录下有哪些文件类型"如果返回了正常文本，说明 Key、Base URL、模型三者都通了。如果报 401，是 Key 错了；报 404，是 Base URL 写错了或者多了斜杠；报模型不存在，是 model 名字不对。
再验证一次带文件读取的场景，确认 Agent 能访问项目：
claude -p "读取 package.json 并告诉我项目用了哪些依赖"成功的话它会列出依赖名。这一步过了，说明 CLI 链路完整。
接下来在 VS Code 里验证。先装 Claude Code 的 VS Code 插件，插件会提示安装 SDK，装完后它复用本地 CLI 的配置，不用重新登录。装好后侧边栏会出现 Claude 面板，在里面发一条消息，比如「分析当前打开文件的函数结构」，能返回结果就说明 IDE 集成也通了。
如果你更习惯命令行，在 VS Code 内置终端里直接跑claude进入交互模式，用@引用具体文件，比如@src/main.py 帮我找出未处理的异常，结果会以 Markdown 形式呈现。
5. 本篇常见错排查
5.1 安装脚本乱码
用 VS Code 打开update-cc.ps1，点右下角编码显示（通常显示 UTF-8），选「Save with Encoding」，改成「UTF-8 with BOM」，保存后重新运行。PowerShell 5.1 对无 BOM 的 UTF-8 中文注释容易解析出错。
5.2 提示语法错误「包含意外的标记」
报错原因是脚本里用了??空合并运算符，这是 PowerShell 7+ 才支持的语法，Windows 自带的 5.1 不认识。两个解法：一是升级 PowerShell，跑winget install Microsoft.PowerShell，装完输入pwsh进新版环境；二是改用兼容写法，把??换成if ($null -eq $x) { ... }。
5.3 一直提示 Not logged in
VS Code 插件偶尔会这样，多重启几次 IDE 通常就好了。如果还不行，检查全局 settings.json 里的ANTHROPIC_API_KEY是否和 CC-Switch 里填的一致。两边不一致时，插件读到的 Key 是空的，就会判定未登录。
5.4 外部 IDE 连接找不到项目文件
从 IDE 项目根目录相同的路径启动 Claude Code，否则 Agent 的工作目录不对，找不到文件。在 PyCharm 里用/ide命令连接时，插件设置里有两个选项不要勾选，勾了反而会干扰路径识别。重启 IDE 后再进选择页面就能看到目标项目。
5.5 常用斜杠命令速查
| 命令 | 功能 | 使用场景 |
|---|---|---|
| /help | 查看帮助 | 初次使用 |
| /logout | 登出当前账号 | 切换 API 时 |
| /clear | 清除对话记录 | 开始新话题 |
| /resume | 恢复历史对话 | 继续之前工作 |
| /compact | 压缩上下文 | 对话过长 |
| /init | 初始化项目配置 | 新项目首次 |
| /status | 查看系统状态 | 排查问题 |
所有斜杠命令都要在行首单独输入，前面不能有空格或其他字符。
6. 接入文档与后续动作
配置跑通之后，日常使用就是claude进交互模式，或者用-p跑单次任务。如果你要管理多个 Key 或者查看调用量，去控制台页面操作；要新建或轮换 Key，去 API Keys 页面；接入细节和参数说明看接入文档。这三类入口分别对应不同动作，排障和接入优先看 API Keys 和文档，验证模型通不通用模型对话页面发一条测试消息，长期做编码和 Agent 任务则看 Coding Plan 的额度方案。
一个实用技巧：把项目级的.claude/config.toml加进.gitignore，避免 Key 泄露。全局配置里的 Key 用环境变量引用而不是明文，比如在 PowerShell 里设$env:ANTHROPIC_API_KEY，配置文件里写"apiKey": "${ANTHROPIC_API_KEY}"，这样换机器时只改环境变量就行。
