Codex 桌面端教程

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

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

01下载并安装 Codex 桌面端
02进入可可AI后台的 API 密钥页面
03复制 API 端点和自己的 API Key
04点击使用密钥,复制生成的配置
05没有 config.toml 就新建,把使用密钥内容复制进去
06打开 Codex,选择 API Key 登录并输入密钥
1. 下载桌面端

先安装 Codex 桌面端

Windows 用户下载 Windows 版;Mac 用户先确认自己的芯片类型,再选择 Apple 芯片版或 Intel 版。

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 端点、复制按钮和“使用密钥”。

教程截图发布时,请把完整的 sk-key 打码,只保留前后几位。用户真正要复制的是自己后台里的 Key。
  1. 点击左侧“API 密钥”页面标题显示“API 密钥”时,说明位置是对的。
  2. 确认 API 端点API 端点应为 https://kekeshop.top,旁边有复制按钮。
  3. 创建或复制一枚 Key新用户点右上角“创建密钥”;已有密钥可以点 Key 旁边的复制按钮。
  4. 点击“使用密钥”系统会生成 Codex 可用的配置内容。后面请复制“使用密钥”里给出的完整配置。
3. Windows 配置

没有 config.toml 就新建一个

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

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

进阶:CLI 用户

已经熟悉命令行时再看

如果你本来就会 CLI,可以继续使用命令行方式。普通新手优先按上面的桌面端流程配置。

Windows PowerShell

$codexDir = Join-Path $env:USERPROFILE ".codex"
New-Item -ItemType Directory -Force $codexDir | Out-Null
notepad (Join-Path $codexDir "config.toml")

macOS Terminal

mkdir -p ~/.codex
open -a TextEdit ~/.codex/config.toml

客服与说明

联系 woodwithyrj

微信:woodwithyrj

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

返回站点

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