Claude /init 报错 ConnectionRefused 解决

报错含义：本地客户端无法连接 Claude 本地 API 服务，端口被拒绝连接，核心是服务没启动、端口占用、配置错误、防火墙 / 代理拦截。

快速按顺序排查修复

1. 最简单：完全重启

关闭所有终端、VSCode / 编辑器，重新打开终端，再次执行：

bash

运行

claude /init

无效就重启电脑再试。

2. 检查端口占用（最常见）

Claude Code 默认占用本地端口，先查是否被占用：

Windows PowerShell

powershell

netstat -ano | findstr 11520

Mac/Linux

bash

运行

lsof -i :11520

有输出说明端口被占，去 Claude 配置里更换监听端口即可。

3. 关闭全局代理 / 科学上网

全局代理会拦截本地环回请求，关掉系统全局代理，只保留浏览器代理，再执行初始化。

4. 放行防火墙 / 杀毒

临时关闭 Windows 防火墙、火绒 / 360 等安全软件，再试；能连上就把 Claude 程序、端口加入防火墙白名单。

5. 重装修复 Claude Code

bash

运行

# 卸载
npm uninstall -g @anthropic-ai/claude-code
# 重装
npm install -g @anthropic-ai/claude-code

装完再运行：

bash

运行

claude /init

6. 检查自定义 API 地址

如果你手动改过 Claude 的 API 中转地址，改回默认本地 localhost，不要填错误远端代理地址。