AINCRAD

Claude Code安装环境配置典型报错问题解决

2026/3/12 Claude Code

# Claude Code安装环境配置典型报错问题解决

# 典型报错

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
1
2

# 解决方法

方案1：开启网络代理并打开tun模式（优先推荐） 方案2：手动替换Claude配置文件内容，分系统操作步骤如下：

# Windows系统

  1. 进入路径：C盘\用户\你的用户名\.claude
  2. 找到目录下的.json配置文件，将原有内容完整替换为以下代码：
{
"installMethod": "unknown",
"hasCompletedOnboarding": true
}
1
2
3
4

# Mac/Linux系统

  1. 打开系统终端，执行命令打开配置文件：
nano ~/.claude.json
1
  1. 删除文件原有所有内容，粘贴上述JSON配置代码
  2. 按ctrl+o保存修改，按ctrl+x退出编辑界面

# 报错1：claude命令未被识别

# 报错信息

claude : 无法将“claude”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。
1

# 解决方法

打开PowerShell，执行以下全局安装指令：

npm install -g @anthropic-ai/claude-code
1

# 报错2：Git路径未找到/环境变量异常

# 报错信息

Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path “C:\Program Files\Git\bin\bash.exe”
1

# 解决方法

  1. 未安装Git：直接下载并安装Git官方客户端，安装时勾选「添加到系统环境变量」；
  2. 已安装Git：检查系统环境变量中是否配置了Git的路径，若配置错误/缺失，可卸载Git后重新安装（重新安装会自动配置基础环境变量）。

# 报错3：PowerShell脚本运行权限被禁止

# 报错信息

claude : 无法加载文件 ~\AppData\Roamning\npm\claude.ps1,因为在此系统上禁止运行脚本。
1

# 解决方法

  1. 以管理员身份打开PowerShell；
  2. 执行以下权限配置命令，弹出确认提示时输入Y并回车：
Set-ExecutionPolicy RemoteSigned
1
Last Updated: 2026/10/30 10:27:14