Windows 上配置 Claude Code 教程：TaoToken 统一 Key 接入与 settings.json 骨架

1. Windows 上跑 Claude Code卡在哪一步Claude Code 是 Anthropic 出的命令行编程助手能在终端里读代码、改文件、跑命令适合习惯用命令行干活的开发者。它本身是个 npm 包理论上npm install -g就能装但 Windows 上真正让人卡住的往往不是安装而是三件事Node.js 环境没配干净、环境变量设了不生效、以及 API 通道怎么接。我见过太多人在 Windows 上装完 Claude Code敲claude直接报错或者能启动但一发请求就 401。问题基本集中在环境变量和 API 地址这两块。这篇就按 Windows 的实际操作路径从 Node.js 准备一路写到settings.json骨架最后用 TaoToken 统一 Key 把请求跑通每一步都给可复制的命令和配置。适合谁看在 Windows 上用 PowerShell 或 CMD 干活、想用 Claude Code 但被环境变量和 API 配置绕晕的人。全程不需要额外装什么奇怪的东西跟着敲就行。下面所有命令默认在 PowerShell 里执行CMD 的差异我会单独标出来。2. 前置准备Node.js、npm 与 TaoToken Key2.1 装 Node.js 并确认 PATH去 Node.js 官网下 LTS 版本的.msi安装包双击一路下一步。关键就一个勾安装向导里那个Add to PATH必须勾上它会把node和npm自动加进系统环境变量。忘了勾的话后面得手动补麻烦。装完关掉所有终端重新开一个 PowerShell验证node -v npm -v正常会返回类似v20.11.0和10.2.4的版本号。如果提示「不是内部或外部命令」说明 PATH 没生效先重启终端还不行就手动加。右键「此电脑」→ 属性 → 高级系统设置 → 环境变量在系统变量的Path里新建两条C:\Program Files\nodejs\ C:\Users\你的用户名\AppData\Roaming\npm改完必须重开终端环境变量只在新会话里生效。2.2 装 Claude Codenpm install -g anthropic-ai/claude-code claude --version能打印出版本号就说明 CLI 装好了。这一步如果卡在下载多半是 npm 源的问题可以临时切到国内镜像npm config set registry https://registry.npmmirror.com装完想切回官方源就npm config set registry https://registry.npmjs.org。2.3 拿 TaoToken 统一 KeyClaude Code 需要一个 API Key 才能发请求。去 TaoToken 控制台创建一个令牌在 API Keys 页面点新建拿到一串sk-开头的 Key先复制存好。这个 Key 就是后面环境变量ANTHROPIC_AUTH_TOKEN要填的值。额度按自己用量设测试阶段给个小额度就够。3. 可复制配置环境变量与 settings.json 骨架3.1 设置两个核心环境变量Claude Code 认两个环境变量ANTHROPIC_AUTH_TOKEN放 KeyANTHROPIC_BASE_URL放 API 通道地址。TaoToken 的 API 地址是https://taotoken.net/api。在 PowerShell 里用setx写入用户级环境变量永久生效setx ANTHROPIC_AUTH_TOKEN sk-你的Key setx ANTHROPIC_BASE_URL https://taotoken.net/apisetx写的是注册表当前终端不会立刻生效必须关掉重开。想只在当前会话临时用用$env:语法$env:ANTHROPIC_AUTH_TOKENsk-你的Key $env:ANTHROPIC_BASE_URLhttps://taotoken.net/apiCMD 用户对应的是set ANTHROPIC_AUTH_TOKENsk-你的Key但set只对当前窗口有效永久写入还是建议用setx或图形界面。3.2 settings.json 骨架除了环境变量Claude Code 还支持用settings.json做项目级或用户级配置。用户级配置放在C:\Users\你的用户名\.claude\settings.json项目级放在项目根目录的.claude\settings.json。骨架长这样{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_BASE_URL: https://taotoken.net/api }, permissions: { allow: [ Read, Edit, Bash(git status), Bash(npm run test) ], deny: [] } }env块里的变量会覆盖系统环境变量适合给不同项目配不同 Key。permissions.allow是白名单把常用只读命令和测试命令放进去能减少每次操作的确认弹窗。注意 JSON 不支持注释别往里写//。提示环境变量和 settings.json 同时存在时settings.json 的env优先级更高。排查问题时先确认到底哪份配置在生效。4. 验证请求确认 Claude Code 正常返回4.1 检查环境变量是否生效重开 PowerShell 后先确认变量写进去了echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKENCMD 里对应echo %ANTHROPIC_BASE_URL%。能打印出你设的值就对了。如果打印为空说明终端没重开或者setx写错了变量名。4.2 启动并跑一次真实请求进一个测试项目目录直接启动cd D:\projects\demo claude第一次启动会走一遍初始化之后进入交互界面。输入一句让它读文件的话比如「读一下当前目录的 package.json告诉我项目名和依赖数量」。如果配置正确它会调用工具读文件并返回结果。想非交互式验证用-p参数直接发一条claude -p 用一句话说明这个目录是做什么的正常会返回一段文本。这一步能返回内容就说明 Key、Base URL、网络链路全通了。如果返回 401是 Key 的问题返回连接错误是 Base URL 或网络的问题。4.3 用 curl 单独验证通道想排除 Claude Code 本身的干扰可以直接打 APIcurl.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-3-5-sonnet-20241022\,\max_tokens\:64,\messages\:[{\role\:\user\,\content\:\ping\}]}注意 PowerShell 里curl是Invoke-WebRequest的别名要写curl.exe才是真 curl。返回 JSON 里带content字段就说明通道没问题。5. 本篇常见错排查报错一claude不是内部或外部命令。npm 全局目录没进 PATH。确认C:\Users\用户名\AppData\Roaming\npm在系统变量 Path 里改完重开终端。报错二401 Unauthorized。Key 错了或没生效。先用echo $env:ANTHROPIC_AUTH_TOKEN确认值再检查 Key 有没有多余空格。setx写入的值如果带引号引号也会被存进去重新设一次别加引号。报错三环境变量设了但 Claude Code 读不到。最常见原因是没重开终端。setx不影响已打开的窗口。另一个原因是 settings.json 里的env覆盖了系统变量检查两份配置是否冲突。报错四请求超时或连接被拒。先确认ANTHROPIC_BASE_URL是https://taotoken.net/api别多写或少写路径。再用上面 4.3 的 curl 单独测通道能通就是 Claude Code 配置问题不通就是网络或地址问题。报错五npm 装包卡住。切镜像源或检查公司网络是否限制了 npm registry。装完记得切回官方源避免后续包版本对不上。报错六settings.json 解析失败。JSON 不允许尾逗号和注释。用编辑器格式化一下或者拿node -e JSON.parse(require(fs).readFileSync(settings.json))验证语法。6. 接下来怎么用按场景选入口配置跑通只是起点。日常用 Claude Code 干活按你的场景挑入口更省事。如果你主要在终端里做长期编码、跑 Agent 任务建议直接上 Coding Plan把额度和通道一次配好省得反复折腾 Keyhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite想先在网页里验证模型返回、对比不同模型效果用模型对话入口最快https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite需要管理多个 Key、看用量和额度去控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteKey 的创建和轮换在 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite用 Claude Code 配合 Anthropic 协议接入的完整说明https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite最后留个实操经验Windows 上环境变量改完养成「改完就重开终端」的习惯能省掉一大半「明明设了却不生效」的排查时间。settings.json 建议只放项目相关的权限白名单Key 和 Base URL 走系统环境变量这样换项目不用改配置也不会把 Key 提交进 git。