Windows 10 / 11
前往官方下载
Windows 桌面端
安装新版桌面应用后即可使用 Codex。
Codex 桌面端快速接入
从安装，到第一次使用 GeoAI
按顺序完成下载、创建密钥、保存配置和账户充值，再开始第一次提问。全程不要求先学习命令行，预计 10 分钟完成。
- 01安装 Codex选择对应系统版本
- 02创建 API Key在 GeoAI 控制台完成
- 03保存配置粘贴后台生成内容
- 04保存凭证编辑 auth.json 后重启
01
下载安装
安装支持 Codex 的新版桌面端
新版 ChatGPT 桌面应用已整合 Codex。Windows 与 macOS 均从官方下载页安装；Mac 下载页会自动匹配芯片版本。
macOS 14 · Apple Silicon / Intel
前往官方下载
macOS 桌面端
下载页会自动识别芯片，并提供对应安装包。
官方当前提供整合了 Codex 的新版 ChatGPT 桌面应用，本教程以官方下载安装页为准。
02
创建密钥
在 GeoAI 控制台创建 API Key
登录控制台后进入“API 密钥”，创建一枚专用于 Codex 的密钥。密钥只会完整显示一次，请立即保存。
- 1登录 GeoAI
使用注册邮箱进入控制台。
- 2打开 API 密钥
在左侧导航找到“API 密钥”。
- 3创建并复制
创建密钥后，复制以
sk-开头的内容。 - 4点击“使用密钥”
复制系统为 Codex 生成的完整配置。
API 密钥管理访问凭证
API 端点
https://www.api.sciapi.cnCodex key
sk-geoai...8f2a
03
保存配置
把“使用密钥”配置保存到 config.toml
选择你的系统，打开 Codex 配置目录。没有 config.toml 时新建一个，再把控制台生成的内容完整粘贴进去。
- 1
按
Win + E打开文件资源管理器。 - 2
在地址栏输入
%USERPROFILE%\.codex后回车。 - 3
打开或新建
config.toml，粘贴后台生成的完整配置并保存。
- 1
在 Finder 中按
Shift + Command + G。 - 2
输入
~/.codex并打开该文件夹。 - 3
打开或新建
config.toml，粘贴后台生成的完整配置并保存。
.codexconfig.tomlsessionsskills
# 从 GeoAI 控制台点击“使用密钥”
# 将生成的配置完整粘贴到这里
配置内容以你的控制台为准
# 不要复制他人的 API Keyconfig.toml，不要保存成 config.toml.txt。
04
保存凭证
把 GeoAI API Key 写入 auth.json
auth.json 与 config.toml 位于同一个 .codex 文件夹。打开或新建文件，将自己的密钥写入后保存。
- 1
按
Win + E打开文件资源管理器。 - 2
在地址栏输入
%USERPROFILE%\.codex后回车。 - 3
打开或新建
auth.json，按下方格式写入自己的密钥并保存。
- 1
在 Finder 中按
Shift + Command + G。 - 2
输入
~/.codex并打开该文件夹。 - 3
打开或新建
auth.json，按下方格式写入自己的密钥并保存。
.codexconfig.tomlauth.jsonsessions
{
"OPENAI_API_KEY": "sk-geoai_xxxxxxxxx"
}auth.json 包含完整密钥
不要截图、上传、提交到 Git，也不要把文件或完整密钥发给客服。
05
余额充值
购买兑换码，并充值到 GeoAI 账户
登录 GeoAI 控制台后，从左侧进入“余额购买”。购买完成后复制兑换码，再回到左侧的“兑换窗口”粘贴并确认兑换。
- 1登录 GeoAI
进入控制台，确认当前登录的是需要充值的账户。
- 2打开余额购买
点击左侧“余额购买”，选择所需金额并完成付款。
- 3复制兑换码
购买完成后，复制页面显示的完整兑换码。
- 4提交兑换
打开左侧“兑换窗口”，粘贴兑换码并点击“确认兑换”。
账户余额
兑换码充值
兑换成功后，余额将自动计入当前账户。
XXXX-XXXX-XXXX
先购买，再兑换一个兑换码只能成功使用一次，请勿发给他人。
兑换前请核对当前登录账户。兑换成功后，可在控制台余额或使用记录中确认到账情况。
06
第一次提问
先让 Codex 读项目，再做一个小修改
第一次使用不建议直接改大量文件。先确认项目结构和启动方式，再安排边界清楚的任务。
请先阅读这个项目的结构，告诉我主要页面和启动方式。
然后帮我修改首页上的一处文案，改完后运行构建或测试验证。能读取项目文件
能正常返回回答
请求记录可在控制台查看
07
常见问题
出现问题时，按顺序检查
提示 API Key 无效
回到 GeoAI 控制台重新复制密钥，确认没有多余空格，并检查该密钥仍处于启用状态。
保存配置后没有生效
确认文件位于 .codex 文件夹、文件名为 config.toml，然后完全退出并重新打开 Codex。
请求无法连接
先检查网络，再确认“使用密钥”生成的配置已完整粘贴。不要自行删改 API 端点或 provider 字段。
兑换码提示无效或已使用
确认兑换码已完整复制且没有多余空格。如果仍无法兑换，请保留购买订单号和错误截图后联系客服，不要公开完整兑换码。
仍然无法使用
保留错误提示截图，并联系 QQ 79734777。截图前请遮住完整 API Key。