问题描述

在配置API KEY后，使用 Claude Code 时，每次启动程序都会弹出报错，不可使用，信息如下

Unable to connect to Anthropic services

Failed to connect to api.anthropic.com:ERR_BAD_REQUEST

Please check your internet connection and network settings.

Note: Claude Code might not be available in your country. Check supported countries at

https://anthropic.com/supported-countries

原因分析：

Claude Code 会在用户主目录下生成一个本地状态文件 .claude.json，其中包含一个关键字段 hasCompletedOnboarding，用于标记用户是否已经完成了初次引导流程。

hasCompletedOnboarding: true：表示引导已完成，程序启动后直接进入工作模式。

hasCompletedOnboarding: false：表示引导未完成，程序会在每次启动时尝试引导用户。

当该字段因某种原因（我的话是第一次使用的时候还没有配置API KEY，没有正常进入初次引导流程导致）被错误地设置为 false 时，就会无法正常使用。

解决方案：

手动将 .claude.json 文件中的 hasCompletedOnboarding 字段修改为 true 即可绕过引导流程，使程序直接进入正常交互状态。

方法一：使用 PowerShell 命令

打开 PowerShell，执行以下命令：

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

方法二：手动编辑文件

• 打开文件资源管理器，进入用户主目录（例如 C:\Users\你的用户名）。

• 找到并打开 .claude.json 文件（可能需要显示隐藏文件）。

• 找到 “hasCompletedOnboarding” 字段，将其值改为 true。

• 保存文件。

示例修改后的文件片段：

json
{
  "hasCompletedOnboarding": true,
  ...
}