1. Windows 上跑 Claude Code卡在哪一步Claude Code 是 Anthropic 出的命令行编程助手能在终端里读你的项目、改代码、跑命令适合习惯用命令行干活的开发者。它本身是个 Node 生态的 CLI 工具在 macOS 和 Linux 上装起来比较顺但到了 Windows很多人第一次装就会遇到两个坎一是安装方式选不对二是首次启动卡在登录引导页连不上服务。我见过最多的场景是这样的照着文档敲了安装命令claude也能启动但界面停在欢迎引导要求你登录 Anthropic 账号或者配置服务地址点也不是、退也不是。还有人是环境变量和配置文件混着改改完不知道哪个生效了报错信息又只有一行Connection error完全不知道从哪查。这篇就聚焦 Windows 环境把安装、环境变量、settings.json配置骨架、验证命令、报错排查一条线走完。核心思路是用 TaoToken 的统一 Key 和 API 通道把 Claude Code 的调用链路一次性打通让你在 Win 上完成一次可复现的调用。适合刚接触 Claude Code、想在 Windows 上快速跑通、又不想在登录环节反复折腾的人。需要先明确一点Claude Code 的配置分两层一层是系统环境变量一层是用户目录下的配置文件。两层都能设ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN但优先级和生效时机不一样后面会讲清楚。2. 前置准备TaoToken 统一 Key 与 API 通道在动手装 Claude Code 之前先把「钥匙」准备好。Claude Code 默认要连 Anthropic 官方服务但你可以通过配置ANTHROPIC_BASE_URL把请求指向兼容的 API 通道再用ANTHROPIC_AUTH_TOKEN带上你的 Key。TaoToken 在这里扮演的就是统一 Key 和 API 通道的角色一个 Key 走通模型调用。你需要拿到两样东西一个 API Key一个 API 基础地址。Key 在控制台的 API Keys 页面创建地址用https://taotoken.net/api。这两个值后面会分别填进环境变量和settings.json。创建 Key 的入口在这里控制台 API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite如果你还没决定用哪个模型可以先在模型对话页面确认一下可用模型名比如claude-3-5-sonnet-20241022这类。模型名要填对填错了 Claude Code 启动时会报模型不存在。模型对话https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档里有完整的参数说明配置过程中拿不准字段含义时可以对照看接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite把 Key 和地址记下来别直接贴在会提交到 Git 的文件里。下面进入安装环节。3. winget 安装与环境变量配置3.1 用 winget 装 Claude CodeWindows 上推荐用 winget省去手动配 Node 环境的麻烦。打开 PowerShell普通权限即可不用管理员执行winget install Anthropic.ClaudeCode装完后验证一下命令是否可用claude --version如果输出了版本号说明 CLI 已经进 PATH 了。如果提示claude 不是内部或外部命令多半是 PATH 没刷新关掉当前终端重开一个或者手动把安装目录加进 PATH。3.2 设置环境变量环境变量是最省事的接入方式Claude Code 启动时会读。在 PowerShell 里设置当前用户级别的变量setx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_AUTH_TOKEN 你的APIKeysetx写的是用户级持久变量设置完要重开终端才生效。想临时验证也可以先用$env:前缀设当前会话变量$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN 你的APIKey这里有个容易踩的坑ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY是两个不同的变量名Claude Code 认的是前者。填错变量名请求会因为没有认证信息被拒。3.3 跳过首次登录引导第一次启动claude如果卡在引导页可以在用户目录的.claude.json里加一个标记跳过。文件路径是C:\Users\你的用户名\.claude.json。用 PowerShell 一条命令搞定powershell -Command $f%USERPROFILE%\.claude.json;$jGet-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName hasCompletedOnboarding -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $fhasCompletedOnboarding为true表示不再显示新手引导。如果文件不存在先手动建一个内容为{}的.claude.json再执行。4. settings.json 配置骨架可复制环境变量能跑通但项目多了之后你可能想按项目或按用户统一管理配置。Claude Code 支持settings.json用户级路径在C:\Users\你的用户名\.claude\settings.json。下面是一份可直接复制的骨架字段都加了注释说明{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: claude-3-5-sonnet-20241022, ANTHROPIC_DEFAULT_OPUS_MODEL: claude-3-opus-20240229, ANTHROPIC_DEFAULT_HAIKU_MODEL: claude-3-haiku-20240307, ANTHROPIC_DEFAULT_SONNET_MODEL: claude-3-5-sonnet-20241022, ANTHROPIC_AUTH_TOKEN: 你的APIKey, DISABLE_AUTOUPDATER: 1, ENABLE_TOOL_SEARCH: true, CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: 1, IS_SANDBOX: 1, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1 }, includeCoAuthoredBy: false, permissions: { defaultMode: bypassPermissions }, skipDangerousModePermissionPrompt: true, theme: dark-ansi, hasCompletedOnboarding: true }几个关键字段解释一下。ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_AUTH_TOKEN填你的 Key。ANTHROPIC_MODEL是默认模型ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL分别对应不同档位的模型Claude Code 会根据任务自动切换。DISABLE_AUTOUPDATER设为1关掉自动更新避免更新打断工作。permissions.defaultMode设为bypassPermissions表示不弹权限确认适合自动化场景但你要清楚这意味着 Claude Code 执行命令时不会每次问你。注意bypassPermissions会跳过危险操作确认建议只在可信项目里用。生产环境或敏感仓库改成默认模式更稳妥。配置优先级上settings.json里的env会覆盖系统环境变量。如果你两边都设了以settings.json为准。所以排查问题时先确认到底哪份配置在生效。5. 验证请求一条 curl 打通调用链路配置写完别急着开 Claude Code先用 curl 验证 API 通道本身通不通。这一步能把「Key 错」「地址错」「网络不通」三类问题提前暴露出来。curl -X POST https://taotoken.net/api/v1/messages \ -H Content-Type: application/json \ -H x-api-key: 你的APIKey \ -H anthropic-version: 2023-06-01 \ -d { model: claude-3-5-sonnet-20241022, max_tokens: 64, messages: [ {role: user, content: 回复一句通道正常} ] }如果返回里带了content字段和模型回复文本说明 Key、地址、模型名三者都对。如果返回401检查 Key 是否复制完整、有没有多余空格。返回404多半是模型名写错或地址路径不对。返回超时先确认网络能访问taotoken.net。curl 通了之后再启动 Claude Codeclaude进入交互界面后随便问一句让它读当前目录的文件比如「列出当前目录的文件并解释项目结构」。如果它能正常调用工具、返回结果说明整条链路在 Windows 上跑通了。6. 本篇常见报错排查清单下面这些是我在 Windows 上配 Claude Code 时实际遇到过的按现象对号入座。报错一claude 不是内部或外部命令winget 装完 PATH 没刷新。关掉终端重开或者手动把%LOCALAPPDATA%\Microsoft\WinGet\Packages下的 Claude Code 目录加进 PATH。报错二启动后一直停在引导页.claude.json里没加hasCompletedOnboarding: true。按第 3.3 节的命令补上或者直接在settings.json里加这个字段。报错三401 UnauthorizedANTHROPIC_AUTH_TOKEN没设或设错。注意变量名是AUTH_TOKEN不是API_KEYKey 前后不要有空格。用echo $env:ANTHROPIC_AUTH_TOKEN确认当前会话里读到的值。报错四Connection error或请求超时ANTHROPIC_BASE_URL填错或者网络访问不了。先用第 5 节的 curl 单独验证地址排除是 Claude Code 本身的问题还是通道问题。报错五模型不存在 /model not foundANTHROPIC_MODEL或几个DEFAULT_*_MODEL字段填了不存在的模型名。去模型对话页面确认可用模型名逐字对照。报错六改了配置不生效环境变量和settings.json同时存在优先级搞混了。记住settings.json的env覆盖系统环境变量。排查时先看settings.json再看环境变量。报错七每次执行命令都弹权限确认permissions.defaultMode没设成bypassPermissions或者skipDangerousModePermissionPrompt没开。按第 4 节骨架补齐。7. 长期编码与 Agent 场景的下一步单次调用跑通只是起点。如果你打算把 Claude Code 当成日常编码工具或者跑 Agent 类的自动化任务配置上还有两件事值得做。一是把模型档位配清楚。Opus 能力强但成本高Haiku 快而便宜Sonnet 居中。日常改代码用 Sonnet复杂重构切 Opus简单补全走 Haiku靠ANTHROPIC_DEFAULT_*_MODEL这几个字段控制Claude Code 会按任务自动选。二是考虑 Coding Plan 这类长期方案适合需要稳定额度、频繁调用、跑 Agent 工作流的场景。相比按次计费长期编码场景下更省心。Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite配置骨架和验证命令都在上面了照着走一遍Windows 上跑 Claude Code 这件事基本就没什么悬念了。真遇到卡住的地方先回到 curl 那一步把通道和 Key 单独验一遍大部分问题都能定位到具体是哪一层出的错。