OpenAI Codex 使用指南

什么是 Codex

Codex 是 OpenAI 开发的一款 AI 编程助手，你可以用简单的英语（以及其他自然语言）与它对话。它可以读取文件、修改文件、运行代码，还能通过运行在本地机器上的 Model Context Protocol (MCP) 服务器集成各种工具。

主要特性

  • GPT-5 模型集成：目前已接入最新的 GPT-5 模型
  • 云端沙盒环境：让整个互动过程像在和一位资深工程师聊天一样流畅
  • 开源 CLI 工具：Codex CLI 命令行界面，将最新推理模型的能力直接带到终端

Codex CLI 功能

  • 读取、修改和执行本地机器上的代码
  • 处理文本、截图或图表作为输入
  • 提供三种不同的审批模式
  • 完全在终端中运行

一、安装 Codex CLI

1. 安装 Node.js

访问 Node.js 官网 下载对应系统版本安装。

验证安装：

node -v
npm -v

2. 安装 Git（Windows 系统必选）

从 git-scm.com 下载对应系统版本安装。

验证安装：

git --version

3. 安装 OpenAI Codex CLI

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

二、配置 API 密钥

1. 获取Sophnet API 密钥

  1. 注册并登录Sophnet 平台：https://www.sophnet.com/

  2. 登录用户中心，进入个人用户空间或者团队空间

    • 在个人用户空间，添加新的API Key或复制已有API Key

    • 在团队空间，需要进入项目详情页，左侧点击API key, 复制即可

2. 配置中转 API 接入 Codex CLI

方法一：配置环境变量

macOS/Linux 系统：

export OPENAI_API_KEY="你的API密钥"
export OPENAI_API_BASE="https://www.sophnet.com/api/open-apis/v1/"

Windows CMD 命令：

setx OPENAI_API_KEY=你的API密钥
setx OPENAI_API_BASE=https://www.sophnet.com/api/open-apis/v1/

方法二：修改配置文件

  1. 在 Codex CLI 的配置文件夹下创建或编辑 config.toml 文件

Windows:

C:\Users\当前用户\.codex\config.toml

macOS/Linux:

~/.codex/config.toml
  1. 编辑 config.toml：
model_provider = "sophnet"
model = "gpt-5-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true

[model_providers.sophnet]
name = "sophnet"
base_url = "https://www.sophnet.com/api/open-apis/v1/"
wire_api = "responses"
  1. 在同一目录下创建 auth.json 文件，填入 API 令牌：
{
  "OPENAI_API_KEY": "替换为自己的API key"
}

三、Codex CLI 使用指南

启动命令

Codex CLI 默认启动命令（目前默认使用模型为 GPT-5）：

codex

指定其他模型启动

codex --model "gpt-5.3-codex"

常用指令

指令功能描述
/init创建一个包含 Codex 指令的 AGENTS.md 文件，方便以后复用
/status查看当前会话配置，如使用的模型、API Token 消耗情况等
/approvals选择 Codex 无需批准即可执行的操作模式
/model选择要用的模型和推理强度，如快速模式或深度模式