1. Windows 下 Claude Code 终端安装到底卡在哪Claude Code 是 Anthropic 推出的终端 AI 编码助手能在 PowerShell 里直接读写项目文件、跑命令、改代码。它适合习惯命令行、想让 AI 直接操作本地仓库的开发者。但 Windows 用户第一次装它十有八九会撞上三类问题安装脚本跑完却提示claude不是内部或外部命令、PowerShell 报执行策略禁止运行脚本、以及装好了却连不上 API 一直转圈。我实测下来这些报错基本都指向同一个根因——环境变量没写对或者 API 通道没配通。前者是 PATH 没生效后者是没把请求指向一个稳定的接入地址。这篇就按「装二进制 → 配 PATH → 写 settings.json → 验证连通」的完整链路走一遍每一步都给可复制的命令和配置片段最后再集中排一遍最常见的坑。需要先说明一点Claude Code 本身是个客户端它需要一个能响应 Anthropic 接口格式的服务端。官方账号是一种选择但很多人更希望用一个统一的 Key 来管理调用、方便切换模型和查看用量。下面配置里我会用 TaoToken 作为统一接入层来演示它的接口地址是https://taotoken.net/api兼容 Anthropic 的消息格式配置方式和官方一致只是把 base_url 和 key 换掉即可。2. 装之前先把 TaoToken 的 Key 和地址准备好在动 PowerShell 之前先把接入信息拿到手不然后面 settings.json 没法填。打开浏览器进 TaoToken 官网注册登录后进控制台在 API Keys 页面创建一个新 Key。这个 Key 就是后面所有请求的凭证格式通常是一串以sk-开头的字符串创建后只显示一次记得先复制存好。创建 Key 的入口在控制台的 API Keys 页模型对话入口可以用来先在网页上试一下通道是否正常确认能出结果再去配终端能省掉不少「到底是网络问题还是配置问题」的纠结。拿到两样东西就够了一个是 API Key一个是接口基地址https://taotoken.net/api。注意这个地址不带任何查询参数settings.json 里填的就是它。如果你后面想换模型或者看用量回控制台操作即可终端这边不用改。提示Key 属于敏感凭证别直接提交到 Git 仓库。settings.json 如果放在项目目录里记得加进 .gitignore。3. 安装 Claude Code 并处理 PowerShell 执行策略Claude Code 在 Windows 上推荐用原生安装脚本它会拉取二进制并放到用户目录下。先确认系统是 Windows 10 1809 及以上然后打开 PowerShell。第一步不是直接跑安装命令而是先看执行策略因为默认策略可能禁止运行远程脚本。在 PowerShell 里执行Get-ExecutionPolicy如果返回Restricted安装脚本会被拦。把它改成当前用户级别的 RemoteSigned这个改动不需要管理员权限也只影响你自己Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned改完再确认一次返回RemoteSigned就对了。接着跑官方安装脚本irm https://claude.ai/install.ps1 | iex脚本会下载二进制并解压到类似C:\Users\你的用户名\.local\bin的目录。跑完如果看到Claude Code successfully installed!说明文件已经落地。但这时候别急着敲claude因为那个目录大概率还没进 PATH直接敲会报「无法将 claude 项识别为 cmdlet」。安装脚本有时会贴心地打印一段黄色提示告诉你某个路径不在 PATH 里让你手动加。这段提示别忽略它就是下一步要解决的问题。4. 把安装目录写进 PATH 环境变量PATH 的作用是让系统在终端里输入claude时知道去哪些目录找这个可执行文件。没配 PATH你就只能每次输入完整绝对路径非常麻烦。配置方式有两种图形界面和命令行我建议先用命令行快速搞定出问题再用图形界面核对。先确认二进制到底在哪。安装脚本一般会放在用户目录下的.local\bin用这条命令查Get-ChildItem $env:USERPROFILE\.local\bin | Select-Object Name看到claude.exe或类似文件说明路径就是$env:USERPROFILE\.local\bin。把它追加到当前用户的 PATH用户变量不需要管理员权限$claudePath $env:USERPROFILE\.local\bin [Environment]::SetEnvironmentVariable(Path, [Environment]::GetEnvironmentVariable(Path, User) ;$claudePath, User)这条命令只改用户变量不动系统变量安全且可逆。执行完当前窗口不会立刻生效必须关掉 PowerShell 重新开一个。重开后验证claude --help能打印出帮助信息就说明 PATH 通了。如果还是找不到用图形界面核对一遍按 Win 键搜「环境变量」进「编辑系统环境变量」→「环境变量」在上方用户变量里选中 Path点编辑确认C:\Users\你的用户名\.local\bin这一行在列表里。缺了就新建一行补上一路确定。注意用户变量只对当前登录账户生效系统变量对所有用户生效但需要管理员权限。个人开发机改用户变量就够了别去动系统变量避免影响其他软件。5. 写 settings.json 把请求指向统一接入地址PATH 通了只是能启动真正让它干活还得配 API 通道。Claude Code 读取配置的位置在用户目录下的.claude文件夹主配置文件是settings.json。如果目录不存在先建New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude然后创建或编辑settings.json填入下面这段骨架。核心是把 base_url 指向 TaoToken 的接口地址并用环境变量引用 Key避免明文写死在文件里{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }三个字段的作用分别是ANTHROPIC_BASE_URL决定请求发往哪里这里填 TaoToken 的接口地址ANTHROPIC_AUTH_TOKEN是鉴权凭证把sk-你的Key换成第 2 步创建的那串ANTHROPIC_MODEL指定默认模型按你账号里可用的模型名填。如果你不想把 Key 明文写在 json 里可以改成从系统环境变量读取。先在 PowerShell 里设一个用户级环境变量[Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN, sk-你的Key, User)然后 settings.json 里把ANTHROPIC_AUTH_TOKEN那行删掉Claude Code 会自动从环境变量取。这样配置文件可以放心提交或分享Key 留在系统里。改完记得重开终端让环境变量生效。6. 验证 API 通道是否真的连通配置写完最怕的是「看起来都对但就是不通」。别急着开项目先用一个最小请求验证通道。重开 PowerShell进任意一个空目录直接启动claude首次启动它会读 settings.json如果配置正确会进入交互界面。随便问一句让它读当前目录比如输入「列出当前目录的文件」如果它能返回结果说明从终端到 TaoToken 再到模型的整条链路是通的。想更直接地验证接口可以用 curl 打一发消息请求绕开客户端看服务端返回curl.exe https://taotoken.net/api/v1/messages -H x-api-key: sk-你的Key -H anthropic-version: 2023-06-01 -H content-type: application/json -d {\model\:\claude-sonnet-4-20250514\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\ping\}]}返回里带content字段和一段文本就证明 Key 和地址都没问题。如果返回 401是 Key 错了或没生效返回 404多半是 base_url 写错检查有没有多写或少写/api返回超时则是网络层的问题往下看排错部分。7. 本篇常见报错逐个排查报错一claude : 无法将“claude”项识别为 cmdlet这是 PATH 没生效。先确认二进制目录存在再确认 PATH 里有这一行最后务必重开终端。三个条件缺一不可尤其是重开这一步很多人改完就在原窗口试永远不生效。报错二无法加载文件因为在此系统上禁止运行脚本执行策略拦的。回到第 3 步用Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned改掉别用管理员全局改没必要。报错三启动后一直转圈或提示连接失败先确认 settings.json 里的ANTHROPIC_BASE_URL是https://taotoken.net/api没有多余斜杠或路径。再用第 6 步的 curl 单独测接口把客户端和服务端问题分开定位。如果 curl 通而客户端不通多半是 settings.json 格式错了用 JSON 校验工具过一遍注意别多逗号。报错四返回 401 未授权Key 错了、过期了或者环境变量没生效。去控制台重新生成一个 Key确认复制时没带空格。如果用环境变量方式重开终端再试。报错五模型名报错model not foundANTHROPIC_MODEL填的模型名在你账号下不可用。回控制台看可用模型列表换成存在的那个。模型名区分大小写和版本号别凭记忆手敲。报错六改了 settings.json 但行为没变Claude Code 启动时读配置改完要退出重进。另外确认改的是用户目录下的.claude\settings.json不是项目里的其他同名文件项目级配置会覆盖用户级。8. 配好之后怎么继续往下走到这一步终端能启动、接口能通、模型能回话基础链路就算跑通了。接下来按你的使用场景分流如果只是想验证模型对话效果直接进模型对话页面在网页上试更省事如果打算长期用 Claude Code 写代码、跑 Agent 任务建议去了解一下 Coding Plan它针对高频编码场景做了额度优化比按次调用更划算如果还要接其他工具或自己写脚本调接口去 API Keys 页面管理 Key接入文档里有各语言的调用示例。配置这件事一次配好后面就省心了。真正容易反复踩的其实就两个点PATH 改完没重开终端以及 base_url 多写或少写了路径。把这两条记住剩下的报错基本都能自己定位。