Codex 接入教程（独立客户端）

Codex 是 OpenAI 推出的 AI 编程助手，提供桌面端独立客户端形态，基于 GPT 模型，内置安全沙箱，支持多种编程语言。

前置条件

1. 前往 PigCloud 控制台 注册账号并获取 API Key（令牌分组选 codex）
2. Windows / macOS / Linux 桌面系统

1. 下载安装

前往官方下载页下载对应平台安装包：👉 https://chatgpt.com/zh-Hans-CN/codex/get-started/

2. API 配置

方式一：一键配置（推荐）

npx pigcloud-api

按提示输入 API Key 即可自动完成配置。

方式二：手动配置文件

编辑 ~/.codex/config.toml（Windows：C:\Users\你的用户名\.codex\config.toml）：

model_provider = "openai-pigcloud"
model = "gpt-5.5"
disable_response_storage = true
model_reasoning_effort = "medium"

[model_providers.openai-pigcloud]
name = "openai-pigcloud"
wire_api = "responses"
requires_openai_auth = true
base_url = "https://pigcloud.xyz/v1"

[windows]
sandbox = "elevated"

同时编辑 ~/.codex/auth.json（Windows：C:\Users\你的用户名\.codex\auth.json）：

{
  "OPENAI_API_KEY": "sk-你的Key"
}

3. 启动使用

桌面客户端直接打开，导入项目即可开始对话。

> 帮我写一个用户注册的 API 接口
> 优化这个数据库查询的性能

常见问题

1. 401 Unauthorized： 检查 API Key 是否完整，以及令牌分组是否为 codex
2. 404 Not Found： Base URL 必须以 /v1 结尾
3. 模型不可用： 在 令牌页面 确认令牌分组为 codex

---

💡 提示： 如果遇到问题，请先查看 常见问题 文档。如果依然无法解决，请携带完整报错截图前往首页，公告内添加客服联系方式，添加客服询问解决。