1. Windows 上装 Claude Code 到底卡在哪Git Bash 与 PowerShell 的真实差异Claude Code 是 Anthropic 推出的终端 AI 编程助手能直接在命令行里读写项目文件、跑测试、改代码。它适合已经习惯终端工作流的开发者也适合想把手动改代码这件事交给 AI 代劳的人。但在 Windows 上它的安装体验和 macOS、Linux 完全不是一回事——官方脚本默认面向 Unix 环境Windows 用户得先解决终端选择和环境变量两个问题。我自己第一次装的时候在 PowerShell 里敲完安装命令终端提示装好了结果新开一个窗口输入claude却报「不是内部或外部命令」。折腾了十几分钟才发现是.local\bin没进 PATH。后来换成 Git Bash 又遇到另一套路径写法两边环境变量互不相通。这篇就把 Git Bash 和 PowerShell 两条路都走一遍顺带把 Base URL 改到 TaoToken 的配置也写清楚。先说清楚两个终端的定位差异。PowerShell 是 Windows 原生终端路径用反斜杠环境变量通过系统 GUI 或$env:读写Git Bash 是 Git for Windows 附带的类 Unix 终端路径用正斜杠环境变量写在~/.bashrc或~/.bash_profile里。Claude Code 的安装脚本在两者下都能跑但装完之后「命令能不能被找到」取决于你把 bin 目录加到了哪个终端的 PATH。还有一个容易被忽略的点Claude Code 本身只是个客户端它需要一个模型提供方才能工作。默认它连的是 Anthropic 官方国内直连不稳定所以实际使用中通常要把 Base URL 指向一个兼容 Anthropic 接口的服务。TaoToken 提供的就是这类接入能力后面会给具体配置。这一篇的目标很明确装好、配好、验证能跑通。不涉及复杂项目实战就是把安装这一步彻底走顺。2. 装之前先把 TaoToken 的 Key 和地址准备好在动手装 Claude Code 之前建议先把模型接入的信息拿到手这样装完就能直接验证不用来回切换窗口。TaoToken 的接入需要三样东西Base URL、API Key、Model ID。这三样在后面的配置里会反复出现先记下来。Base URL 用https://taotoken.net/api注意这里不带任何查询参数就是干净的接口根地址。API Key 需要登录后在控制台生成路径是 API Keys 页面。Model ID 则取决于你想用哪个模型常见的有 claude-sonnet 系列等具体以文档里列出的为准。操作顺序建议这样先打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录然后进控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建 Key。创建时给它起个能认出来的名字比如「claude-code-win」方便以后区分。Key 只在创建时完整显示一次复制后先存到记事本里。如果你还没想好用什么模型可以先去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 试一下确认接口通不通、响应快不快再决定给 Claude Code 配哪个 Model ID。这一步不是必须的但能省掉后面「配完了发现模型名写错」的返工。关于 Key 的安全不要把它直接写进会提交到 Git 的文件里。Claude Code 的配置一般放在用户目录下的配置文件中这个位置不会被项目仓库追踪相对安全。但如果你手动把配置复制到项目里记得加进.gitignore。另外提醒一点TaoToken 是模型接入服务不是编辑器插件也不替代 Claude Code 本身。它的作用是让 Claude Code 能连上一个稳定的模型端点。理解这个分工后面配置时就不会混淆「装客户端」和「配模型」两件事。准备好这三样之后就可以进入安装环节了。3. 可复制的安装与环境变量配置Git Bash 和 PowerShell 各一套这一节是全文的核心给出两条终端路线的完整命令和配置片段。你可以只选一条走也可以两条都配互不影响。3.1 PowerShell 路线安装命令与 PATH 配置先装 Git for Windows因为 Claude Code 的部分功能依赖 Git。从 Git 官网下载安装包一路默认下一步即可。装完后开始菜单里会有 Git Bash但这一节我们先用 PowerShell。以管理员身份打开 PowerShell点开始菜单搜索 PowerShell右键选择「以管理员身份运行」。然后执行安装脚本。安装脚本的地址以官方或你信任的分发为准执行形式类似 ([scriptblock]::Create((irm https://example.com/cc.ps1))) 2.1.153这里的版本号2.1.153是示例实际以你拿到的脚本为准。安装时间取决于网络快则一分钟慢则十几分钟耐心等它跑完。装完后Claude Code 的可执行文件通常在C:\Users\你的用户名\.local\bin下。要让 PowerShell 里直接输入claude就能启动得把这个目录加进 PATH。操作步骤开始菜单搜索「编辑环境变量」→ 在「高级」标签点「环境变量」→ 在用户变量里找到Path双击 → 新建一条填入C:\Users\你的用户名\.local\bin把「你的用户名」换成实际的。保存后关掉当前 PowerShell 窗口重新开一个PATH 才会生效。这一步很多人漏掉导致以为配置没成功。3.2 Git Bash 路线环境变量写法不同Git Bash 里 PATH 的写法是冒号分隔的 Unix 风格而且它启动时会读~/.bashrc。所以配置方式是在~/.bashrc末尾追加一行export PATH$PATH:/c/Users/你的用户名/.local/bin注意路径写法C:\Users\...在 Git Bash 里要写成/c/Users/...。改完执行source ~/.bashrc让它立即生效或者重开终端。如果你两个终端都想用就两边都配。它们读的是不同的配置源不会冲突。3.3 用 settings 文件把 Base URL 指向 TaoTokenClaude Code 的模型接入配置放在用户目录下的 settings 文件里。Windows 下路径通常是C:\Users\你的用户名\.claude\settings.json。如果目录不存在就手动建。写入以下 JSON{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的_TaoToken_Key, ANTHROPIC_MODEL: 你的_Model_ID } }三件套对应关系ANTHROPIC_BASE_URL填 TaoToken 的接口根地址ANTHROPIC_API_KEY填控制台生成的 KeyANTHROPIC_MODEL填你要用的 Model ID。保存文件编码用 UTF-8避免中文路径或 BOM 导致解析失败。如果你更习惯用环境变量而不是 settings 文件PowerShell 里可以这样临时设置仅当前窗口有效$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_API_KEY 你的_TaoToken_Key $env:ANTHROPIC_MODEL 你的_Model_ID但临时变量关窗口就没了长期使用还是推荐 settings.json。3.4 用 CC Switch 管理多套配置如果你需要在多个模型提供方之间切换可以装 CC Switch 这个图形化工具。它读取和写入的就是上面那个 settings 文件帮你省去手动改 JSON 的麻烦。下载 Windows 版带.msi后缀安装后打开点右上角「」添加供应商填入 Base URL、Key、Model ID点「启用」即可。CC Switch 的好处是切换时不用记路径、不用手改文件适合同时用多个端点的场景。但它只是配置管理器不改变 Claude Code 本身的运行方式。4. 验证安装是否成功从报错到正常对话的检查动作配置写完接下来验证。这一步能帮你快速定位是「没装上」还是「没连上」。先确认命令能被找到。在 PowerShell 或 Git Bash 里输入claude --version如果输出版本号说明安装和 PATH 都没问题。如果报「不是内部或外部命令」或command not found回到第 3 节检查 PATH 是否加对、窗口是否重开过。版本号能出来之后直接启动claude第一次启动如果模型配置正确会进入交互界面可以输入问题测试。如果出现一个提示「还没有配置模型」之类的界面说明 settings.json 没被读到或者 Key、Model ID 有误。一个更直接的验证方式是发一条最小请求。在 Claude Code 交互界面里输入一句简单的话比如让它解释当前目录下某个文件的作用。如果它能正常返回内容说明 Base URL、Key、Model 三样都通了。如果返回的是认证错误重点查 Key 是否复制完整、有没有多余空格。如果返回连接超时查 Base URL 是否写成了带路径的完整地址应该只到/api。如果返回模型不存在查 Model ID 拼写。实测下来最常见的失败不是安装失败而是配置文件的路径或字段名写错。settings.json必须是合法 JSON多一个逗号都会导致整个文件被忽略。可以用在线 JSON 校验工具过一遍。验证通过后建议把这次成功的配置备份一份换机器或重装时直接复用。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来对照遇到问题直接查。401 UnauthorizedKey 无效或没带上。检查ANTHROPIC_API_KEY是否填对有没有把 Key 写成了别的字段。如果用的是环境变量方式确认当前窗口确实读到了。另外注意 Key 是否已过期或被删除。local proxy failed / connection refused通常是 Base URL 写错或者本地网络到该地址不通。确认ANTHROPIC_BASE_URL是https://taotoken.net/api不要多加/v1之类的路径。如果公司网络有额外限制换网络环境再试。Error reading choices / 响应解析失败这类报错多半是端点返回的格式和客户端预期不一致常见原因是 Base URL 指向了非兼容接口或者 Model ID 填了一个该端点不支持的模型。回到文档核对 Model ID 列表。OAuth 相关报错Claude Code 某些版本会尝试走 OAuth 登录流程。如果你用的是 API Key 方式接入确保配置里没有残留的 OAuth token 字段必要时删掉~/.claude下的缓存文件重新来。PATH 生效但命令仍找不到Windows 下可能是.local\bin里实际的可执行文件名不是claude去目录里看一眼真实文件名。Git Bash 下则检查/c/Users/...路径拼写注意大小写和斜杠方向。settings.json 不生效确认文件在C:\Users\你的用户名\.claude\settings.json不是项目目录下。确认 JSON 合法。确认没有同时用环境变量覆盖了文件里的值——环境变量优先级通常更高。排查时养成一个习惯改完配置先claude --version确认命令在再启动确认模型通。两步分开能快速缩小问题范围。6. 装好之后把 Claude Code 接进日常编码流安装只是起点。命令能跑、模型能通之后你可以开始把它用在真实项目里。几个上手方向让它读一个现有文件并解释逻辑让它根据注释补全函数或者让它跑一遍测试并汇总失败原因。如果你打算长期用 Claude Code 做编码和 Agent 类任务可以了解一下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它面向的就是这类持续调用场景。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到接口细节问题可以查。Key 管理仍在 API Keys https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 页面。最后给一个实用技巧把settings.json里的配置和你的 Key 分开管理Key 用环境变量注入文件里只留 Base URL 和 Model ID。这样配置文件可以安全地同步到其他机器Key 单独保管。装一次配好后面换项目、换目录都不用再动。