Codex 接入教程

先理解两种 Codex

Codex 可以按使用方式分成两类：一种是有图形界面的 UI 客户端，适合 Windows 和 macOS 桌面用户；另一种是命令行 CLI，通常依赖 Node.js/npm，适合终端、WSL、Linux、服务器和自动化场景。

一、准备 服务平台 参数

UI 客户端和 CLI 都需要同一组 服务平台 参数。

二、Codex UI 客户端

UI 客户端适合第一次使用 Codex 的新手。它有图形界面，支持 Windows 和 macOS，配置时也更容易观察是否已经登录、是否启动成功、是否需要完全退出重启。

三、Codex CLI

CLI 适合终端用户、远程开发、WSL、Linux 服务器和自动化场景。CLI 的重点不是图形界面，而是能在项目目录中运行 codex 命令。

CLI 安装前先检查 Node.js

很多 CLI 安装方式依赖 Node.js/npm。新手先确认 Node.js 和 npm 可用：

node -v
npm -v

node -v
npm -v

安装 Codex CLI

不同版本的 CLI 安装命令可能变化。核心目标只有一个：安装后执行 codex --version 能看到版本号。

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

irm https://chatgpt.com/codex/install.ps1 | iex
codex --version

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

四、自动配置

如果你只是想尽快用起来，推荐先使用自动配置工具。

图片加载中...查看原图

图片加载中...查看原图

五、手动配置

如果你不使用自动配置工具，或者想自己检查配置细节，可以按下面步骤手动完成。

配置目录和文件

UI 客户端和 CLI 都会读取用户级 Codex 配置。除非你主动设置 CODEX_HOME，默认目录通常如下：

C:\Users\你的用户名\.codex

/Users/你的用户名/.codex

/home/你的用户名/.codex

图片加载中...查看原图

图片加载中...查看原图

auth.json 配置

在 .codex 目录中创建或打开 auth.json，放入如下内容：

{"OPENAI_API_KEY": "your_api_key_here"}

图片加载中...查看原图

config.toml 配置

在 .codex 目录中创建或打开 config.toml，把下面内容放到文件前面：

model_provider = "JiaPi"
model = "gpt-5.5"
model_reasoning_effort = "medium"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.JiaPi]
name = "JiaPi"
base_url = "https://your-api-host.example"
wire_api = "responses"
requires_openai_auth = true

图片加载中...查看原图

六、重启并验证

cd C:\path\to\your-project
codex

cd ~/code/your-project
codex

请只阅读当前项目，不要修改任何文件。先说明这个项目的目录结构和技术栈。

图片加载中...查看原图

七、常见问题

八、安全提醒

参考入口

• Codex 产品页
• Codex 配置参考