Claude Code 命令行教程
终端里的编程 agent · 全平台通用

Claude Code 装进终端,接上 Anti-Thor

Anthropic 官方的命令行 agent,一条命令装完,不用先装 Node。装完还差两件事:绕过首次启动那个连不上官方的报错,再把中转站的 Key 配进去。这两步缺一个都跑不起来,本篇全程带你走完。

原生安装器 5 步走完 约 10 分钟 Windows / macOS / Linux
00

开始之前

先搞清楚它是什么,以及你需要准备什么

  • 一台 Windows 10/11macOS 10.15 以上,或者 Ubuntu 18.04+ / CentOS 7+ / Debian 9+ 的机器。远程服务器同样适用。
  • 一个 Anti-Thor 的 API Keysk- 开头)。还没有的话,先看站内的《中转站使用教程》创建一个,本篇假设你手上已经有了。
  • 预留 10 分钟。全程敲命令,但每条都能直接复制。
Claude Code 是什么Anthropic 官方出的终端编程 agent。它跑在命令行里,不依赖 VS Code——你 cd 到哪个项目目录,它就在那个目录里读代码、改文件、跑命令。想在编辑器里用图形界面的,那是另一份《VS Code 插件安装》教程的事,两者互不冲突,装哪个看你习惯。
装完还有两件事要做很多人卡在这儿:装上不等于能用。走中转站的话,还得①跳过首次启动的初始化确认(第 2 步),②把 Key 和地址配进去(第 3 步或第 4 步二选一)。这两件事缺任何一件,启动都会失败。

另外说一句:本篇装的是原生安装器版本,不需要你先装 Node.js。只有走 npm 那条老路才要 Node 18+,而我们不推荐那条路,原因见第 1 步末尾。

01

安装 Claude Code

选你的系统,复制粘贴,一条命令的事

下面按系统分了三个页签,点一下切换,只看你自己那一个就行。选中的页签会记住,后面几步也跟着切。

PowerShell 跑(开始菜单搜 PowerShell,右键以管理员身份运行更稳):

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

习惯用 CMD 的,用这条:

命令提示符 CMD
>curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

装了 Homebrew 的直接用这条,最省事:

终端
$brew install --cask claude-code

没有 Homebrew,或者不想为这个专门装一个,用官方安装脚本:

终端
$curl -fsSL https://claude.ai/install.sh | bash

各发行版通用,一条脚本搞定:

终端
$curl -fsSL https://claude.ai/install.sh | bash

远程服务器上装也是这条,SSH 连上去照跑不误。

1.1 验证装没装上

装完关掉终端重新开一个(让 PATH 生效),然后:

终端
$claude --version
1.0.108 (Claude Code)

能打印出版本号就算装好了。版本号不用和上面一模一样,官方一直在更新,你的更新更好。

网上那些 npm 安装的教程,别跟着做npm install -g 那条路版本更新滞后,装出来的经常是旧版,而且还得先装 Node。上面的原生安装器自带更新机制,装完就不用管了。已经用 npm 装过的,可以先卸掉再按上面重装一遍。
02

跳过首次初始化报错

走中转站的人一定会撞上这一步

装好之后第一次输 claude,大概率直接糊你一脸红色报错:

首次启动的报错 终端里 Claude Code 首次启动的画面:欢迎语下方是红色报错,提示无法连接到 Anthropic 服务、连接 api.anthropic.com 失败
首次启动报错 · 关键词是 Unable to connect / Failed to connect

这不是你装错了。Claude Code 第一次启动会去连官方 API 做一次初始化确认,而中转渠道压根不经过官方那个地址,这一步自然过不去。解决办法是让它跳过这次确认,下面两个方法挑一个。

2.1 方法一:用 CC-Switch 一键跳过(推荐)

CC-Switch 是个图形化的配置管理小工具,从 ccswitch.lovable.app 下载对应 Windows / macOS 的安装包装上。打开后进 「设置」→「通用」,找到「跳过 Claude Code 初次安装确认」,把开关打开:

开关在这儿 CC-Switch 设置页的通用选项卡,跳过 Claude Code 初次安装确认这一项被红框标出,开关处于开启状态
CC-Switch「通用」设置 · 打开红框里那个开关就行

开完这个开关,顺手就能在同一个工具里把第 3 步的配置也填了,推荐走这条路

2.2 方法二:手动改配置文件

不想装额外工具的,手动改一个 JSON 文件也行。文件在你的用户主目录下:

WindowsC:\Users\你的用户名\.claude.json
macOS / Linux~/.claude.json

