Codex 桌面端教程

从下载桌面端，到配置可可AI API Key

这版教程默认按桌面端讲，不要求新用户先学命令行。跟着下载入口、红框位置和配置文件步骤操作，再用 API Key 登录 Codex，就能开始使用。

下载 Codex 桌面端 Windows 配置文件登录创建 API Key

01下载并安装 Codex 桌面端

02进入可可AI后台的 API 密钥页面

03复制 API 端点和自己的 API Key

04点击使用密钥，复制生成的配置

05没有 config.toml 就新建，把使用密钥内容复制进去

06打开 Codex，选择 API Key 登录并输入密钥

1. 下载桌面端

先安装 Codex 桌面端

Windows 用户下载 Windows 版；Mac 用户先确认自己的芯片类型，再选择 Apple 芯片版或 Intel 版。OpenAI 官方页面会同步最新下载入口，遇到直链变动时以官方页面为准。

OpenAI 官方下载地址

这是最权威、最新的 Codex 官方页面；如果下面的系统直链后续变化，先以 OpenAI 官方页面为准。

打开 OpenAI 官方下载页

Windows Windows 桌面端

适合 Windows 10 / 11 用户，从 Microsoft Store 安装器下载。

下载 Windows 版

macOS Mac Apple 芯片

适合 M1、M2、M3、M4 等 Apple Silicon Mac。

下载 Mac 版

macOS Intel Mac Intel 芯片

适合较早的 Intel 处理器 Mac。如果不确定芯片类型，可以先点左上角苹果图标，再点“关于本机”。

下载 Intel 版

2. 创建 API Key

在可可AI后台找到密钥和 API 端点

登录后进入 API 密钥页面。下面的红框示意图标出了最容易找不到的位置：左侧入口、API 端点、复制按钮和“使用密钥”。

API 密钥 管理您的 API 密钥和访问令牌

搜索名称或 Key... 全部分组全部状态

API 端点 https://kekeshop.top 复制

新手 key sk-adfcb...85e4 Codex pro 性能池

备用 key sk-8147a...1e13 Codex Plus 经济池

教程截图发布时，请把完整的 sk-key 打码，只保留前后几位。用户真正要复制的是自己后台里的 Key。

点击左侧“API 密钥”页面标题显示“API 密钥”时，说明位置是对的。
确认 API 端点API 端点应为 https://kekeshop.top，旁边有复制按钮。
创建或复制一枚 Key新用户点右上角“创建密钥”；已有密钥可以点 Key 旁边的复制按钮。
点击“使用密钥”系统会生成 Codex 可用的配置内容。后面请复制“使用密钥”里给出的完整配置。

3. Windows 配置

没有 config.toml 就新建一个

这里不需要命令行。核心就是打开 Codex 配置文件夹，把控制台“使用密钥”教程里的配置内容复制进去。

打开配置文件夹按 Win + E 打开文件资源管理器，在地址栏粘贴 %USERPROFILE%\.codex 后回车。
没有 config.toml 就新建一个如果文件夹里没有 config.toml，就在里面新建一个。用记事本打开它即可。
复制“使用密钥”里的配置回到可可AI控制台，点击密钥右侧的“使用密钥”，把教程里给出的配置内容完整复制进去。
保存 config.toml保存文件后关闭记事本。注意文件名应是 config.toml，不是 config.toml.txt。
打开 Codex 桌面端选择“使用 API Key”方式登录，输入你的 API 密钥。这里输入的是你自己后台复制的 Key。

文件资源管理器

%USERPROFILE%\.codex

config.toml

记事本

# 粘贴控制台“使用密钥”教程里的完整配置
# 如果没有 config.toml，就新建一个再粘贴

model_provider = "OpenAI"

文件名：config.toml 内容来源：控制台“使用密钥” 登录方式：Codex 桌面端选择 API Key

这一步不用背命令。只要有 config.toml，并且里面是控制台“使用密钥”给出的完整配置即可。

重要提醒

不要把完整 API Key 发给别人，也不要照抄教程示意里的 sk-xxxx。打开 Codex 桌面端时，请选择 API Key 登录，并输入你自己的 API 密钥。

4. Mac 配置

Mac 用户也保存到同一个配置文件

Mac 端配置位置是用户目录下的 ~/.codex/config.toml。

打开文件夹

在 Finder 里按 Shift + Command + G，输入 ~/.codex 并回车。

粘贴配置

打开或新建 config.toml，把可可AI后台“使用密钥”生成的配置完整粘贴进去。

重新打开 Codex

关闭并重新打开 Codex 桌面端，然后选择一个项目开始使用。

5. 登录 Codex

选择 API Key 登录并输入你的密钥

配置文件保存好以后，打开 Codex 桌面端。登录方式选择“使用 API Key”，然后输入你在可可AI后台复制的 API 密钥。

登录时选这个

选择 Use API Key 或“使用 API Key”。不要选网页登录或 ChatGPT 账号登录。

输入自己的 API Key

把可可AI后台复制的 sk-... 密钥粘贴进去。不要输入教程截图里的示例 Key。

6. 第一次提问

打开项目后这样问

第一次不要直接让它改一大堆文件，先让 Codex 读项目，再做一个边界清楚的小修改。

请先阅读这个项目的结构，告诉我主要页面和启动方式。

然后帮我修改首页上的一个文案，改完后运行构建或测试验证。

看不到配置效果？

确认 config.toml 已保存到 %USERPROFILE%\.codex，然后重新打开 Codex。

提示 Key 无效？

回到可可AI后台重新复制 API Key，并确认 Codex 登录时选择的是 API Key 方式。

一定要学 CLI 吗？

不用。桌面端足够完成读代码、改代码、运行验证这些常见任务。CLI 可以放到进阶教程。

进阶路线，不是新手必做

进阶：Codex CLI

熟悉命令行的人，再用 CLI

上面的桌面端流程是新手主线。CLI 是另一条进阶路线，适合已经会 macOS Terminal 或 Windows PowerShell、会进入项目目录、习惯用命令行的人。

Mac 和 Windows 安装前都先开魔法

Codex CLI 安装和登录会访问 OpenAI / ChatGPT 官方服务。先打开魔法，再新开一个终端窗口：Mac 使用“终端（Terminal）”，Windows 使用 PowerShell。

macOS Terminal

1. 安装 Codex CLI

打开“终端（Terminal）”，直接粘贴这一行。

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell

1. 安装 Codex CLI

打开 PowerShell，直接粘贴这一行。

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

检查

2. 重开终端并检查

安装完成后关掉 Terminal 或 PowerShell，重新打开，再检查版本。

codex --version

启动

3. 进入项目再启动

Mac：先进入项目文件夹，再运行 Codex。

cd ~/Desktop/my-project
codex

Windows：在 PowerShell 中使用自己的项目路径。

cd C:\Users\你的用户名\Desktop\my-project
codex

4. 按提示登录

第一次启动会提示登录。按提示选择登录方式；如果你走可可AI API Key，仍然先按上面的配置文件步骤保存 config.toml。

排错

装不上怎么办

先确认魔法已开启，再重新打开 Terminal 或 PowerShell。仍然失败时运行诊断命令，把结果截图或复制给客服。

codex doctor

客服与说明

联系 woodwithyrj

微信：woodwithyrj

如遇配置、认证或连接异常，可先截图报错再联系。

返回站点

如果你是从搜索引擎打开这页，建议先回到首页查看价格、套餐和站点政策说明。

返回首页登录后台