macOS/Linux Codex 安装指南

在 macOS 或 Linux 系统上安装官方 Codex CLI，并配置为使用积木AI代码助手。

返回 登录后创建 Codex API Key

系统要求

系统
macOS 10.15+ 或 Linux
依赖
Node.js 20+ + npm
Node.js 安装（如果没有安装）
macOS：前往 nodejs.org/zh-cn/download 下载
Linux（Debian/Ubuntu）：curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -，然后 sudo apt-get install -y nodejs

安装步骤

1

打开终端

macOS 可用 Cmd+Space 搜索 Terminal，或使用 VS Code / JetBrains 的内置终端打开；Linux 打开你常用的终端即可。

2

复制并执行环境检查脚本

curl -fsSL https://code.jimuxyz.com/env_deploy/codex-install.sh | bash

脚本会检查 Node.js / npm 版本，并提示修复方式。

3

卸载已安装的 Codex（可选，未安装请跳过）

# 下面是通用操作
npm uninstall -g @openai/codex

# 下面是macOS专属（Linux忽略），通用操作在macOS执行成功，以下步骤macOS也可忽略
brew uninstall codex
4

安装 Codex 官方原版包

npm install -g @openai/codex@latest
5

验证安装

codex -V
6

可选：重建 ~/.codex 配置目录（旧配置异常时再执行）

rm -rf ~/.codex
mkdir -p ~/.codex

首次安装通常不必先删目录；只有之前装过 Codex、怀疑旧配置冲突时再执行这一条。

7

登录后创建并复制 Codex API Key

登录后到「API Key」页面创建一个新的 Codex Key（复制你的Codex_API_KEY）。

8

脚本快速配置（推荐）

直接复制粘贴到终端（记得替换 你的Codex_API_KEY）：

curl -fsSL https://code.jimuxyz.com/env_deploy/codex-deploy.sh | bash -s -- "你的Codex_API_KEY"

脚本会自动写入 ~/.codex/auth.json 与 ~/.codex/config.toml，并备份旧文件。

重要：如果你之前在本机用过其他 Key / 其他服务商，改完配置后请按场景选择命令。codex = 按当前新配置新建会话；codex resume = 继续旧会话；codex fork --last = 继承最近一次会话内容，但按当前新配置开一个新会话。若你想把旧历史接到新的积木AI配置继续使用，优先用 codex fork --last，不要直接用 codex resume。

或者

如果你不想用脚本，也可以直接按下方内容手动写入 ~/.codex/auth.json（记得替换 你的Codex_API_KEY）：

{
  "OPENAI_API_KEY": "你的Codex_API_KEY"
}
9

创建 config.toml

接着写入 ~/.codex/config.toml；你可以直接复制下面命令：

cat << 'EOF' > ~/.codex/config.toml
model_provider = "jimuxyz"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.jimuxyz]
name = "jimuxyz"
base_url = "https://code.jimuxyz.com/p/v1"
wire_api = "responses"
requires_openai_auth = true
EOF
或者

如果你不想执行写入命令，也可以手动新建 ~/.codex/config.toml，内容如下：

model_provider = "jimuxyz"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.jimuxyz]
name = "jimuxyz"
base_url = "https://code.jimuxyz.com/p/v1"
wire_api = "responses"
requires_openai_auth = true

说明：以上配置将 Codex 的 base_url 指向同源代理 /p/v1（OpenAI v1 兼容入口）。

10

启动 Codex / 续接历史

# 导航到你的项目（可选）
cd your-project

# 1) 全新按当前配置启动
codex

# 2) 只恢复旧会话
codex resume --last

# 3) 继承旧历史，但按当前新配置继续
codex fork --last

推荐口径：首次切到积木AI后，先用 codex 验证新配置；如果你想把旧历史一起带过来继续用，优先执行 codex fork --last；只有明确要原样恢复旧线程时，再用 codex resume。