OpenNave 文档中心

外观

macOS 和 Linux 安装 Codex ​

本文通过官方包在 macOS 或 Linux 上安装 Codex CLI，并配置 OPENNAVE API。需要准备 Node.js、Git 和控制台创建的 API Key。

前置条件 ​

  1. 安装 Git。
  2. 安装 Node.js。
  3. 在控制台的令牌管理中创建并复制 API Key。

安装 Codex ​

在终端执行以下任一命令：

sh
npm install -g @openai/codex

在已安装 Homebrew 的 macOS 上，也可以执行：

sh
brew install codex

创建配置文件 ​

以下命令会清空已有的 Codex 本地配置。已有自定义配置时，请先备份需要保留的内容。

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

新建 ~/.codex/auth.json：

json
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

新建 ~/.codex/config.toml：

toml
model_provider = "OPENNAVE"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.OPENNAVE]
name = "OPENNAVE"
base_url = "https://api.opennave.top/v1"
wire_api = "responses"

验证并使用 ​

重启终端后验证版本，并在任意项目目录启动 Codex：

sh
codex -V
cd your-project-folder
codex

Codex 同时支持 VS Code 官方插件；插件配置请参阅主流 IDE 配置 Codex。

查看 Windows 安装