Codex 安装与使用
配置包下载
选择当前使用的系统
ChatGPT 桌面应用(Codex)
一键配置 codex 简明教程
适合新手照着做 | Windows / macOS 联系方式:QQ群:727366519 (遇到问题请加群咨询)
一、安装 ChatGPT 桌面应用(Codex)
先安装 ChatGPT 桌面应用并打开一次,再在应用中进入 Codex。首次打开会自动创建后续配置要用的文件夹。
| 系统 | 怎么安装 |
|---|---|
| macOS | 访问 https://chatgpt.com/download/,下载 ChatGPT macOS 版本。打开安装包后,将 ChatGPT 拖入“应用程序”。 |
| Windows | 访问 https://chatgpt.com/download/,下载 ChatGPT Windows 版本并按安装向导完成安装。 |
- 安装完成后打开 ChatGPT,在应用中选择 Codex。
- 如果桌面应用要求登录,按应用提示完成官方登录。官方登录与下面的中转站 Provider 配置是两件事,不能用中转站 API key 代替官方账号登录,也不能仅凭登录状态判断请求是否经过中转站。
- 确认 Codex 能打开后,退出 ChatGPT,再继续下面的一键配置。
二、准备 API key 和脚本文件
| 准备项 | 说明 |
|---|---|
| API key | 在 https://apiapi.gptshare666.pro 注册、充值或开套餐后,到“API 密钥”里创建并复制。分组和模型权限以当天 API 站可见选项为准;只有在目标模型可用时,才选择相应的优惠分组。 |
| 对应系统文件夹 | Windows 用 Windows 文件夹;macOS 用 Mac 文件夹。不要混用。 |
| Codex 状态 | 运行脚本前先完全退出 ChatGPT,脚本完成后再重新打开 ChatGPT 并进入 Codex。 |
三、填写 OPENAI_API_KEY.txt
打开对应文件夹里的 OPENAI_API_KEY.txt,填入自己的 key。
| 系统 | 要编辑的文件 |
|---|---|
| Windows | Windows\OPENAI_API_KEY.txt |
| macOS | Mac/OPENAI_API_KEY.txt |
网页教程只推荐直接填写密钥本身。
| sk-你的真实密钥 |
- 不要放中文说明、空格或其他多余内容;两种写法都不要同时填写。
四、Windows 操作步骤
- 打开 Windows 文件夹。
- 确认 OPENAI_API_KEY.txt 已经填好并保存。
- 双击运行 Codex-NewAPI-Setup.exe。
- 如果 Windows 提示安全警告,先核对安装包来源和发布页提供的校验信息;确认无误后,再选择“更多信息” -> “仍要运行”。
- 看到“完成”后,按 Enter 关闭窗口。
- 完全退出并重新打开 ChatGPT,在应用中进入 Codex。
| Windows 脚本会设置 OPENAI_BASE_URL、OPENAI_API_KEY,并写入 C:\Users\你的用户名\.codex\config.toml;如果已有旧配置,会先生成备份,但原有 MCP 和自定义 Provider 仍可能被覆盖。 |
五、macOS 操作步骤
打开 Mac 文件夹。
确认 OPENAI_API_KEY.txt 已经填好并保存。
打开“终端”,进入 Mac 文件夹所在目录。
先执行授权命令:
bashchmod +x setup-newapi-codex-mac.sh1再执行配置脚本:
bash./setup-newapi-codex-mac.sh1看到“完成”后,按 Enter 关闭窗口。
完全退出并重新打开 ChatGPT,在应用中进入 Codex。
| macOS 脚本会设置 OPENAI_BASE_URL、OPENAI_API_KEY,并写入 ~/.codex/config.toml;如果已有旧配置,会先生成备份,但原有 MCP 和自定义 Provider 仍可能被覆盖。重启 Mac 后失效时,重新运行脚本即可。 |
六、验证是否成功
- 确认脚本窗口已经显示“完成”。
- 完全退出 ChatGPT,再重新打开并进入 Codex。
- 在 Codex 中发送一句测试,例如:你好,请确认你可以正常工作。
- 确认 Codex 正常回复后,到 API 站“使用日志”核对请求状态、模型和扣费;两处都正常,才算中转配置验证完成。
七、常见问题
| 问题 | 怎么处理 |
|---|---|
| 提示 key 不可用 | 检查 OPENAI_API_KEY.txt 里是否使用其中一种格式,没有空格、中文说明或多余内容;网页教程优先使用 key 本身。 |
| Windows 被拦截 | 先确认文件来源和校验信息,再点“更多信息” -> “仍要运行”。 |
| 运行后 Codex 没变化 | 一定要完全退出 ChatGPT,再重新打开并进入 Codex;Windows 仍无效可重启电脑。 |
| macOS permission denied | 先执行 chmod +x setup-newapi-codex-mac.sh。 |
| macOS 重启后不能用 | 重新运行 ./setup-newapi-codex-mac.sh。 |
| 想换 key | 改 OPENAI_API_KEY.txt,重新运行对应脚本,再重启 Codex。 |
| 想恢复旧配置 | 找到 config.toml.bak-日期时间 备份,把它改回 config.toml 后重启 Codex。 |
八、一句话速查
| Windows:安装并打开一次 ChatGPT,在应用中选择 Codex -> 填 Windows\OPENAI_API_KEY.txt -> 双击 Codex-NewAPI-Setup.exe -> 重启 ChatGPT。 |
| macOS:安装并打开一次 ChatGPT,在应用中选择 Codex -> 填 Mac/OPENAI_API_KEY.txt -> 运行 chmod +x -> 运行 ./setup-newapi-codex-mac.sh -> 重启 ChatGPT。 |
配置补充:地址、协议与脚本覆盖
本站配置包使用 OpenAI Responses 接口,不是普通 Chat Completions 配置。脚本中的地址用途不同,请保持配置包原样:
| 配置位置 | 地址或值 | 说明 |
|---|---|---|
OPENAI_BASE_URL 环境变量 | https://apiapi.gptshare666.pro | 脚本设置的 API 根地址 |
config.toml 的 Provider base_url | https://apiapi.gptshare666.pro/v1 | Codex Responses Provider 地址,配置包已写入 /v1 |
config.toml 的 wire_api | responses | 指定使用 Responses 协议 |
不要把普通 Chat Completions 示例直接改路径套用到 Codex,也不要自行重复添加或删除 /v1。模型 ID 如需调整,请从常用模型 ID复制当前精确名称,并确认该模型支持 Responses。
配置包兼容格式:
text
OPENAI_API_KEY=你的真实密钥1
如果本机已有 ~/.codex/config.toml(Windows 对应 C:\Users\你的用户名\.codex\config.toml),请先手动复制一份。配置包会生成带日期时间的备份,但仍可能覆盖原文件中的 MCP、自定义 Provider 或其他个人设置;需要保留的内容请在运行前另行备份和记录。