这篇文档只讲一件事：如何安装 Codex CLI，并通过你的 MYYAPI 站点接入使用。

如果你只是想尽快跑起来，可以直接看文末的“最小可用示例”。

1. 准备信息

开始前先准备好下面两项：

1. 你的 MYYAPI 站点地址：
2. 你的 API Key：sk-xxxx

说明：

• Codex 最终连接时使用的是 {{BASE_URL}}/v1
• API Key 一般在 MYYAPI 后台的令牌管理里创建

2. 安装 Node.js

Codex CLI 依赖 Node.js，建议使用 18 及以上版本。

先检查本机是否已经安装：

node --version
npm --version

如果没有安装，可以直接去 Node.js 官网下载 LTS 版本：

• https://nodejs.org/

3. 安装 Codex CLI

3.1 Windows

npm i -g @openai/codex --registry=https://registry.npmmirror.com
codex --version

3.2 Linux / macOS

npm install -g @openai/codex
codex --version

如果 Linux 或 macOS 提示权限不足，可以尝试：

sudo npm install -g @openai/codex

4. 配置 Codex 连接 FFAPI

推荐使用配置文件方式，稳定、清晰，也方便后续维护。

4.1 配置目录

先确认 Codex 的配置目录：

• Windows：C:\Users\你的用户名\.codex
• Linux / macOS：~/.codex

4.2 创建 config.toml

在 .codex 目录下创建 config.toml：

disable_response_storage = true
model = "gpt-5-codex"
model_reasoning_effort = "high"
model_provider = "myy"

[model_providers.myy]
name = "myy"
base_url = "https://api.myy9.com/v1"
wire_api = "responses"
requires_openai_auth = true

说明：

• model 可以按你站点实际支持的模型填写
• base_url 必须写成你的站点 /v1 接口地址
• wire_api = "responses" 表示走 Responses 协议

4.3 创建 auth.json

在同一个目录下再创建 auth.json：

{
  "OPENAI_API_KEY": "你的API密钥"
}

5. 环境变量方式

如果你不想写配置文件，也可以直接通过环境变量连接。

5.1 Windows PowerShell

临时生效：

$env:OPENAI_BASE_URL = "https://api.myy9.com/v1"
$env:OPENAI_API_KEY = "你的API密钥"

永久写入当前用户环境变量：

[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.myy9.com/v1", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)

5.2 Linux / macOS

export OPENAI_BASE_URL="https://api.myy9.com/v1"
export OPENAI_API_KEY="你的API密钥"

如果希望长期生效，可以把它写到：

• ~/.bashrc
• ~/.zshrc

6. 启动与基本使用

进入你的项目目录后，直接运行：

codex

常见用法：

1. 在项目目录中启动，Codex 会自动读取当前代码上下文。
2. 直接输入需求，例如让它改代码、补接口、修 bug、补测试。
3. 退出时输入 exit，或者按 Ctrl+C。

7. 常见问题

7.1 提示 codex: command not found

先查看 npm 全局安装目录：

npm config get prefix

然后把对应的全局 bin 目录加入系统 PATH，重启终端后再试。

7.2 安装时报权限错误

• Windows：尽量用管理员权限打开 PowerShell
• Linux / macOS：可以临时使用 sudo，或者改为用户目录安装全局 npm 包

7.3 连接模型失败

重点检查这几个地方：

1. OPENAI_BASE_URL 是否写成了 {{BASE_URL}}/v1
2. OPENAI_API_KEY 是否正确
3. 你的 FFAPI 站点是否可以正常访问
4. 配置文件里的模型名称是否和站点实际支持的一致

8. 最小可用示例

如果你想最快验证是否可用，直接照着下面执行即可。

8.1 Windows

npm i -g @openai/codex --registry=https://registry.npmmirror.com
$env:OPENAI_BASE_URL = "https://api.myy9.com/v1"
$env:OPENAI_API_KEY = "sk-你的真实密钥"
codex

8.2 Linux / macOS

npm install -g @openai/codex
export OPENAI_BASE_URL="https://api.myy9.com/v1"
export OPENAI_API_KEY="sk-你的真实密钥"
codex

9. 使用建议

如果你是第一次使用，建议按下面顺序来：

1. 先确认 MYYAPI 站点和令牌可用
2. 再安装 Codex CLI
3. 优先使用配置文件方式接入
4. 最后进入实际项目目录中运行 codex

这样排查问题会更简单，也不容易把环境变量和配置文件混在一起。