Skip to main content

​
安装与更新

macOS Homebrew 安装
brew install codex
NPM 安装确保 npm 全局路径已添加到 PATH
npm config get prefix
# 添加到 PATH
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Homebrew
brew upgrade codex
NPM
npm i -g @openai/codex --registry=https://registry.npmmirror.com
排查步骤
  1. 检查网络连接
  2. 确保 Node.js 18+ 已安装（NPM 方式）
  3. Windows 用户确保在 WSL 环境中安装
  4. 使用镜像源： 
    npm i -g @openai/codex --registry=https://registry.npmmirror.com
Codex 不支持原生 Windows，必须在 WSL 中运行安装 WSL
wsl --install
在 WSL 中安装 Codex
npm i -g @openai/codex --registry=https://registry.npmmirror.com

​
配置问题

  • macOS/Linux: ~/.codex/
  • Windows: C:\Users\你的用户名\.codex\
需要两个文件：config.toml 和 auth.json
Codex 使用 OpenAI 兼容格式，端点必须包含 /v1 路径
base_url = "https://code.rayinai.com/v1"
auth.json 中应使用完整的 API Key，不是环境变量名正确示例
{
  "OPENAI_API_KEY": "sk_xxxxxxxxxx"
}
错误示例
{
  "OPENAI_API_KEY": "CODEX_API_KEY"
}
Windows 用户需要在 config.toml 中添加
windows_wsl_setup_acknowledged = true
在 config.toml 中添加
[features]
web_search_request = true
在 ~/.codex 目录创建 AGENTS.md 文件，写入自定义提示词后重启生效

​
模型使用

方法一：修改配置文件（推荐）
  1. 打开 config.toml，找到 model = "gpt-5.2"
  2. 改为 model = "gpt-5.3-codex"
  3. 保存后重启客户端
启用后不要在会话中切换模型
方法二：CLI 启动参数
codex -m gpt-5.3-codex -c model_reasoning_effort="xhigh"
方法三：VSCode 插件（v0.5.72）
  1. 确保使用预发布版本
  2. 找到插件目录：
    • Windows: %userprofile%\.vscode\extensions
    • macOS: ~/.vscode/extensions
  3. 找到 openai.chatgpt-0.5.72-* 文件夹
  4. 进入 webview\assets 目录
  5. 替换对应的 js 文件
  6. 重启 VSCode
命令说明
/model选择模型
/review审查变更
/resume继续历史会话
/compact压缩上下文
/undo撤销操作
/mcp查看 MCP 工具

​
错误排查

排查步骤
  1. 检查本机网络是否通畅
  2. 关闭代理工具
  3. 在 CLI 中测试是否为 VS Code 插件问题
  4. 重启 VS Code
检查环境变量冲突
# Windows
echo %OPENAI_API_KEY%
echo %OPENAI_BASE_URL%
如果有输出，清除环境变量
setx OPENAI_API_KEY ""
setx OPENAI_BASE_URL ""
检查配置文件
  • ~/.codex/auth.json 中的 API Key 是否正确
  • ~/.codex/config.toml 中的 base_url 是否包含 /v1
通常是号池账号问题
  1. 停止当前对话（Ctrl+C）
  2. 重新发起对话
  3. 如果重试 3 次以上无效，联系技术支持
解决步骤
  1. 按 Win + R，输入 intl.cpl 回车
  2. 点击「管理」选项卡
  3. 点击「更改系统区域设置」
  4. 勾选「Beta: 使用 Unicode UTF-8 提供全球语言支持」
  5. 确定后重启电脑

​
其他问题

联系技术支持

如果以上方法无法解决问题，请联系技术支持