1. 为什么 Windows11 装 Claude Code 总卡在第一步Claude Code 是 Anthropic 推出的终端 AI 编程助手能在命令行里直接读写项目文件、跑命令、改代码适合习惯在终端里干活的后端、运维和全栈开发者。但国内 Windows11 用户装它时十有八九会卡在同一个地方官网给的安装方式是一段 PowerShell 脚本下载环节会校验地区国内网络基本走不通加上还要改执行策略报错一片红折腾一下午装不上是常态。我试过把官网脚本和 WinGet 两条路都跑了一遍结论很直接Windows11 上装 Claude Code走 WinGet 官方包管理器是最省事的方案。WinGet 是微软自带的包管理工具安装环节不做地区校验国内网络能正常拉取全程有日志出问题一眼能定位。装完之后再配一个统一的 API 通道就能从零跑通第一个对话请求。这篇教程交付三样东西可复制的 WinGet 安装命令、settings.json 配置骨架、以及验证请求成功的具体动作。全程管理员终端操作小白照着做也能一次过。2. 装之前先把 TaoToken 的 Key 和通道准备好Claude Code 装好后默认要连 Anthropic 官方服务国内直连不稳定所以需要给它配一个统一的 API 通道。TaoToken 提供的就是这个能力一个 Key 打通多家模型Claude Code 只要把请求地址指向它就能稳定调用。你需要提前拿到两样东西API Key 和接入地址。Key 在控制台的 API Keys 页面创建接入地址用https://taotoken.net/api。这两样后面要写进配置文件先记下来。创建 Key 的入口在这里控制台 API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite如果你还没决定用哪个模型可以先在模型对话页面试一下确认通道通不通模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite长期在终端里写代码、跑 Agent 任务的建议直接看 Coding Plan额度更划算Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档里有各家工具的完整配置说明Claude Code 的字段含义也在里面接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite3. 前置检查WinGet 和 Git 一个都不能少全程必须以管理员身份运行终端否则会因权限不足安装失败。右键点击开始菜单选「终端(管理员)」打开后依次执行下面的检查。先确认 WinGet 可用winget --version输出版本号就正常。如果提示命令不存在去微软商店搜「应用安装程序」更新一下就能恢复。再确认 Git 环境Claude Code 运行强依赖 Gitgit --version同样输出版本号即正常。没有的话去 Git 官网下最新版安装时记得勾选「Add to PATH」否则终端里识别不到 git 命令。两项都通过就可以进入安装环节了。4. 一行命令装好 Claude Code先搜一下官方包确认包 ID 拼写正确winget search --id Anthropic.ClaudeCode注意这里必须用--id精准锁定直接搜Claude Code会因为空格被 WinGet 当成参数分隔符而报错。搜到之后执行安装winget install Anthropic.ClaudeCode安装过程会自动下载并写入 PATH全程无需额外操作。装完验证版本claude --version输出版本号就说明安装成功。后续升级和卸载也都是 WinGet 一条命令的事winget upgrade Anthropic.ClaudeCode winget uninstall Anthropic.ClaudeCode升级命令建议记一下Claude Code 迭代很快右下角出现黄色更新提示时直接跑这条就行。5. 配置 settings.json 接入 TaoTokenClaude Code 的配置分两层一层是环境变量决定请求发往哪里一层是项目内的 settings.json决定权限和行为。国内用 TaoToken 通道核心是把请求地址和 Key 通过环境变量注入。在用户目录下找到或新建.claude文件夹路径是C:\Users\你的用户名\.claude。在里面创建settings.json写入下面的骨架{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken_API_Key }, permissions: { allow: [], deny: [] } }把你的TaoToken_API_Key换成第 2 步创建的那串 Key。ANTHROPIC_BASE_URL指向 TaoToken 的接入地址Claude Code 的所有请求就会走这条通道不再直连官方。如果你更习惯用系统环境变量也可以在 PowerShell 里设置效果一样setx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_AUTH_TOKEN 你的TaoToken_API_Keysetx写入的是持久环境变量设置完要重开终端才生效。两种方式选一种即可不要同时配避免冲突。配置里的permissions字段控制工具调用权限初期留空就行等熟悉了再按需收紧比如把危险命令加进deny。6. 跑通第一个对话请求配置写完进入一个测试项目目录不要在用户根目录直接启动避免误操作cd D:\ClaudeCodeTest claude首次启动会让你选主题键盘上下选 Auto 回车即可。接着是安全免责提示页大意是 AI 会犯错、存在提示注入风险只对信任的代码使用回车继续。然后是信任文件夹授权选「Yes, I trust this folder」确认。进入交互界面后输入一句简单指令验证通道帮我看看当前目录下有哪些文件并说明这个项目是做什么的如果 Claude Code 能正常读取目录并返回分析说明 TaoToken 通道已经打通。界面底部会显示当前使用的模型和用量信息你可以在这里确认请求确实走了配置的地址。想进一步验证模型能力可以在模型对话页面单独发一条请求对比模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite7. 本篇常见报错排查装和配的过程中下面几个坑出现频率最高对照处理即可。搜索报「在未预期的情况下找到位置参数」WinGet 把空格当成了参数分隔符。带空格的搜索词必须加双引号或者直接用--id Anthropic.ClaudeCode精准锁定。提示「找不到与输入条件匹配的程序包」包名拼错了漏了官方前缀。严格用Anthropic.ClaudeCode大小写和点号都不能错。安装报「权限不足」「写入文件失败」没用管理员身份开终端。关掉当前窗口重新以管理员身份打开再执行。装完claude命令不识别PATH 环境变量没刷新。关掉所有终端窗口重开仍无效就手动把安装目录加进系统 PATH。启动后请求超时或报鉴权失败检查ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN是否写对Key 有没有多余空格。改完配置要重开终端。如果还是不通去 API Keys 页面确认 Key 状态正常API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite想确认字段含义接入文档里有每个配置项的说明对着核一遍比瞎试快接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite8. 把环境固定下来后面就省心了装好只是开始真正省时间的是把配置固定成习惯。我的做法是项目目录单独建每个项目里放一份.claude/settings.json覆盖全局配置把该项目特有的权限和模型偏好写进去全局那份只留通道地址和 Key换机器时复制过去就能用。另外Claude Code 的升级命令winget upgrade Anthropic.ClaudeCode建议设个提醒版本更新往往带来新工具和新模型支持。长期跑编码和 Agent 任务的Coding Plan 的额度比按量更稳不用每次盯着用量Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite环境这东西一次配好后面就是纯写代码的事了。
1. 为什么 Windows11 装 Claude Code 总卡在第一步Claude Code 是 Anthropic 推出的终端 AI 编程助手能在命令行里直接读写项目文件、跑命令、改代码适合习惯在终端里干活的后端、运维和全栈开发者。但国内 Windows11 用户装它时十有八九会卡在同一个地方官网给的安装方式是一段 PowerShell 脚本下载环节会校验地区国内网络基本走不通加上还要改执行策略报错一片红折腾一下午装不上是常态。我试过把官网脚本和 WinGet 两条路都跑了一遍结论很直接Windows11 上装 Claude Code走 WinGet 官方包管理器是最省事的方案。WinGet 是微软自带的包管理工具安装环节不做地区校验国内网络能正常拉取全程有日志出问题一眼能定位。装完之后再配一个统一的 API 通道就能从零跑通第一个对话请求。这篇教程交付三样东西可复制的 WinGet 安装命令、settings.json 配置骨架、以及验证请求成功的具体动作。全程管理员终端操作小白照着做也能一次过。2. 装之前先把 TaoToken 的 Key 和通道准备好Claude Code 装好后默认要连 Anthropic 官方服务国内直连不稳定所以需要给它配一个统一的 API 通道。TaoToken 提供的就是这个能力一个 Key 打通多家模型Claude Code 只要把请求地址指向它就能稳定调用。你需要提前拿到两样东西API Key 和接入地址。Key 在控制台的 API Keys 页面创建接入地址用https://taotoken.net/api。这两样后面要写进配置文件先记下来。创建 Key 的入口在这里控制台 API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite如果你还没决定用哪个模型可以先在模型对话页面试一下确认通道通不通模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite长期在终端里写代码、跑 Agent 任务的建议直接看 Coding Plan额度更划算Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档里有各家工具的完整配置说明Claude Code 的字段含义也在里面接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite3. 前置检查WinGet 和 Git 一个都不能少全程必须以管理员身份运行终端否则会因权限不足安装失败。右键点击开始菜单选「终端(管理员)」打开后依次执行下面的检查。先确认 WinGet 可用winget --version输出版本号就正常。如果提示命令不存在去微软商店搜「应用安装程序」更新一下就能恢复。再确认 Git 环境Claude Code 运行强依赖 Gitgit --version同样输出版本号即正常。没有的话去 Git 官网下最新版安装时记得勾选「Add to PATH」否则终端里识别不到 git 命令。两项都通过就可以进入安装环节了。4. 一行命令装好 Claude Code先搜一下官方包确认包 ID 拼写正确winget search --id Anthropic.ClaudeCode注意这里必须用--id精准锁定直接搜Claude Code会因为空格被 WinGet 当成参数分隔符而报错。搜到之后执行安装winget install Anthropic.ClaudeCode安装过程会自动下载并写入 PATH全程无需额外操作。装完验证版本claude --version输出版本号就说明安装成功。后续升级和卸载也都是 WinGet 一条命令的事winget upgrade Anthropic.ClaudeCode winget uninstall Anthropic.ClaudeCode升级命令建议记一下Claude Code 迭代很快右下角出现黄色更新提示时直接跑这条就行。5. 配置 settings.json 接入 TaoTokenClaude Code 的配置分两层一层是环境变量决定请求发往哪里一层是项目内的 settings.json决定权限和行为。国内用 TaoToken 通道核心是把请求地址和 Key 通过环境变量注入。在用户目录下找到或新建.claude文件夹路径是C:\Users\你的用户名\.claude。在里面创建settings.json写入下面的骨架{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken_API_Key }, permissions: { allow: [], deny: [] } }把你的TaoToken_API_Key换成第 2 步创建的那串 Key。ANTHROPIC_BASE_URL指向 TaoToken 的接入地址Claude Code 的所有请求就会走这条通道不再直连官方。如果你更习惯用系统环境变量也可以在 PowerShell 里设置效果一样setx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_AUTH_TOKEN 你的TaoToken_API_Keysetx写入的是持久环境变量设置完要重开终端才生效。两种方式选一种即可不要同时配避免冲突。配置里的permissions字段控制工具调用权限初期留空就行等熟悉了再按需收紧比如把危险命令加进deny。6. 跑通第一个对话请求配置写完进入一个测试项目目录不要在用户根目录直接启动避免误操作cd D:\ClaudeCodeTest claude首次启动会让你选主题键盘上下选 Auto 回车即可。接着是安全免责提示页大意是 AI 会犯错、存在提示注入风险只对信任的代码使用回车继续。然后是信任文件夹授权选「Yes, I trust this folder」确认。进入交互界面后输入一句简单指令验证通道帮我看看当前目录下有哪些文件并说明这个项目是做什么的如果 Claude Code 能正常读取目录并返回分析说明 TaoToken 通道已经打通。界面底部会显示当前使用的模型和用量信息你可以在这里确认请求确实走了配置的地址。想进一步验证模型能力可以在模型对话页面单独发一条请求对比模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite7. 本篇常见报错排查装和配的过程中下面几个坑出现频率最高对照处理即可。搜索报「在未预期的情况下找到位置参数」WinGet 把空格当成了参数分隔符。带空格的搜索词必须加双引号或者直接用--id Anthropic.ClaudeCode精准锁定。提示「找不到与输入条件匹配的程序包」包名拼错了漏了官方前缀。严格用Anthropic.ClaudeCode大小写和点号都不能错。安装报「权限不足」「写入文件失败」没用管理员身份开终端。关掉当前窗口重新以管理员身份打开再执行。装完claude命令不识别PATH 环境变量没刷新。关掉所有终端窗口重开仍无效就手动把安装目录加进系统 PATH。启动后请求超时或报鉴权失败检查ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN是否写对Key 有没有多余空格。改完配置要重开终端。如果还是不通去 API Keys 页面确认 Key 状态正常API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite想确认字段含义接入文档里有每个配置项的说明对着核一遍比瞎试快接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite8. 把环境固定下来后面就省心了装好只是开始真正省时间的是把配置固定成习惯。我的做法是项目目录单独建每个项目里放一份.claude/settings.json覆盖全局配置把该项目特有的权限和模型偏好写进去全局那份只留通道地址和 Key换机器时复制过去就能用。另外Claude Code 的升级命令winget upgrade Anthropic.ClaudeCode建议设个提醒版本更新往往带来新工具和新模型支持。长期跑编码和 Agent 任务的Coding Plan 的额度比按量更稳不用每次盯着用量Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite环境这东西一次配好后面就是纯写代码的事了。
