入门指南安装和配置

OpenAI Codex 安装和配置指南

本指南将帮助你配置 OpenAI Codex 以使用 opcx.ai AI API 服务。

1. 安装 Codex CLI

使用以下方式之一全局安装 Codex CLI：

npmHomebrew (macOS)

npm install -g @openai/codex

brew install --cask codex

更多安装选项和详细说明，请参考 OpenAI Codex 官方文档。

2. 配置 Codex

配置 Codex 需要修改两个文件：~/.codex/config.toml 和 ~/.codex/auth.json。

配置文件 config.toml

在 ~/.codex/config.toml 文件开头添加以下配置：

model_provider = "club"
model = "gpt-5.3-codex"
model_reasoning_effort = "medium"
disable_response_storage = true
preferred_auth_method = "apikey"
personality = "pragmatic"
 
[model_providers.club]
name = "ai code club"
base_url = "https://opcx.ai/openai"
wire_api = "responses"
requires_openai_auth = true
env_key = "OPENAI_API_KEY"
 
[features]
shell_snapshot = true
collaboration_modes = true
multi_agent = true
unified_exec = true

认证文件 auth.json

在 ~/.codex/auth.json 文件中配置：

{
  "OPENAI_API_KEY": <your-api-key>
}

3. 配置环境变量

设置 OPENAI_API_KEY 环境变量为您的 API 密钥（格式如 cr_xxxxxxxxxx）。

macOS / LinuxWindows (PowerShell)Windows (CMD)

临时生效（当前窗口）：

export OPENAI_API_KEY=cr_xxxxxxxxxx

永久生效（推荐）：

对于 zsh（macOS 默认）：

echo 'export OPENAI_API_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

对于 bash：

echo 'export OPENAI_API_KEY="cr_xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

注意： 设置后，你可能需要重新打开终端窗口，或者手动执行 source ~/.zshrc (zsh) / source ~/.bashrc (bash) 使配置生效。

当前会话生效：

$env:OPENAI_API_KEY="cr_xxxxxxxxxx"

永久生效：

[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'cr_xxxxxxxxxx', 'User')

设置后需要重启 PowerShell 窗口。

当前会话生效：

set OPENAI_API_KEY=cr_xxxxxxxxxx

永久生效：

setx OPENAI_API_KEY "cr_xxxxxxxxxx"

设置后需要重启 CMD 窗口。

⚠️

请将 cr_xxxxxxxxxx 替换为您从 opcx.ai 获取的实际 API 密钥。

4. 验证配置

配置完成后，启动 Codex 验证是否配置成功：

codex

恭喜！ 你已经成功配置了 OpenAI Codex。现在可以开始使用 AI 辅助编码功能了。

常见问题

Q: 提示 API Key 无效？ A: 请检查环境变量是否配置正确，并确保 ~/.codex/auth.json 中的 OPENAI_API_KEY 设置为 null。

Q: 如何获取 API 密钥？ A: 请访问 获取 API Key 页面了解如何获取密钥。

在 IDE 中使用 Claude Code核心介绍