Claude Code 是 Anthropic 出的命令行 AI 编程工具,它不开网页、不开 IDE 插件,直接蹲在终端里读你的代码库、改文件、跑命令,对天天泡在命令行里的人来说顺手得很。但很多人第一次装它,还没摸到它能干什么,就先被一行红字拦下了:
Unable to connect to Anthropic services
这行报错看着像出了大事,其实跟你装得对不对、账号有没有问题基本没关系。下面把整条路走一遍——环境、安装、登录、连接,重点会落在最后那个让大多数人卡住的地方。
动手前先把这几样备齐
缺一样后面就得回头补,开始前花两分钟核对一下:
- 一台装了 Node.js 的电脑。Windows、macOS、Linux 都行,工具本身不挑系统,建议装较新的长期支持版本。
- 一个顺手的终端。macOS 用自带终端或 iTerm;Windows 别用老旧的 cmd,换较新的 PowerShell 或 WSL 体验会好不少。
- 一个 Anthropic 账号,登录授权要用。
- 一条稳的跨境网络。这一项最容易被跳过,偏偏它才是后面能不能连上 api.anthropic.com 的命门。
前三样准备起来都没什么悬念,真正决定成败的是第四样。把它放在最前面确认,比装完一通再回头排查省事得多。
安装:npm 一行命令的事
Claude Code 走 npm 全局安装,在终端里执行官方给的全局安装命令就行。要是 Node.js 还没装,先去官网装好再回来,顺序别反过来。装完输入 claude 启动,终端能认出这个命令、顺利进交互界面,本体就算到位了。
这一步几乎不会出岔子,所以不用纠结,命令能被识别就往下走。真正的硬骨头在连接那一关。
首次登录授权:浏览器拉不起来多半是网络
第一次跑 claude,它会引导你登录,把本地工具和 Anthropic 账号绑在一起。授权过程通常会自动拉起浏览器,你登录完它再跳回终端完成绑定。这些授权信息会写进用户目录下的配置文件,下次启动自动读,不用每次重登,所以这一步顺顺当当做一次就够。
如果浏览器迟迟拉不起授权页,或者登录完回到终端半天没动静,别急着怀疑账号——这种情况九成是网络没到位。授权这一步要在浏览器和终端之间来回跳一次,对网络的连贯性要求比平时跑命令更高,链路稍微抖一下回跳就接不上。先把它记下来,统一留到连接那一步处理,在这儿反复重试纯属浪费时间。
/status:改一次配置就自检一次
进了交互界面,输入 /status,当前的连接配置和账号状态会一目了然:工具实际连的是哪个地址、授权到底生没生效,它都告诉你。排查配置问题,这条命令是最趁手的。养成习惯,每次动过配置就 /status 看一眼,能省下大把瞎猜的工夫。
连接这关:问题不在工具,在网络握手
Claude Code 默认连 Anthropic 的官方服务,而这个地址直连往往不稳,开头那行 Unable to connect to Anthropic services 就是这么来的。它的本质是网络握手没完成,不是工具坏了。所以解法的方向很清楚:别去折腾工具,给它一条稳的跨境通道。
第一下:先把网络通道连好
用网络加速器连上一个就近的全球节点,等它显示连接成功、网络确实通畅了,再做下一步。这一下没做扎实,后面新开多少窗口都是白搭。
第二下:新开终端窗口再启动 claude
这里必须新开一个终端窗口跑 claude,不能在原来那个里接着试。原因是命令行工具启动时只读当前会话的网络环境,老窗口里残留的旧状态它不会主动刷新——你网络都连好了,却在老终端里启动,照样连不上。连上之后再 /status 确认一次,账号和连接都正常,整套配置就彻底跑通了。后面日常用,只要先连网络再启动,基本不会再撞上连接报错。
跑通之后,这些小习惯能让它更稳
挑节点看延迟,不是看带宽
命令行 AI 编程是高频小请求,一来一回都很短,低延迟比大带宽要紧得多,所以优先挑物理距离近、走专线的全球节点。改动配置后记得新开终端再启动,老窗口里的旧环境变量不会自动更新。长会话突然变慢,先 /status 看连接还在不在,再决定要不要重连。
把通道一直挂着,省得临时找
还有两点值得记住。把网络加速器设成开机自启、留在后台跑,这样每次打开终端用 Claude Code,底层通道已经是连好的,省去临时等待,也避免你忘了连网络又对着报错发懵。另外,长时间没操作再回来,工具可能因为空闲被服务端断开,这时随手发一条指令触发重连就行,不用退出重开;要是发了指令还是没反应,再 /status 看一眼连接状态,多半是后台通道也跟着掉了,重连网络就好。
常见的几个坑
新手栽跟头的地方就那么几处,对照看看:
| 现象 | 真正的原因 | 怎么办 |
| 改了配置还是连不上 | 在老终端里跑,环境变量没刷新 | 新开窗口再启动 |
| 偶尔能连、偶尔报错 | 链路抖动,不是工具有 bug | 换条稳定线路 |
| 授权和长会话总被打断 | 挂在人多的共享出口上 | 换一个相对干净的出口 |
| 第一次启动就卡死 | 只顾装工具,跨境网络没准备 | 把网络这项提到最前面确认 |
说到底,把 Claude Code 跑起来,难的从来不是工具,而是底下那条要稳的跨境网络。这条线理顺了,前面安装、登录那些步骤才不算白做,注意力也才能真正回到写代码上,而不是反复跟连接报错较劲。如果你手头还没有趁手的线路,通宝VPN 提供就近的全球节点和低抖动专线,全平台都能装,每天还有 200MB 永久免费流量——先拿它连上实测一遍 Claude Code 稳不稳,觉得顺再考虑长期方案也不迟。









