news 2026/6/13 15:02:55

Claude Code(Windows)安装、配置与使用全流程总结

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Claude Code(Windows)安装、配置与使用全流程总结

一、你遇到的核心问题是什么

在 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 / 辅助编程

正确流程
  1. 清理所有旧鉴权

  2. 重新登录

  3. 明确拒绝 API Key

claude logout claude login

看到提示Use API key?
👉 明确输入No

最终状态应当是:

只有 ANTHROPIC_AUTH_TOKEN

四、为什么你“重启了还是报错”

这是整个过程里最关键的认知点

Claude Code 的鉴权来源不止一个:

  1. 当前 PowerShell 环境变量

  2. 用户级环境变量

  3. 系统级环境变量

  4. 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.ts
fix src/main.ts

切换或查看模型(可选)

/model

八、amend在这个体系里的含义

你后面看到的amendrefactorfix都遵循一个原则:

在现有内容基础上做修订,不是重来

尤其在 Git / Claude Code 场景里:

  • amend = 修补刚刚的成果

  • refactor = 重组结构但不改语义

  • fix = 修明确问题


九、一句话经验总结(以后不踩坑版)

在 Windows 上用 Claude Code:
只用一种鉴权方式 + 切换时必删 ~/.claude

这是最核心的“工程结论”。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/13 4:04:24

nodejs计算机毕设之基于nodejs的半亩菜园线上预售系统的设计与实现(完整前后端代码+说明文档+LW,调试定制等)

博主介绍&#xff1a;✌️码农一枚 &#xff0c;专注于大学生项目实战开发、讲解和毕业&#x1f6a2;文撰写修改等。全栈领域优质创作者&#xff0c;博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围&#xff1a;&am…

作者头像 李华
网站建设 2026/6/11 10:12:35

Flutter for OpenHarmony音乐播放器App实战08:搜索实现

搜索功能是音乐播放器中使用频率最高的功能之一。用户可以通过搜索快速找到想听的歌曲、歌手或专辑。本篇文章将详细介绍如何实现一个功能完善的搜索页面&#xff0c;包括搜索建议、热门搜索、搜索历史以及多类型搜索结果展示。 页面基础结构 搜索页面使用StatefulWidget&…

作者头像 李华
网站建设 2026/6/13 7:43:04

Agentic AI竞争优势TOP5:提示工程架构师提升用户满意度的关键技巧

Agentic AI竞争优势TOP5:提示工程架构师提升用户满意度的关键技巧 引言:为什么Agentic AI是下一个用户体验拐点? 你有没有遇到过这样的AI交互痛点? 问“推荐科幻片”,AI给了一堆选项,你补充“不要太黑暗”,它却像没听见一样,重复推荐《银翼杀手2049》; 问“明天北京…

作者头像 李华
网站建设 2026/6/10 19:12:39

天猫UV量提高实用指南:找准方向,稳步突破流量瓶颈

每天守着天猫店铺刷新后台&#xff0c;看着寥寥无几的UV数据&#xff0c;是不是既焦虑又无奈&#xff1f;明明投入了不少时间和成本优化商品、做活动&#xff0c;却始终打不开流量局面&#xff0c;业绩目标近在眼前却难以触及。其实&#xff0c;天猫UV量提高并非靠盲目堆砌运营…

作者头像 李华