一、你遇到的核心问题是什么
在 Windows 环境下使用 Claude Code 时，最容易踩的坑是：
同时存在两种鉴权方式
ANTHROPIC_AUTH_TOKEN（CLI 登录态）ANTHROPIC_API_KEY（API Key）
Claude Code强制只允许一种
一旦同时存在，直接报错
Auth conflict
这个问题和代码无关，和模型无关，纯配置问题。
二、Claude Code 的正确安装方式（现状）
Claude Code 已从 npm 版切换为原生安装器：
claude install如果你已经能直接运行claude并进入交互界面，说明安装已完成，这一步不是必须回头重做。
三、Windows 下的“正确鉴权姿势”（重点）
推荐方案：CLI 登录态（本地开发最稳）
适合场景：
本地写代码
Claude Code 交互式使用
MCP / Agent / 辅助编程
正确流程
清理所有旧鉴权
重新登录
明确拒绝 API Key
claude logout claude login看到提示Use API key?
👉 明确输入No
最终状态应当是：
只有 ANTHROPIC_AUTH_TOKEN四、为什么你“重启了还是报错”
这是整个过程里最关键的认知点。
Claude Code 的鉴权来源不止一个：
当前 PowerShell 环境变量
用户级环境变量
系统级环境变量
Claude 自己的本地配置缓存（~/.claude）
👉 重启只能刷新前 3 个
👉第 4 个必须手动删
五、一次性“打穿式”清理方案（标准解法）
1️⃣ 清空所有 ANTHROPIC 环境变量
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", $null, "Machine") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "Machine")2️⃣ 删除 Claude Code 本地缓存（关键）
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude" -ErrorAction SilentlyContinue Remove-Item -Recurse -Force "$env:USERPROFILE\.config\claude" -ErrorAction SilentlyContinue这一步不做，99% 会继续报 Auth conflict。
3️⃣ 重新登录
claude login只保留一种鉴权方式。
六、如何判断“现在已经正常了”
正常状态的标志
你看到的是类似这样的界面：
/model to try Opus 4.5 > Try "refactor <filepath>" ? for shortcuts结论
这不是报错
这是 Claude Code 的欢迎 / 引导界面
说明鉴权已成功、CLI 已进入工作态
七、Claude Code 的基础使用（你已经能用了）
查看目录
ls pwd tree让 Claude 理解项目
explain .explain src让 Claude 帮你改代码
refactor src/index.tsfix src/main.ts切换或查看模型（可选）
/model八、amend在这个体系里的含义
你后面看到的amend、refactor、fix都遵循一个原则：
在现有内容基础上做修订，不是重来
尤其在 Git / Claude Code 场景里：
amend = 修补刚刚的成果
refactor = 重组结构但不改语义
fix = 修明确问题
九、一句话经验总结（以后不踩坑版）
在 Windows 上用 Claude Code：
只用一种鉴权方式 + 切换时必删 ~/.claude
这是最核心的“工程结论”。
