Model Nexus Docs

Codex 教程

Codex 是 AI 编程工具，能阅读项目、修改代码、运行命令和协助排错。新手建议先用 Codex++，它更适合通过本站 API Key 接入。

先选使用方式

推荐：Codex++

Codex++ 是开源项目 BigPizzaV3/CodexPlusPlus，用于增强 Codex App 的配置和接入体验。优点是配置本站 API 更简便，适合不想手动折腾配置文件的用户。

GitHub 项目下载 Releases

官方 Codex

OpenAI 官方 Codex CLI / App 适合熟悉终端的人。项目地址：openai/codex。

Codex++ 安装

打开 Codex++ Releases。
下载 Windows 安装包或压缩包。
安装或解压后启动 Codex++。
如果系统拦截未知应用，确认来源是 GitHub 项目页面后再继续。

打开 Codex++ Releases。
按芯片选择 Apple Silicon 或 Intel 版本。
下载后拖入 Applications 或按项目说明启动。
首次打开被拦截时，到系统设置的安全性里允许打开。

打开 Codex++ Releases。
下载 Linux 包，按项目说明解压或安装。
启动后进入配置页面。

Codex++ 配置

在左侧“复制配置助手”里填入你的 API Key 和模型名。
如果 Codex++ 有图形设置页：Base URL 填 https://api.modelnexus.net，API Key 填你的 key，协议选择 Responses。
如果需要手动文件配置，复制下面两个文件。
重启 Codex++，先问一句简单问题测试。

~/.codex/config.toml

model = "{{MODEL}}"
review_model = "{{MODEL}}"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.modelnexus.net"
wire_api = "responses"
supports_websockets = true
requires_openai_auth = true

[features]
responses_websockets_v2 = true
goals = true

~/.codex/auth.json

{
  "OPENAI_API_KEY": "{{MODELNEXUS_API_KEY}}"
}

注意：Codex++ 这里填 https://api.modelnexus.net，不要加 /v1。

官方 Codex CLI

官方 Codex CLI 适合会用终端的人。官网项目：https://github.com/openai/codex。官方 App 页面：Codex App。

先安装 Node.js LTS。
打开 PowerShell。
运行 npm install -g @openai/codex。
按上面的 config.toml 和 auth.json 配置。
在项目目录运行 codex。

安装 Node.js LTS。
打开 Terminal。
运行 npm install -g @openai/codex。
保存 config.toml 和 auth.json 后运行 codex。

安装 Node.js LTS。
运行 npm install -g @openai/codex。
保存 config.toml 和 auth.json 后运行 codex。

常见问题

问题	处理
401 / key 无效	重新复制 key，确认没有多空格，确认 key 没被禁用。
404	Codex++ Base URL 改为 `https://api.modelnexus.net`，不要加 `/v1`。
模型不存在	回控制台看这个 key 开通了哪些模型。