比高AI上手教程
返回主页控制台
所有教程客户端 · Codex

在官方客户端里使用 Codex

在 ChatGPT 官方客户端里打开 Codex，也可以装进 VS Code 当侧边栏用。

约 12 分钟要先装命令行本体每一步都可验证
先检查官方扩展的资源连接
看到 Codex could not start 通常表示官方扩展没有完成初始化。 请先按下文检测；当前网络策略无法访问该资源时，改用命令行教程或联系网络管理员。
先选你用的是哪种电脑
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

先装命令行本体1～3 分钟

整段一起复制，粘到命令行，按回车
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 分钟，中间像卡住是正常的，不要关窗口。

看到 EPERM 或 operation not permitted
说明打开着的 VS Code / Codex 正占用旧程序。全部退出后重跑；Windows 上仍提示占用时， 先运行 taskkill /F /IM codex.exe。

装完确认一下

粘到命令行，按回车
codex --version
终端 — zsh
你的电脑 ~ %codex --versioncodex-cli 0.145.0
✓ 看到这个就说明这一步成了
能回出一行版本号。
5

把密钥配进去约 30 秒

这条命令要从密钥弹窗进来才会自动填好
你是直接打开本页的，所以没带上密钥。回控制台点那把密钥的使用密钥，从弹窗进来即可。
没有输出是正常的
粘完回车屏幕上什么都不会出现就是成功了。旧配置会备份成 config.toml.bak。
别把整张命令行截图发人
这条命令会短暂显示完整密钥。

再确认配置能被 Codex 读到

复制到命令行，按回车
codex features list | grep '^apps '

出现 invalid utf-8 或 failed to read config 就别继续， 回上面重新复制粘贴一次。

✓ 看到这个就说明这一步成了
没有配置错误，并看到 apps ... false。
6

装官方客户端并打开 Codex约 2 分钟

Codex 并在 ChatGPT 官方客户端里。到 chatgpt.com/download 下载安装；已经装过的话，敲下面这条直接打开。

粘到命令行，按回车
codex app

装完必须把客户端完全退出再打开（左上角菜单 → 退出，不是点红叉）， 不然它读的还是旧配置。然后随便发一句话试试。

✓ 看到这个就说明这一步成了
客户端里进入 Codex，发消息有回复，控制台“使用记录”出现一次新调用。
✓

配好之后

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

配置只做一次，换电脑或重新生成密钥才需要再配。

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

还是卡住了？

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

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