Codex 安装与使用教程

本文档只讲一件事：如何安装 Codex。

1. 安装 Node.js（必须）

Codex 依赖 Node.js，要求版本 >= 18。

检查是否已安装：

node --version
npm --version

如果未安装，请先去官网下载 LTS 版：

• https://nodejs.org/

2. 安装 Codex CLI

2.1 Windows

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

2.2 Linux / macOS

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

如果报权限错误，可加 sudo：

sudo npm install -g @openai/codex

3. 配置 Codex 连接 FFAPI

有两种方式，推荐方式 A（配置文件）。

3.1 方式 A：配置文件（推荐）

创建目录：

• Windows：C:\Users\你的用户名\.codex
• Linux/macOS：~/.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 = "api.myy9.com/v1"
wire_api = "responses"
requires_openai_auth = true

没有codex额度的
q：1081770594每天提供免费额度
再创建 auth.json：

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

3.2 方式 B：环境变量

Windows PowerShell

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

永久设置（用户级）：

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

Linux / macOS

export OPENAI_BASE_URL="{{BASE_URL}}/v1"
export OPENAI_API_KEY="你的API密钥"

可写入 shell 配置文件（~/.bashrc 或 ~/.zshrc）做永久生效。

4. 启动与基本使用

进入你的项目目录后运行：

codex

常见用法：

1. 直接提需求：让 Codex 修改代码、写接口、补测试。
2. 在项目目录运行：Codex 会读取当前项目上下文。
3. 退出：输入 exit 或按 Ctrl+C。

5. 常见问题

5.1 提示 codex: command not found

先查看 npm 全局目录：

npm config get prefix

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

5.2 权限不足（EACCES）

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

5.3 连接模型失败

重点检查：

1. OPENAI_BASE_URL 是否为 {{BASE_URL}}/v1
2. OPENAI_API_KEY 是否正确
3. 你的站点是否可从当前网络访问

6. 最小可用示例（建议直接照抄）

Windows（PowerShell）

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

Linux / macOS

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