比高AI上手教程
返回主页控制台
所有教程命令行 · Claude Code

在命令行里使用 Claude Code

同样在黑窗口里，换成 Anthropic 的 Claude Code。配置方式和 Codex 略有不同。

约 10 分钟零基础可完成每一步都可验证
先选你用的是哪种电脑
1

创建一把 API 密钥约 1 分钟

  1. 打开 控制台 → API 密钥，点创建新密钥。
  2. 起个名字，选择要使用的厂商，点确定。
  3. 弹窗里会出现完整密钥，先别关，按弹窗里的步骤往下做即可。
完整密钥默认隐藏
关掉弹窗后会显示 bgai_••••••1a2b 这样的打码样子，需要时可在控制台点查看或复制。 密钥等于密码，不要把完整密钥截图发给任何人；怀疑泄露时立即重新生成，旧密钥会立刻作废。
2

打开命令行约 30 秒

Command ⌘+空格同时按下这两个键

输入 terminal（或「终端」），按回车。

terminal
终端Terminal — 应用程序回车
按 Command + 空格，输入 terminal，回车
终端 — zsh
Last login: Mon Aug  4 14:22:05 on ttys001你的电脑 ~ %
打开后大概长这样，末尾那个会闪的方块是光标
✓ 看到这个就说明这一步成了
窗口打开，末尾有个方块在一闪一闪。
3

确认电脑上有没有 Node.js约 2 分钟（已经有的话 10 秒）

粘到命令行里，按回车
node -v
回了一串 v 开头的数字
终端 — zsh
你的电脑 ~ %node -vv22.22.1

装好了，直接跳到下一步。只要 v 后面第一个数 ≥ 20 就够用， 低于 20 按右边那栏重装一次。

回了「找不到命令」
终端 — zsh
你的电脑 ~ %node -vzsh: command not found: node

说明没装。按下面三步装一下，装完这个窗口要重开。

没有的话，这样装

  1. 打开 nodejs.org/zh-cn， 点带 LTS 字样的那个绿色按钮。
  2. 下载完双击打开，一路「下一步」装完，不用改任何选项。
  3. 装完把命令行窗口整个关掉重开，再敲一次 node -v，这次就有数字了。
× 没成的话，对照这里
装完重开还是 command not found多半是没真的重开
把命令行窗口整个关掉（不是新开一个标签页），再从头打开一次。还不行就重启电脑，这个真的有用。
nodejs.org 打不开偶尔会慢
稍后重试或换一个正常可用的网络；如果仍然打不开，请联系网络管理员检查 DNS、防火墙和访问策略。
✓ 看到这个就说明这一步成了
敲 node -v 能回一串 v22.x.x 这样的数字。
4

安装 Claude Code1～3 分钟

装的是 Anthropic 官方的 Claude Code，走国内镜像，不需要管理员密码。

整段一起复制，粘到命令行，按回车（是三行，一次性粘完就行）
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com --prefix "$HOME/.bigao"
export PATH="$HOME/.bigao/bin:$PATH"
grep -qsF 'export PATH="$HOME/.bigao/bin:$PATH"' "$HOME/.zshrc" || echo 'export PATH="$HOME/.bigao/bin:$PATH"' >> "$HOME/.zshrc"

要等 1 到 3 分钟，像卡住是正常的，别按 Ctrl+C，别关窗口。

终端 — zsh
你的电脑 ~ %npm install -g @anthropic-ai/claude-code …正在从镜像下载…（这里会停十几秒到一两分钟）added 3 packages in 47s你的电脑 ~ %
装的过程大概是这样：先安静，再滚几行，最后回到光标

装完确认一下

粘到命令行，按回车
claude --version
终端 — zsh
你的电脑 ~ %claude --version2.1.220 (Claude Code)

版本号不用跟这里一样，能回出个数字就说明装上了。

✓ 看到这个就说明这一步成了
敲 claude --version 回一行版本号。
× 没成的话，对照这里
command not found: claude装是装上了，但窗口还没认出来
把命令行窗口整个关掉重开一次，再敲一遍。还不行的话，把上面那三行重新粘一次。
EACCES / permission denied装到系统目录去了
说明命令没粘全。不要加 sudo。回去把整段三行重新复制一次。
5

一键写入密钥和模型约 30 秒

