安装与启动类问题

首次启动即报 Unable to connect to Anthropic services

现象：Claude Code 安装后第一次执行 claude，终端打印以下错误并退出：

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
Please check your internet connection and network settings.

修复：用文本编辑器打开 ~/.claude.json（Windows 为 C:\Users\用户名\.claude.json），在最外层 JSON 对象中添加：

"hasCompletedOnboarding": true

完整写法参考：

{
  "installMethod": "unknown",
  "autoUpdates": true,
  "firstStartTime": "2025-07-14T06:11:03.877Z",
  "userID": "...",
  "projects": { },
  "hasCompletedOnboarding": true
}

注意 projects 字段末尾的 } 后面要加英文逗号 ,，否则 JSON 格式非法。保存后可用以下命令验证格式：

cat ~/.claude.json | python3 -m json.tool

无报错即格式正确，重新执行 claude 进入交互界面。

command not found: claude

npm 全局 bin 目录未加入 PATH。执行 npm config get prefix 查看路径，将对应的 /bin 目录追加到系统 PATH。

permission denied / EACCES 错误（Mac / Linux 安装时）

不要使用 sudo，把 npm 全局目录改到用户目录：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc   # zsh 用户改为 ~/.zshrc
source ~/.bashrc

permission denied 错误（Windows 安装时）

以管理员身份运行 PowerShell：

npm config set prefix "$env:APPDATA\npm"
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

旧版 npm 安装的 Claude Code 如何清理？

当前官方推荐使用原生安装脚本，不再推荐 npm 安装。先备份 ~/.claude，再清理旧包：

# Mac / Linux
if [ -d ~/.claude ]; then cp -r ~/.claude ~/.claude.backup; fi
npm list -g --depth=0
npm uninstall -g @anthropic-ai/claude-code

# Windows PowerShell
if (Test-Path "$env:USERPROFILE\.claude") { Copy-Item "$env:USERPROFILE\.claude" "$env:USERPROFILE\.claude.backup" -Recurse }
npm list -g --depth=0
npm uninstall -g @anthropic-ai/claude-code

清理后使用原生安装脚本重新安装：

# Mac / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

也可使用包管理器：macOS 用 brew install --cask claude-code，Windows 用 winget install Anthropic.ClaudeCode。