CODEX · 桌面端与 CLI · 约 8 分钟

Codex 配置教程

安装 Codex,复制可可AI 控制台生成的配置,再使用自己的 API Key 登录。新手按桌面端主线操作即可。

  1. 01
    安装 Codex选择与你电脑匹配的版本
  2. 02
    创建密钥复制自己的 API Key
  3. 03
    保存配置写入 config.toml
  4. 04
    登录验证选择 API Key 并开始使用

下载 Codex

优先从 OpenAI 官方页面下载最新版。Mac 用户可在“关于本机”中确认芯片类型。

APPLE SILICON

Mac M 系列芯片

适用于 M1、M2、M3、M4 等 Apple 芯片。

下载 Mac 版
下载入口发生变化? 前往 OpenAI Codex 官方页面获取最新版本。

准备 API Key 与配置

登录控制台,在“API 密钥”页面完成下面三项操作。

  1. 创建或选择一枚可用密钥

    新用户点击“创建密钥”;已有密钥可直接使用。

  2. 复制自己的 API Key

    密钥通常以 sk- 开头。不要使用教程中的示例,也不要把完整密钥发给他人。

  3. 点击“使用密钥”

    选择 Codex,复制控制台生成的完整 config.toml 配置。

API 端点https://kekeshop.top
配置来源控制台 → API 密钥 → 使用密钥 → Codex

保存 config.toml

把控制台生成的内容完整粘贴到用户配置文件。已有配置时先备份,再按控制台说明合并。

Windows

  1. 打开配置目录

    Win + E,在地址栏输入 %USERPROFILE%\.codex

  2. 新建或打开 config.toml

    若文件不存在,用记事本新建。确认文件名不是 config.toml.txt

  3. 粘贴并保存

    粘贴“使用密钥”生成的完整配置,然后完全退出并重新打开 Codex。

密钥安全 配置文件和登录凭据都属于敏感信息,不要提交到 Git,也不要发到群聊或工单。

登录并开始第一个任务

打开 Codex,选择 API Key 登录方式,输入刚才复制的密钥。

01

选择 API Key

在登录页面选择“Use API Key”或“使用 API Key”。

02

输入自己的密钥

粘贴控制台中的完整 API Key,完成登录。

03

打开一个项目

先让 Codex 了解项目,再提出边界清晰的小任务。

第一次提问示例
请先阅读这个项目的结构,告诉我主要页面和启动方式。

然后修改首页的一处文案,并运行构建或测试验证。

使用 Codex CLI

习惯终端的用户可以安装 CLI。桌面端用户无需完成这一节。

Terminal
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
cd ~/Desktop/my-project
codex
登录方式 首次运行 codex 后选择 API Key 登录;配置文件仍使用上面的 config.toml

常见问题

配置没有生效

确认文件位于用户目录下的 .codex/config.toml,保存后完全退出并重新打开 Codex。

提示 API Key 无效

回到控制台重新复制完整密钥,并确认登录时选择的是 API Key 方式。

文件变成 config.toml.txt

在资源管理器中开启“文件扩展名”,将文件重命名为 config.toml

CLI 安装后找不到 codex

关闭并重新打开终端,再运行 codex --version。仍失败时重新执行安装脚本。