这条命令要从密钥弹窗进来才会自动填好
回控制台点那把密钥的 使用密钥，从弹窗进来即可。
没有任何输出才是对的
配置已经写进文件，新开窗口也能直接用。
✓ 看到这个就说明这一步成了
没有红字，光标回到了新的一行。
6

先验一下密钥通不通约 20 秒

密钥有问题在这一步就能发现，省得后面对着报错猜。

这条命令要从密钥弹窗进来才会自动填好
回控制台点那把密钥的 使用密钥。
回了一小段响应和 HTTP 200
终端 — zsh
你的电脑 ~ %… | curl -sS -i https://api.bigao.ai/v1/responses …HTTP/2 200content-type: application/json{"id":"resp_…","object":"response","status":"completed","output":[…]}

看不懂没关系，看到 HTTP 200 就说明这把密钥能调用教程要用的模型，继续往下走。

回了 error 和 401
终端 — zsh
你的电脑 ~ %… | curl -sS -i https://api.bigao.ai/v1/responses …HTTP/2 401content-type: application/json{"error":{"message":"invalid api key","code":401}}

密钥不对。回控制台重新生成一把密钥，然后从创建成功弹窗重新进入教程； 不要自己修改生成好的命令。

回了 error 和 403
终端 — zsh
你的电脑 ~ %… | curl -sS -i https://api.bigao.ai/v1/responses …HTTP/2 403content-type: application/json{"error":{"message":"permission denied for this operation","code":"forbidden"}}

403 不是模型不匹配：它表示当前凭据没有执行该操作的权限，或账号状态限制了操作。 记下响应里的 request_id 和检测时间，通过控制台反馈入口提交；不要反复重新生成密钥。

× 没成的话，对照这里
curl: command not found很老的 Windows 才会这样
跳过这一步直接往下走，后面启动的时候一样能发现问题。或者把系统更新到 Windows 10 以上。
半天没反应，最后说 timed out网络不通
换一个合规可用的网络重试，并核对 DNS、企业防火墙和系统时间。仍然超时时，记下检测时间和错误信息后联系支持。
跑起来像正常，但什么都没输出CLI 可能吞掉了服务端返回的错误
回到第 6 步那条 curl 命令再跑一次，它会把 HTTP 状态码和错误正文显示出来。根据实际状态码处理，不要凭“没有输出”猜成模型问题。
7

启动 Claude Code，开始干活约 1 分钟

粘到命令行，按回车
claude

首次启动会问你

信任这个文件夹吗？——按提示确认即可，它是在确认你允许它读写这里的文件。

不会让你登录 claude.ai
配置正确的话，不会出现任何登录界面。看到让你登录 claude.ai 或者提示订阅，说明第 5 步没生效，往下看排查表。
终端 — zsh
你的电脑 ~ %claude  ✻ Welcome to Claude Code    /help 查看命令   ·   /quit 退出  >
启动后大致的样子（版本不同界面会有出入）

直接用中文打字提要求，回车发送。要退出，输入 /quit 回车。

✓ 看到这个就说明这一步成了
能看到欢迎界面和输入提示符，打中文进去它有反应、会回话。
× 没成的话，对照这里
跳出让你登录 claude.ai 的界面配置没读到
第 5 步没生效。先把窗口关掉重开，再敲 claude。还不行就把第 5 步的命令重新完整粘一次。
报 401 或 authentication error密钥不对
回第 6 步用 curl 验一下，多半是密钥复制少了一截。
实际运行型号和输入的 model 不一致输入的型号不属于这把密钥的厂商，或暂未收录
平台会回落到这把密钥的默认型号，并按实际运行型号计费。查看响应头 X-Bigao-Effective-Model；如需避免回落，请从 支持模型 页面复制同厂商型号。
报 402 或说余额不足账户没钱了
去 控制台 → 账单 充值后再试。
8

配好了。以后就这么用

下次想用的时候

  1. 打开命令行。
  2. 用 cd 进到要干活的文件夹（或在访达右键 → 服务 → 新建位于文件夹位置的终端窗口）。
  3. 输入 claude 回车。
配置只做一次
换新电脑、或重新生成了密钥，才需要再配一次——把第 5 步拿新密钥重跑即可。

确认钱真的走的是比高

用几次后打开 控制台 → 使用记录， 能看到扣费就说明通了；一直是空的就回第 5 步重配。

查看使用记录充值与账单常见问题

还是卡住了？

先对照教程逐步检查，再到常见问题里按报错信息找。别发完整密钥，打码留前几位就行。

常见问题给开发者的接入文档