Codex

Codex 是 OpenAI 的编程代理产品族，包含桌面端 App 和终端里的 Codex CLI。新手先按自己的系统选入口：Windows 想要图形界面用桌面端，Windows 想跑 CLI 建议用 WSL2；macOS 可选桌面端或 CLI；Linux 目前按 CLI 路线走。

本页先帮你选对下载入口和配置目录，再把 AIDMX 作为 OpenAI 兼容服务接入 Codex。只想做命令行验证时，直接看 Codex CLI。

下载和官方入口

入口	适合谁	官方链接
Codex App 桌面端	想用图形界面管理本地项目和多个任务的新手	Codex App 文档、Codex App 申请/下载页
Windows 桌面端	Windows 用户优先从官方页或 Microsoft Store 安装	Microsoft Store 安装器，也可用 winget install Codex -s msstore
macOS 桌面端	想用 App 体验的 Mac 用户	Apple Silicon DMG、Intel DMG
Codex CLI	想在终端、脚本或远程环境中使用 Codex 的用户	Codex CLI 文档、GitHub 仓库

不要从第三方网盘或重打包安装器下载 Codex。下载页、Microsoft Store、GitHub Releases 和包管理器是更可控的来源。

平台支持

系统	新手推荐	配置目录
Windows 桌面端	用 Codex App，适合 PowerShell 和 Windows 本地项目	%USERPROFILE%\.codex
Windows CLI	用 WSL2 里的 Codex CLI，适合 Linux 工具链和 UTF-8 项目	WSL 内的 ~/.codex
macOS	桌面端和 CLI 都可用；先用 CLI 验证 AIDMX 更容易排错	~/.codex
Linux	使用 Codex CLI；没有桌面端路线时不要套用 macOS/Windows App 步骤	~/.codex

Windows 原生 Codex 桌面端的 %USERPROFILE%\.codex 和 WSL 中的 ~/.codex 不是同一个目录，也不会自动共享配置。你在哪个环境运行 Codex，就在哪个环境配置 AIDMX。

安装后检查

桌面端：

1. 能正常打开 Codex App，并完成登录或 API Key 授权。
2. 能添加一个本地项目，或打开一个非关键测试目录。
3. 如果要复用 CLI 配置，确认 App 当前读取的是同一套 Codex 配置目录。

CLI：

codex --version
codex --help

Windows WSL2 中还要确认：

pwd
ls -la ~/.codex 2>/dev/null || true

适用场景

• 希望 Codex 使用 AIDMX 提供的模型或网关。
• 需要理解桌面端和 CLI 配置目录是否相同。
• 需要验证 AIDMX Token 是否能支撑代码助手工作流。

前置条件

• 已安装 Codex 或 Codex CLI。
• 已创建 AIDMX API Token。
• 已确认目标模型支持 Codex 所需的接口形态。
• 本页配置键参考 Codex CLI 0.106.0 本地帮助和配置格式，其他版本需重新确认。

配置 AIDMX

1. 先完成 Codex CLI 的命令行验证。
2. 如果桌面端读取同一份 Codex 配置，保持 model_provider、base_url 和模型名称一致。
3. 将 Base URL 设置为 https://ai.aidmx.xyz/v1。
4. 使用 API Token 登录或配置密钥，具体方式以当前 Codex 版本为准。
5. 在一个非关键项目中发送简单任务，例如“总结这个目录结构”。
6. 到 AIDMX 使用日志 确认请求记录。

如果通过 CC Switch 管理 Codex 配置，先在 Codex 页签中新增供应商，再填写 AIDMX 的 API Key、Base URL 和模型名称。截图中的 Provider 表单对应 Codex 桌面端或 CLI 复用配置时需要核对的字段。

配置完成后，启用对应供应商，再回到 Codex 发送一次低风险任务，最后用 AIDMX 使用日志验证请求来源。

成功验证

• Codex 能创建会话并返回回答。
• 任务执行时没有认证、模型或接口错误。
• AIDMX 日志中出现 Codex 触发的请求。

常见失败

• Codex 要求 Responses API：确认 AIDMX 当前模型和网关是否支持对应接口。
• 配置后仍走默认服务：重启 Codex，并确认当前 profile 或配置文件被加载。
• 模型无法工作：换用 AIDMX 控制台确认可用的模型名称。
• 认证失败：重新执行登录或检查 API Token 是否完整。

下一步

• 先阅读 Codex CLI 进行可重复验证。
• 对通用客户端，阅读 OpenAI 兼容工具。
• 遇到请求失败时，回到 使用日志 排查。