为什么重装N次还是不行?
让我们先搞清楚问题的本质。
当你运行 npm install -g @anthropic-ai/claude-code 时,npm 确实会下载最新的代码包,覆盖掉旧版本的程序文件。但问题就出在这里——npm 只负责程序文件,完全不管你的个人配置。
这些个人配置藏在哪里呢?就在你的用户目录下,以“点”开头的隐藏文件夹里:
.claude– 存储你的登录状态、API Key 缓存、调试日志.chelper– 旧版 Coding Helper 工具的配置残留.zai– 如果你配置过智谱AI接口,这里会有缓存
更隐蔽的是,有时候进程没有完全退出,还会留下临时文件,比如:
.claude.json.backup.1771385407634.claude.json.tmp.7252.1771379478006
这些文件就像房间角落的灰尘,你不专门去扫,它们就永远在那里。而 Claude Code 启动时,会优先读取这些旧配置,于是就陷入了“用旧钥匙开新锁”的死循环。
所以,真正的解决方案不是反复重装,而是彻底清理 + 全新安装。
彻底清理:三个文件夹,一个都不能少
清理工作需要细心,因为 Windows 默认不显示隐藏文件和文件夹。别担心,我会给你最详细的操作指引。
第一步:关闭所有终端窗口
在开始之前,请务必关闭所有 PowerShell、CMD、Git Bash 等终端窗口。这是为了防止有进程还在占用配置文件,导致删除失败。
第二步:手动删除这三个隐藏文件夹
打开文件资源管理器,在地址栏输入 %USERPROFILE% 并回车,这就是你的用户目录。然后按照下面的路径,一个个找过去:
1. 删除 .claude 文件夹
这是最核心的配置目录,存放着:
- OAuth 登录状态(就是那个让你扫码登录的信息)
- 错误的 API Key 缓存
- 所有的调试日志和会话记录
操作路径:C:\Users\你的用户名.claude
操作方法:直接选中整个 .claude 文件夹,按 Shift + Delete 永久删除。
2. 删除 .chelper 文件夹
如果你之前用过“Coding Helper”这类辅助工具,这个文件夹就是它的配置残留。虽然名字不同,但可能会和 Claude Code 产生冲突。
操作路径:C:\Users\你的用户名.chelper
操作方法:同样直接删除整个文件夹。
3. 删除 .zai 文件夹
这是为智谱AI(z.ai)用户准备的。如果你之前配置过智谱的接口,这里会有相关缓存。清理它能确保后续配置从头开始。
操作路径:C:\Users\你的用户名.zai
操作方法:删除整个文件夹。
第三步:清理残留的临时文件
在用户目录下,你可能会看到一些奇怪的 .json 文件,比如:
.claude.json.backup.1771385407634.claude.json.tmp.7252.1771379478006.claude.json.tmp.9140.1771380674239.claude.json.tmp.10336.1771380882396
这些是程序崩溃时留下的“尸体”,必须清理干净。
操作方法:在用户目录下,按 Ctrl + F 搜索 *.json.backup* 和 *.json.tmp*,把所有搜到的文件都删除。