Codex Setup

第一步 · 安装主程序

Codex 安装与配置指南

按下面这篇文章完成 4 个动作:先安装 Codex,再进入配置目录,替换 auth.jsonconfig.toml,最后重新打开 Codex 即可使用。

更新于 2026 年 3 月 约 3 分钟 张少聪

Codex+Installer.exe

Windows 安装包 · 1.12 MB

配置文件请直接使用当前素材目录中的 auth.jsonconfig.toml

下载安装包

第一步:安装包安装(当前页面)

安装 Codex 主程序,替换配置文件

第二步:安装 Codex CLI

安装 Node.js,配置环境变量,安装终端版 Codex


步骤 1:打开并安装 Codex

找到你收到的 Codex+Installer.exe,双击打开安装程序, 然后按照默认流程完成安装即可。

  • 如果系统弹出权限提示,选择允许或继续。
  • 安装成功后先不要直接使用,下一步需要替换配置文件。
  • 安装包只需要运行一次,后续不需要重复安装。
Codex 安装包图标
双击这个安装包开始安装。

步骤 2:进入 .codex 配置目录

安装完成后,打开 Windows 文件资源管理器,在顶部地址栏里输入下面这段路径, 然后按回车:

Windows 路径
%userprofile%\.codex\

进入这个目录后,你会看到 Codex 的本地配置文件。这里就是接下来要替换 auth.jsonconfig.toml 的位置。

在文件资源管理器中打开 .codex 目录
在地址栏输入路径后,就会进入 Codex 的配置目录。

步骤 3:替换两个配置文件

先关闭正在运行的 Codex。然后把你收到的两个配置文件复制到 %userprofile%\.codex\ 目录中,并覆盖原来的同名文件。

需要替换的文件

auth.json 下载
config.toml 下载

文件名保持不变,直接覆盖即可。

替换前注意

请先退出 Codex,再进行复制和覆盖,避免旧配置仍然被程序占用。

  1. 找到你收到的 auth.jsonconfig.toml
  2. 把这两个文件复制到 %userprofile%\.codex\ 目录。
  3. 系统出现提示时,选择"替换目标中的文件"。

步骤 4:重新打开 Codex

两个配置文件替换完成后,重新打开 Codex。正常情况下,进入主界面后就可以直接开始使用了。

Codex 主界面
配置替换完成后,重新打开 Codex 即可使用。

主界面打开后即可正常使用。Codex 还可以协助你安装 Node.js 和 Codex CLI, 获得完整的终端能力。请继续 第二步:安装 Codex CLI


补充说明

  • 本教程适用于 Windows,因为安装文件是 .exe 格式。
  • 如果你在资源管理器里看不到隐藏目录,不需要手动找,直接输入路径即可。
  • 文章里提到的配置文件请直接使用当前素材目录中的同名文件。
  • 替换完成后必须重新打开 Codex,新的配置才会生效。
  • 主界面安装完成后,建议继续 安装 Codex CLI,获得完整功能。