1. 为什么要在 Mac / Windows 上把 Claude Code 装进 VS CodeClaude Code 是 Anthropic 推出的终端 AI 编程助手能直接读取你本地的代码库、改文件、跑测试、修 Bug。它最大的价值不是聊天而是动手——你说一句把 utils 里的日期格式化函数改成支持时区它真的会去改代码。适合谁适合已经在用 VS Code 写代码、又想让 AI 真正参与工程流程的人。但很多人卡在第一步装不上或者装上了连不通。Mac 和 Windows 的坑还不一样——Mac 上 Homebrew 没装、PATH 没配Windows 上 PowerShell 和 CMD 命令混用、Git Bash 缺失导致体验降级。更麻烦的是鉴权官方订阅门槛高第三方 API 又要手动改配置文件改错一个字段就报 401。这篇教程把整条链路拆开Node.js 版本校验 → Git 安装 → Claude Code 安装 → TaoToken 统一 Key 配置 → VS Code 插件挂载 → curl 验证通道连通。每一步都给可复制的命令和配置骨架Mac 和 Windows 分开写。装完之后你终端里敲claude能跑VS Code 里也能用同一套 Key不用来回切账号。我试过在 M 系列 Mac 和 Windows 11 上各跑一遍下面按实际顺序来。2. 前置准备Node.js、Git 与 TaoToken 统一 KeyClaude Code 的运行依赖两样东西Node.js≥18和 Git。Node.js 是运行时Git 不只是版本控制——Windows 上 Claude Code 优先调用 Git Bash 执行命令没有 Git 会降级到 PowerShell很多 shell 语法会出问题。2.1 Node.js 版本校验先别急着装先看现有版本。Mac 打开终端Windows 打开 PowerShell输入node -v如果输出v18.x.x以上就跳过安装。低于 18 或者提示command not found按下面装。Mac 用 Homebrewbrew install node没装 Homebrew 的话先执行官方安装脚本/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)Windows 直接去 Node.js 官网下载 LTS 版安装包双击一路下一步。装完重开终端再验一次node -v。2.2 Git 安装与校验Mac 通常自带没有就brew install git或者装 Xcode 命令行工具xcode-select --installWindows 去 git-scm.com 下载安装包默认配置即可建议装到 C 盘。装完验证git --version注意Windows 上如果git --version报错Claude Code 会降级用 PowerShell届时像链式命令、部分路径写法都会失效务必先把 Git 装好。2.3 TaoToken 统一 Key 的作用Claude Code 默认要绑 Anthropic 官方订阅免费账号不支持。TaoToken 在这里的角色是提供一个统一的 API 通道和 Key让你不用改 Claude Code 的源码只通过配置文件把请求指向 TaoToken 的接口就能在 VS Code 和终端里共用同一套鉴权。你需要准备两样东西一个 TaoToken 的 API Key以及接口地址https://taotoken.net/api。Key 在控制台生成后面配置里会用到。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 的配置分两层一层是 Claude Code 自己的配置文件一层是 VS Code 插件的设置。下面给的是骨架把YOUR_TAOTOKEN_KEY换成你自己的 Key 即可。3.1 Claude Code 配置文件config.tomlClaude Code 读取的配置目录Mac 在~/.claude/Windows 在%USERPROFILE%\.claude\。新建或编辑config.toml# ~/.claude/config.toml api_base_url https://taotoken.net/api api_key YOUR_TAOTOKEN_KEY [model] default claude-sonnet-4-20250514这里api_base_url指向 TaoToken 的 API 地址api_key填你在控制台生成的 Key。模型名按你实际可用的填不确定就先留默认。3.2 VS Code 插件设置settings.jsonVS Code 的settings.json里加上插件相关配置让插件走同一套通道{ claudeCode.apiBaseUrl: https://taotoken.net/api, claudeCode.apiKey: YOUR_TAOTOKEN_KEY, claudeCode.autoStart: true }Mac 的路径是~/Library/Application Support/Code/User/settings.jsonWindows 是%APPDATA%\Code\User\settings.json。你也可以在 VS Code 里按CmdShiftPMac或CtrlShiftPWindows输入 Open User Settings (JSON) 直接打开。提示两个文件里的 Key 必须一致否则终端能跑、VS Code 报 401这种半通状态最难查。3.3 用 CC Switch 做多配置切换如果你要在多个 Key 或多个模型之间切换手动改配置文件太累。CC Switch 是个可视化管理工具能一键切换底层模型和 Key。装好之后在界面里添加供应商接口地址填https://taotoken.net/api粘贴 Key保存后点切换即可。切换完终端重开一个会话就生效。4. 安装 Claude Code 并验证请求连通配置准备好接下来装 Claude Code 本体然后用一条 curl 确认通道真的通。4.1 Mac 安装推荐终端脚本安装装完自动后台更新curl -fsSL https://claude.ai/install.sh | bash也可以用 Homebrewbrew install --cask claude-codeHomebrew 版不自动更新升级要手动brew upgrade claude-code。4.2 Windows 安装PowerShell推荐irm https://claude.ai/install.ps1 | iexCMD 命令提示符curl -fsSL https://claude.ai/install.cmd -o install.cmd install.cmd del install.cmd或者用 WinGetwinget install Anthropic.ClaudeCode怎么区分自己在哪个终端提示符带PS C:\是 PowerShell只有C:\是 CMD。报无效说明在 PowerShell改用irm那条报irm不是内部命令说明在 CMD改用curl那条。4.3 验证安装claude --version正常输出版本号就装好了。异常的话跑一次全局检测claude doctor它会逐项检查 Node、Git、配置路径按提示修。4.4 用 curl 验证 TaoToken 通道在启动 Claude Code 之前先用 curl 确认 Key 和接口是通的这样能把配置问题和安装问题分开curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: YOUR_TAOTOKEN_KEY \ -H anthropic-version: 2023-06-01 \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: ping}] }返回里带content字段和一段文本说明通道连通、Key 有效。如果返回 401是 Key 错了返回 404是接口路径写错了超时则是网络层问题先排查本地网络。4.5 启动并挂载 VS Code终端直接输入claude首次运行会读config.toml走 TaoToken 通道。然后在 VS Code 里按CmdShiftXMac或CtrlShiftXWindows打开插件市场搜 Claude Code装官方 Anthropic 插件。装完按CmdShiftP/CtrlShiftP输入 Claude Code选 Open in New Tab 就能在编辑器里用同一套 Key 对话和改代码。5. 本篇常见报错排查装的过程中最容易撞的几个错按现象对号入座。command not found: claude安装脚本跑完了但 PATH 没刷新。Mac 重启终端或手动把安装目录加进~/.zshrcWindows 重开 PowerShell。node: command not foundNode.js 没装或没进环境变量。重装 Node.jsWindows 安装时勾选 Add to PATH。Windows 安装报权限错误用管理员身份运行 PowerShell 或 CMD再执行安装命令。claude doctor报 Git 路径未识别Git 装了但没进 PATH。Windows 重新跑 Git 安装包选 Use Git from the Windows Command Prompt。VS Code 插件报 401 但终端正常settings.json里的 Key 和config.toml不一致或者插件没重启。改完 Key 后完全退出 VS Code 再打开。CC Switch 切换后不生效切换只改配置文件已开的 Claude Code 会话不会热加载。关掉终端会话重开。curl 返回 404接口路径写错。确认用的是https://taotoken.net/api/v1/messages不要多加或漏掉/v1。6. 装完之后把 Key 管起来别散落各处一次跑通之后真正要养成的习惯是Key 只在一处维护。终端配置、VS Code 设置、CC Switch 三处如果各写一份改一次要改三个地方迟早对不上。建议以config.toml为准VS Code 的settings.json只做引用切换模型统一走 CC Switch。如果你后面要长期跑编码任务或者接 Agent 流程可以了解下 Coding Plan把额度集中管理只是偶尔验证模型效果用模型对话页面就够了。Key 的生成和管理都在 API Keys 页面接入细节看接入文档。地址统一是https://taotoken.net/api别在配置里写错路径。装环境这件事一次装对后面省下的时间比装十次都多。
