故障排查

平台特定问题

问题1：PowerShell执行策略限制

powershell

# 错误信息
claude : 无法加载文件,因为在此系统上禁止运行脚本。

解决方案:

powershell

# 方法1：修改执行策略（推荐）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 方法2：使用CMD而不是PowerShell
# Win+R → cmd

问题2：Windows Defender误报

bash

# 症状：安装过程中文件被删除
# 解决方案：添加claude-code目录到排除列表
# Windows安全 → 病毒和威胁防护 → 排除项
# 添加：C:\Users\<用户名>\AppData\Local\claude-code

问题3：命令找不到

bash

# 症状
'claude' 不是内部或外部命令

# 解决方案：手动添加到PATH
# Win+R → sysdm.cpl → 高级 → 环境变量
# 添加：C:\Users\<用户名>\AppData\Local\claude-code

问题1：命令找不到但已安装

bash

# 症状
claude: command not found

# 解决方案
source ~/.zshrc
# 或重新打开终端

问题2：权限被拒绝

bash

# 解决方案：不需要sudo了
# 原生安装到用户目录
ls -la ~/.local/bin

问题1：网络连接失败

bash

# 解决方案：配置代理
export https_proxy=http://127.0.0.1:7890
curl -fsSL https://claude.ai/install.sh | bash

问题：无法访问api.anthropic.com

bash

# 方案1：配置代理（推荐）
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

# 方案2：修改DNS
# 设置DNS为8.8.8.8或114.114.114.114

问题1：环境变量未设置

bash

# 检查是否配置
echo $ANTHROPIC_API_KEY
# 应该看到：sk-ant-...

# 如果没有,手动添加
echo 'export ANTHROPIC_API_KEY="你的key"' >> ~/.zshrc
source ~/.zshrc

问题2：Key无效或过期

json

{
  "error": {
    "type": "authentication_error",
    "message": "invalid x-api-key"
  }
}

解决方法:

如果以上方法都无法解决问题: