1. Windows 下 Claude Code 到底怎么装才不折腾Claude Code 是 Anthropic 推出的命令行 AI 编程工具能直接在终端里读代码、改文件、跑命令适合习惯 CLI 工作流的开发者也适合想在 VS Code 里少切窗口的人。它的核心检索词就三个Claude Code、vscode、环境变量。很多人卡住不是因为工具难而是 Windows 下环境变量和配置文件的位置跟 macOS/Linux 不一样加上 PowerShell 的语法差异第一次配基本都要踩两脚坑。这篇聚焦 Windows 场景把两条路都走一遍VS Code 插件版安装即用推荐新手和命令行 CLI 版。重点讲清楚 TaoToken 统一 Key 怎么接进去、settings.json骨架长什么样、PowerShell 环境变量怎么设、以及怎么用一条命令验证连通性。全程可复制跟着做就能从安装走到首次调用。先说清楚 TaoToken 在这里的角色它是一个统一的 API 通道你拿一个 Key 就能调用 Claude 系列模型不用自己维护多个上游配置。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。下面所有配置里的ANTHROPIC_BASE_URL都指向这个 API 地址。2. 装之前先把 TaoToken 的 Key 和通道准备好这一步是前置不做后面全白搭。你需要两样东西一个可用的 API Key和确认 API 通道地址。打开 TaoToken 控制台进 API Keys 页面创建一个新 Key。创建时建议起个能认出来的名字比如claude-code-win方便以后区分是给哪台机器用的。Key 只在创建时完整显示一次复制下来先存到临时记事本等会儿要粘进配置文件。控制台地址在这里https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite如果你还没决定用哪个模型可以先在模型对话页面试一下确认通道通不通再往下配https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite注意Key 属于敏感凭证不要提交到 Git 仓库也不要贴到公开聊天里。配置文件放在用户目录下别放进项目目录。拿到 Key 之后记住两个值后面反复用配置项值ANTHROPIC_AUTH_TOKEN你刚创建的 KeyANTHROPIC_BASE_URLhttps://taotoken.net/api3. VS Code 插件版settings.json 骨架与 PowerShell 环境变量3.1 安装官方插件先装 VS Code官网下载后一路下一步即可。打开后在扩展市场搜索Claude Code认准 Anthropic 官方发布的那一个别装到同名的第三方套壳。安装完成后重启一次 VS Code让插件加载完整。3.2 创建 .claude 目录和 settings.jsonWindows 下的配置目录是C:\Users\你的用户名\.claude\settings.json如果.claude文件夹不存在手动新建一个。然后在里面创建settings.json填入下面的骨架。把ANTHROPIC_AUTH_TOKEN换成你自己的 Key{ alwaysThinkingEnabled: true, env: { ANTHROPIC_AUTH_TOKEN: 你的TaoToken Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, CLAUDE_CODE_MAX_OUTPUT_TOKENS: 64000 }, permissions: { allow: [], deny: [] }, skipWebFetchPreflight: true }几个字段说明一下。alwaysThinkingEnabled打开后模型会先思考再回答复杂任务质量更稳。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC关掉非必要流量减少无谓请求。CLAUDE_CODE_MAX_OUTPUT_TOKENS设成 64000长文件改写不容易被截断。skipWebFetchPreflight跳过网页抓取的预检避免某些网络环境下卡住。3.3 用 PowerShell 设环境变量方法二如果你不想改配置文件或者想让终端和插件共用同一套变量用 PowerShell 设用户级环境变量。以管理员或普通用户身份打开 PowerShell 都行执行[Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN,你的TaoToken Key, User) [Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, User)设完之后必须重开一个 PowerShell 窗口旧窗口读不到新变量。然后验证echo $env:ANTHROPIC_AUTH_TOKEN echo $env:ANTHROPIC_BASE_URL如果两行都打印出正确值而不是空白说明环境变量生效了。这里有个常见坑SetEnvironmentVariable的第三个参数User不能省省了只对当前进程有效关掉窗口就没了。3.4 插件必须改的 config.jsonVS Code 插件版还有一个额外要求需要改config.json否则插件启动时会报 Key 校验失败{ primaryApiKey: any }这个文件同样放在.claude目录下。primaryApiKey填any是占位真正的鉴权走settings.json里的ANTHROPIC_AUTH_TOKEN。这一步很多人漏掉表现就是插件界面一直转圈或者提示未授权。3.5 启动使用在 VS Code 里打开你的项目文件夹随便点开一个文件点击插件面板的启动按钮。第一次启动会读取配置稍等几秒进入对话界面。输入一句「帮我看看这个文件是做什么的」能收到回复就说明整条链路通了。4. 命令行 CLI 版安装与连通性验证如果你已经装了 VS Code 插件版CLI 版可以跳过。想单独用命令行的继续往下。CLI 版安装参考官方安装文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite安装完成后环境变量配置和上面 PowerShell 那套完全一致因为 CLI 读的就是同一组用户级变量。确认ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL都设好之后在 Windows 终端运行claude出现对话界面后输入测试问题比如「用一句话解释什么是递归」。能收到回复即表示配置成功。想在不进交互界面的情况下快速验证通道可以用一条非交互命令claude -p 回复连通性正常如果返回了「连通性正常」类似内容说明 Key、Base URL、网络三者都没问题。这一步比进交互界面更快适合配完立刻自检。5. 本篇常见报错排查5.1 环境变量打印为空最常见。原因通常是设完没重开终端或者SetEnvironmentVariable的 scope 参数写错。重开 PowerShell 再echo一次。如果还是空检查是不是设到了Process而不是User。5.2 插件提示未授权或一直转圈九成是config.json没建或者primaryApiKey没填any。回去检查.claude目录下是不是同时有settings.json和config.json两个文件。5.3 请求超时或连接失败先确认ANTHROPIC_BASE_URL是https://taotoken.net/api注意结尾不要多加斜杠也不要写成别的路径。然后确认 Key 没有多余空格——从控制台复制时容易带上首尾空白粘进 JSON 后会导致鉴权失败。5.4 JSON 格式报错settings.json对格式很敏感。常见问题是最后一项多了逗号、用了中文引号、或者注释没删。可以用 VS Code 打开这个文件右下角会提示 JSON 是否合法。建议把内容贴到 JSON 校验工具里过一遍。5.5 输出被截断长文件改写时如果回答中途断掉把CLAUDE_CODE_MAX_OUTPUT_TOKENS调大或者确认这个字段确实写进了env里而不是写在顶层。6. 配好之后怎么继续用到这一步VS Code 插件版和 CLI 版应该都能正常对话了。日常使用中环境变量这套配置是一次性的配好之后不用每次重设。换机器时把.claude目录下的两个 JSON 拷过去再在新机器上设一遍 PowerShell 环境变量即可。如果你打算长期在项目里用 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 或改配置后先跑一遍claude -p 回复连通性正常确认通了再进项目干活。这条命令比开界面快能省掉不少「以为配好了其实没通」的时间。