Codex CLI · MacOS / Linux

MacOS/Linux Codex 安装指南

此流程 100% 使用官方原版安装包，确保服务体验与官方完全一致。系统要求：macOS 10.15+ 或 Linux 系统。

安装前环境准备

1

【此步骤在桌面】 下载 Git

访问 https://git-scm.com/downloads/win， 安装时全都下一步，不要修改路径。

2

【此步骤在桌面】 下载 Node.js

访问 https://nodejs.org/zh-cn/download， 安装时全都下一步，不要修改路径。

安装步骤

1

安装 Codex 官方原版包

$ npm install -g @openai/codex
# 或者
$ brew install codex
2

创建目录

$ rm -rf ~/.codex
$ mkdir ~/.codex
3

登录网站

访问 https://api.flameapi.cn，在令牌管理处，添加令牌并复制密钥出来。

4

创建 auth.json 文件

删除 ~/.codex 路径下已存在的 auth.json 文件（若有），然后新建一个 auth.json，内容为：

{
  "OPENAI_API_KEY": "你的 API_KEY"
}
5

创建 config.toml 文件

删除 ~/.codex 路径下已存在的 config.toml 文件（若有），然后新建一个 config.toml，内容直接复制下方配置：

model_provider = "flame"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.flame]
name = "flame"
base_url = "https://api.flameapi.cn/v1"
wire_api = "responses"

重启终端，验证安装结果

重启终端后运行以下命令，确认安装成功：

$ codex -V

开始使用

安装完成后，您可以在任何项目目录中开始使用 Codex。

# 进入你的项目目录
$ cd your-project-folder

# 启动 Codex
$ codex

支持 VSCode 官方插件

完全支持 VSCode 官方插件。