在 ChatGPT 桌面应用的 Codex 模式中使用 跨界AIChatGPT 桌面应用内置了 Codex(也常被称为 Codex App),可以在图形界面中让 Codex 读写项目文件、执行命令。它和 Codex 命令行工具共用同一份配置文件
config.toml,按本页配置后即可使用 跨界AI
[!NOTE]
如果你已经按 Codex 安装与配置 配置过 config.toml,登录后可以跳过「写入配置文件」,直接验证
下载安装
前往 ChatGPT 下载页 下载对应系统的安装包,运行后按提示完成安装。支持 macOS 和 Windows创建 API Key
在控制台 创建 API Key 时,「厂商」选择「OpenAI」使用 API Key 登录
打开应用,在「欢迎使用 Codex」界面点击「输入 API 密钥」,填入你的 跨界AI API Key 后确认[!WARNING] 不要点击「继续使用 ChatGPT 登录」,否则请求会发送到 OpenAI 官方,而不是 跨界AI
写入配置文件
1. 打开设置 点击左下角「设置」,在弹出的菜单中再点击「设置」。菜单顶部显示「已通过 API 密钥登录」,说明上一步登录成功 2. 打开 config.toml 在左侧选择「配置」,点击右侧的「打开 config.toml」 3. 粘贴配置 把文件内容替换为以下配置并保存config.toml
[!WARNING]
Codex 的请求地址必须以 /v1 结尾
也可以直接用编辑器打开配置文件:macOS 为 ~/.codex/config.toml,Windows 为 C:\Users\你的用户名\.codex\config.toml
4. 重启应用
完全退出应用(macOS 按 Cmd+Q)后重新打开,配置才会生效
验证
重新打开应用后,查看输入框下方,显示「自定义 (config.toml)」说明已经在使用你的配置 发送以下消息,能正常回复ok 即表示配置完成
常见问题
修改配置后没有生效 应用只在启动时读取config.toml。修改后需要完全退出应用(macOS 按Cmd+Q),再重新打开
输入框下方没有显示「自定义 (config.toml)」
- 确认已保存
config.toml,并且重启了应用- 确认
config.toml中有model_provider = "OpenAI"和[model_providers.OpenAI]两部分
Chat 或 Work 模式无法使用 使用 API Key 登录时,只有 Codex 会走 跨界AI。依赖 ChatGPT 账号和云端服务的功能(如 Chat、Work 模式和部分插件)不可用,属于正常现象
和 Codex 命令行工具的配置有什么关系
两者共用 config.toml 和登录信息,配置一次即可同时用于命令行和桌面应用
提示 401 或认证失败
- 确认 API Key 已正确复制(无多余空格),且在有效期内
- 确认创建 API Key 时厂商选择的是「OpenAI」
- 确认
config.toml中base_url为https://api.kuajieaigc.com/v1- 在左下角「设置」菜单中点击「退出登录」,再通过「输入 API 密钥」重新登录
连接超时或无法访问 确认更多问题参考 Codex 常见问题config.toml中的base_url使用https://api.kuajieaigc.com/v1,然后重启应用