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

Codex 配置教程

先覆盖 config.toml 里的现有内容,再复制自己的 API Key,最后直接登录 Codex。

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

下载 Codex

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

APPLE SILICON

Mac M 系列芯片

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

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

复制自己的 API Key

配置文件保存完成后,再回到控制台复制密钥。

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

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

  2. 复制自己的 API Key

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

  3. 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。仍失败时重新执行安装脚本。