用记事本或任意编辑器打开,在 JSON 的最后一个字段后面加上这一行:

~/.claude.json
{
  ... 原有的内容 ...,
  "hasCompletedOnboarding": true
}
那个逗号,别漏加这一行之前,上一个字段的末尾要补一个英文逗号,不然就是坏掉的 JSON,Claude Code 会直接起不来——而且报的错还跟这事看着没关系,特别难排查。改完先自己扫一眼:逗号是英文的、引号是英文的、最后一行没有多余逗号

保存之后再跑一次 claude,那个红色报错就没了。

03

用 CC-Switch 填入 Anti-Thor 配置

图形界面点几下,比敲环境变量省心

这一步和第 4 步二选一。装了 CC-Switch 的走这里,不想装的直接跳到 第 4 步 敲环境变量。

这一步又有两个办法:一键导入最省事,全自动不用打字;手动新建适合已经有配置想改、或者一键导入没唤起的情况。优先试一键导入。

3.1 办法一:一键导入(推荐)

登录 Anti-Thor 后台,点左侧 「API 密钥」。在你要用的那个 Key 那一行,最右边 操作 列里点 「导入到 CCS」

点这个,不用复制粘贴 Anti-Thor 后台 API 密钥列表,红色标注指出两处:分组列的 claude max 号池标签标着「claude兼容的分组」,以及最右侧操作列的「导入到 CCS」按钮
API 密钥列表 · 红框标注了两处重点:分组要选 Claude 兼容的,然后点右侧「导入到 CCS」
  1. 「导入到 CCS」,浏览器会唤起本机的 CC-Switch
  2. CC-Switch 弹确认窗,点 确认 / 导入
  3. 回到 CC-Switch 主界面,切到 「Claude」 页签,列表里就有 Anti-Thor 了。
Key 要建在 Claude 兼容的分组里看上图那个 Key 的分组列——写着 claude max 号池 这类带 Claude 的分组才行。分组选错了,导入是能导入,但 Claude Code 用起来会找不到模型。分组不对就点那一列的「选择分组」改掉,改完再导入。

3.2 办法二:手动新建配置

一键导入没唤起,或者你想自己填,就手动来。打开 CC-Switch,点顶部 「Claude」 页签,右上角橙色 「+」 新建,选 「自定义配置」

新建配置 CC-Switch 添加新配置的界面,上方是 Claude 供应商与统一供应商两个选项卡,下方自定义配置区域被红框标出
新建配置 · 走「自定义配置」这一栏,别选预设供应商

照着下面这张填,其余留空:

对照着填 CC-Switch 编辑供应商表单,红框标出两处必填项:API Key 输入框(旁注「填写Api key」)与请求地址 https://api.antithor.asia/;下方高级选项中 API 格式为 Anthropic Messages 原生、认证字段为 ANTHROPIC_AUTH_TOKEN 默认
配置表单 · 重点是红框那两项:API Key 和请求地址
供应商名称随便起,方便你自己认,比如 Anti-Thor
API Key你在 Anti-Thor 后台创建的 sk- 开头那串
请求地址
API 格式Anthropic Messages(原生)
认证字段ANTHROPIC_AUTH_TOKEN(默认)

「API 格式」和「认证字段」在高级选项里,默认值就是对的,一般不用动。官网链接、备注这些随便填或者留空都行。

请求地址结尾别带斜杠表单下面那条黄色提示写得很清楚:不要以斜杠结尾。所以是 https://api.antithor.asia不是 https://api.antithor.asia/。多一个斜杠就可能连不上。

填完点保存,回到列表里找到这条配置,点它右侧的 「当前使用」——变成绿色标签就说明生效了。

切完配置要重启 Claude CodeCC-Switch 改的是 ~/.claude/settings.json 这个文件,已经开着的 Claude Code 不会自动感知。切换配置之后,把它整个退出再重开一次。另外多说一句:系统托盘图标右键就能快速切配置,配了多个站点来回换的时候很方便,不用每次都打开主界面。
04

手动配置环境变量

不想装 CC-Switch 的走这条

第 3 步已经配好的,这一步跳过。两条路配的是同一件事,别两边都配,容易搞不清到底哪个在生效。

要设的就两个变量:一个是你的 Key,一个是请求地址。下面把 sk-xxx 换成你自己那串。

PowerShell 里跑这两条:

