Claude Code 常见问题排查

Claude Code 常见问题排查

使用 Claude Code 过程中遇到问题？本文整理了最常见的错误及解决方案。

1. 环境干扰：之前配置过其他中转站

如果你之前使用过其他中转服务，旧的配置可能会干扰 RootFlow AI 的正常使用。

推荐方案：彻底清理（100% 生效）

以下操作会删除 Claude Code 的本地数据，包括聊天记录和 MCP 配置。如需保留，请查看下方的"温和方案"。

Windows：

Remove-Item "$env:USERPROFILE\.claude" -Recurse -Force

macOS / Linux：

rm -rf ~/.claude

执行后： 1. 重新打开终端 2. 按 安装教程 重新配置环境变量 3. 启动 claude

温和方案：仅清理配置文件

进入 ~/.claude 目录，检查以下文件：

~/.claude/
├── config.json
├── settings.json
└── env.json（如存在）

删除或修改其中包含的旧 base_url、api_key 或旧中转站域名，然后重启终端。

检查环境变量是否被污染

确认系统中不存在以下旧环境变量：

Windows（PowerShell）：

Get-ChildItem Env: | findstr CLAUDE
Get-ChildItem Env: | findstr ANTHROPIC

macOS / Linux：

env | grep -E "CLAUDE|ANTHROPIC"

如果发现旧值，删除后重新打开终端。

• 首次使用或切换中转站时：直接删除 .claude 目录，最省心
• 有重要历史记录时：优先使用"仅清理配置文件"方案
• 每次修改环境变量后，务必重新打开终端

2. npm -v 报错：禁止运行脚本

错误信息：

无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。

原因： Windows 默认禁止运行未签名的 PowerShell 脚本。

解决方案：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

选择 Y 确认，然后重试 npm -v。

3. 国家/地区限制错误

现象： 提示地区不支持或访问被拒绝。

原因： 环境变量未正确配置，请求没有走中转服务。

解决方案：

1. 检查环境变量是否正确设置（参考 配置教程） 2. 确认 ANTHROPIC_BASE_URL 的值为 https://api.rootflowai.com 3. 执行 source ~/.zshrc（macOS/Linux）或重新打开 PowerShell（Windows） 4. 重启终端后再试

4. claude --version 报错：禁止运行脚本

错误信息： 与 npm -v 报错类似，提示无法加载 claude.ps1。

原因： npm 全局安装时生成了 .ps1 脚本，被 PowerShell 执行策略拦截。

解决方案：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

确认后重试。

5. 无法将 "claude" 识别为 cmdlet

现象： 安装了 Claude Code，但运行 claude 提示找不到命令。

原因： npm 全局安装路径不在系统 PATH 中。

解决方案：

1. 查看 npm 全局安装路径：

npm config get prefix

2. 确认输出的路径（通常是 C:\Users\<用户名>\AppData\Roaming\npm）是否在 PATH 环境变量中 3. 如果不在，手动将该路径添加到系统 PATH 4. 清理并重新安装：

npm cache clean --force
npm install -g @anthropic-ai/claude-code

6. Git Bash 报错

错误信息：

Claude Code on Windows requires git-bash

原因： Claude Code 在 Windows 上需要 Bash 环境，而系统未安装 Git。

解决方案：

下载安装 Git for Windows，安装时保持默认选项。安装完成后关闭并重新打开 PowerShell，再运行 claude。

7. 余额不足错误

现象： 提示 credit balance 不足或额度用尽。

原因： 之前使用过其他服务，残留的用户级配置覆盖了当前环境变量。

解决方案： 删除旧配置目录：

Windows：

Remove-Item "$env:USERPROFILE\.claude" -Recurse -Force

macOS / Linux：

rm -rf ~/.claude

然后重新配置环境变量并启动。

8. 403 Your client is not authorized

错误信息：

403 Your client is not authorized to use this API key

解决方案：

在 Claude Code 中执行 /logout 命令退出登录，然后重新启动即可。

以上方案仍无法解决？查看 API 文档 或加入用户群联系我们。