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

在命令行里使用 Codex

在电脑自带的黑窗口里跟 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

安装 Codex1～3 分钟

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

整段一起复制，粘到命令行，按回车（是三行，一次性粘完就行）
npm install -g @openai/codex --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 @openai/codex …正在从镜像下载…（这里会停十几秒到一两分钟）added 3 packages in 47s你的电脑 ~ %
装的过程大概是这样：先安静，再滚几行，最后回到光标

装完确认一下

粘到命令行，按回车
codex --version
终端 — zsh
你的电脑 ~ %codex --versioncodex-cli 0.145.0

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

✓ 看到这个就说明这一步成了
敲 codex --version 回一行 codex-cli 0.x.x。
× 没成的话，对照这里
command not found: codex装是装上了，但窗口还没认出来
把命令行窗口整个关掉重开一次，再敲一遍。还不行的话，把上面那三行重新粘一次——第三行没跑到的话就会这样。
EACCES / permission denied装到系统目录去了
说明命令没粘全。不要加 sudo，加了会留下更麻烦的问题。回去把整段三行重新复制一次，注意第一行末尾的 --prefix 那部分不能少。
ETIMEDOUT / network下载被网络卡住
直接把整段再粘一次重试，npm 会接着上次继续。若仍失败，先核对 npm 错误码和当前镜像配置。
5

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

这条命令要从密钥弹窗进来才会自动填好
回控制台点那把密钥的 使用密钥，从弹窗进来即可。
没有任何输出才是对的
旧配置会先备份成 config.toml.bak。
终端 — zsh
你的电脑 ~ %mkdir -p …你的电脑 ~ %cat > … <<'BIGAO_EOF'你的电脑 ~ %
正常的样子：粘完回车，安静地回到光标
✓ 看到这个就说明这一步成了
没有红字，光标回到了新的一行，可以继续。
× 没成的话，对照这里
屏幕上出现一个 > 符号，怎么打字都出不去命令粘贴不完整
按 Ctrl + C 退出来，然后重新完整复制一次再粘。多半是最后那行 BIGAO_EOF 没粘进去。
'echo' 不是内部或外部命令粘到 PowerShell 里了
关掉这个窗口，按第 2 步重新打开命令提示符（搜 cmd 的那个），再粘一次。
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、企业防火墙和系统时间。仍然超时时，记下检测时间和错误信息后联系支持。
会话跑着跑着就说「已超出上下文上限」，新开一轮没多久又撞配置是早先生成的，里面没有告诉 Codex 上下文上限的那两行
回到第 5 步，把那条配置命令重新跑一遍——它会整份覆盖旧配置。新版本里写了 model_context_window，Codex 知道上限之后会自己提前压缩，不会再撞。
跑起来像正常，但什么都没输出CLI 可能吞掉了服务端返回的错误
回到第 6 步那条 curl 命令再跑一次，它会把 HTTP 状态码和错误正文显示出来。根据实际状态码处理，不要凭“没有输出”猜成模型问题。
7

启动 Codex，开始干活约 1 分钟

粘到命令行，按回车
codex

首次启动会问你两件事

  1. 信任这个文件夹吗？——选 Yes 回车，它在确认你允许它读写这里的文件。
  2. 闪过一行黄色的 Model metadata not found 是正常的， 只是说这个模型名不在它内置清单里，不影响使用。
终端 — zsh
你的电脑 ~ %codex⚠ Model metadata not found — 正常，忽略即可  ╭──────────────────────────────────────────╮  │  Codex  ·  比高AI                         │  │  输入你想让它做的事，回车发送             │  ╰──────────────────────────────────────────╯  >
启动后大致的样子（版本不同界面会有出入）

试着让它干件小事

直接用中文打字，比如「帮我在当前目录新建一个 test.txt，里面写一句话」， 回车。它会先说打算怎么做，你同意后才动手。退出输入 /quit。

✓ 看到这个就说明这一步成了
能看到一个带边框的输入区，打中文进去它有反应、会回话。
× 没成的话，对照这里
提示要登录 / 要 OpenAI 账号配置没生效
说明第 5 步没成。退出后从控制台重新生成密钥，再运行自动生成的第 5 步命令，不要手工修改。
报 401 或 invalid api key密钥不对
回第 6 步用 curl 验一下。多半是密钥复制少了一截。
实际运行型号和输入的 model 不一致输入的型号不属于这把密钥的厂商，或暂未收录
平台会回落到这把密钥的默认型号，并按实际运行型号计费。查看响应头 X-Bigao-Effective-Model；如需避免回落，请从 支持模型 页面复制同厂商型号。
报 402 或说余额不足账户没钱了
去 控制台 → 账单 充值后再试。
8

配好了。以后就这么用

下次想用的时候

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

确认钱真的走的是比高

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

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

还是卡住了？

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

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