PowerShell
>[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxx", "User")
PowerShell
>[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.antithor.asia", "User")

CMD 的话,等价写法是这两条:

命令提示符 CMD
>setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
>setx ANTHROPIC_BASE_URL "https://api.antithor.asia"

macOS 默认用 zsh,写进 ~/.zshrc

终端 · zsh
$echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.zshrc
终端 · zsh
$echo 'export ANTHROPIC_BASE_URL="https://api.antithor.asia"' >> ~/.zshrc

写完让它立刻生效:

终端 · zsh
$source ~/.zshrc

Ubuntu / Debian 默认 bash,写进 ~/.bashrc

终端 · bash
$echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxx"' >> ~/.bashrc
终端 · bash
$echo 'export ANTHROPIC_BASE_URL="https://api.antithor.asia"' >> ~/.bashrc
终端 · bash
$source ~/.bashrc

你的机器要是用 zsh(比如某些 CentOS / Fedora 配置),把上面三条里的 ~/.bashrc 换成 ~/.zshrc 即可,其余一模一样。

两个提醒sk-xxx 是占位符,换成你自己的 Key,别原样跑;② 设完之后把终端整个关掉重开,环境变量才会在新窗口里生效——这是最常见的「我明明配了却没用」的原因。
05

启动,发第一条任务

能正常回话就是通了

cd 到你的项目目录(随便哪个目录也行,只是它读不到你的代码),敲一个 claude 回车:

终端
$cd ~/my-project
$claude

没有红色报错、直接进到对话界面,就说明前面几步都对了。这时候写第一条任务试试:

  1. 把要干的事说清楚——改哪个文件、想要什么结果。说得越具体,返工越少。
  2. 第一次用先别急着放开权限,它要改文件、跑命令时会问你,一条条看过去,摸清脾气再说。
  3. 回车发出去,看它怎么读代码、怎么动手。

能正常一来一回地对话,接入就成功了——你的请求现在走的是 Anti-Thor,不是官方。

想确认额度有没有在扣,去 Anti-Thor 后台看用量记录,跑几轮之后应该能看到对应的消耗。另外,你能用哪些模型取决于 Key 所在的分组,买了 A 套餐却把 Key 建在 B 分组,付费模型是不会出现的。

常见问题

遇到问题先来这里对号入座

1提示 claude 不是内部或外部命令 / command not found
两种可能:装的时候就没成功,或者 PATH 还没刷新。先做最简单的:把终端整个关掉重开,八成就好了——安装器写进 PATH 的改动,对已经开着的窗口不生效。重开还是不行,说明第 1 步的安装命令其实失败了(往上翻翻当时有没有报错),按第 1 步重装一遍。
2能启动,但一发消息就连接失败 / 401
按顺序查四样:① Key 有没有复制完整——前后多个空格、少了几位都会 401;② 地址对不对,必须是 https://api.antithor.asiahttpss 别漏结尾别多打斜杠;③ 余额还有没有,去后台看一眼;④ 挂了代理工具的,试试对这个地址走直连或者换个节点。
3配置改了,但完全没生效
分两种情况。用 CC-Switch 的:改完配置要把 Claude Code 整个退出再重开,它不会热更新;顺便确认那条配置真的是绿色的「当前使用」状态。用环境变量的:要关掉终端重新开一个窗口,老窗口里的环境变量是进程启动时就固定了的,改了也不会变。
4CC-Switch 和环境变量都配了,到底听谁的
CC-Switch 写的是 ~/.claude/settings.json 这个配置文件,优先级高于环境变量。所以两边都配了的话,一般是 CC-Switch 那份在起作用——这也是为什么建议二选一:混着用会出现「我改了环境变量怎么没反应」的怪事,排查起来特别费劲。选定一种,把另一种清掉。
5手滑把 .claude.json 改坏了,现在启动不了
典型的 JSON 语法错误,九成是逗号问题:要么该加的没加,要么最后一个字段后面多了一个。打开文件检查三件事:逗号和引号都是英文的最后一个字段后面没有逗号大括号成对。实在看不出来,就把你刚加的那一行整个删掉,先恢复到能启动的状态,再改用第 2 步的方法一(CC-Switch 开关)来跳过。
6为什么不推荐 npm 安装
两个原因:版本滞后,npm 渠道更新慢,装出来常常是旧版,一些新功能和修复都没有;还得先装 Node,凭空多一层依赖。原生安装器装完自带更新机制,省心得多。已经用 npm 装了的,卸掉重装一次就行,配置不会丢。

装好了,去终端里发第一条任务吧

还有问题解决不了?带上报错截图到 QQ 群里问,或者直接找站长。

打开