快速开始

Codex（App / CLI）

分别介绍 Codex App 和 CLI 在 Windows、macOS 上的安装、手动配置和使用。

Codex App 和 Codex CLI 的教程分别列在下方，每部分均包含 Windows 与 macOS 的安装、配置和使用步骤。

Codex App

按你的系统查看 Windows 或 macOS 步骤。

Windows

1. 安装

从 Codex 官网下载 Windows 安装包，运行安装程序并打开 Codex。

2. 配置

准备一个 API Key，并在模型目录确认可用模型。下方以 gpt-5.6-sol 为例。

从 Codex App 打开配置：

  1. 点击左下角的账户菜单，选择设置。
Codex Windows 完整界面，黄色框标出左下角账户菜单和设置入口。
  1. 在设置左侧点击配置，选择用户配置。
  2. 点击右上方的打开 config.toml，在记事本或 VS Code 中打开文件。
Codex Windows 设置完整界面，黄色框标出配置菜单和打开 config.toml 按钮。

直接从文件夹打开配置：

配置文件位于 %USERPROFILE%\.codex\config.toml。

  1. 按 Win + E 打开文件资源管理器。
  2. 在地址栏输入 %USERPROFILE%\.codex，按回车。
  3. 右键 config.toml，选择打开方式 → 记事本。没有 .codex 文件夹时，先在 %USERPROFILE% 目录中新建它；没有文件时，在记事本中新建。

在文件中填写：

config.toml
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
model_provider = "get-codex"

[model_providers.get-codex]
name = "Get-Codex"
base_url = "https://api.get-apikey.com/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "your-api-key"

将 your-api-key 替换为自己的 API Key，按 Ctrl + S 保存。新建文件时选择另存为，保存到 .codex 文件夹，文件名填 config.toml，保存类型选所有文件，编码选 UTF-8。在资源管理器中显示文件扩展名，确认不是 config.toml.txt。

文件已有内容时，先备份并更新同名字段。前三行放在任何 [表名] 之前，同名字段和 Provider 段只保留一份；保留其他 MCP、项目和权限设置。

3. 使用

  1. 完全退出并重新打开 Codex。
  2. 选择项目或工作目录，点击新建会话。
  3. 确认模型后发送 只回复 OK，收到回复即可开始输入任务。

macOS

1. 安装

从 Codex 官网下载 macOS 安装包，打开 DMG 并将 Codex 拖到“应用程序”，然后打开 Codex。

2. 配置

准备一个 API Key，并在模型目录确认可用模型。下方以 gpt-5.6-sol 为例。

从 Codex App 打开配置：

  1. 点击左下角菜单中的设置。
  2. 进入 Config，选择用户配置。
  3. 点击 Open config.toml，在文本编辑器或 VS Code 中打开文件。
Codex macOS 桌面版，箭头标出左下角设置入口。 Codex 配置页，箭头标出 Config 和 Open config.toml。

直接从 Finder 打开配置：

配置文件位于 ~/.codex/config.toml。

  1. 打开 Finder（访达），按 Command + Shift + G。
  2. 输入 ~/.codex，点击前往。
  3. 右键 config.toml，用“文本编辑”或 VS Code 打开。可按 Command + Shift + . 显示隐藏文件。
  4. 如果目录或文件不存在，打开 VS Code，选择文件 → 打开文件夹，按 Command + Shift + G，输入 ~ 并打开用户主目录。在左侧资源管理器中新建 .codex 文件夹，再在其中新建 config.toml。

在文件中填写：

config.toml
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
model_provider = "get-codex"

[model_providers.get-codex]
name = "Get-Codex"
base_url = "https://api.get-apikey.com/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "your-api-key"

将 your-api-key 替换为自己的 API Key，按 Command + S 保存。使用“文本编辑”时，先选择格式 → 制作纯文本，文件名保持为 config.toml。

文件已有内容时，先备份并更新同名字段。前三行放在任何 [表名] 之前，同名字段和 Provider 段只保留一份；保留其他 MCP、项目和权限设置。

3. 使用

  1. 完全退出并重新打开 Codex，可按 Command + Q 退出。
  2. 选择项目或工作目录，点击新建会话。
  3. 确认模型后发送 只回复 OK，收到回复即可开始输入任务。

Codex CLI

按你的系统查看 Windows 或 macOS 步骤。

Windows

1. 安装

打开开始菜单中的 PowerShell，检查 Node.js 和 npm：

node --version
npm --version

如果提示找不到命令，从 Node.js 官网安装 LTS 版本，再重新打开 PowerShell。

确认能看到版本号后，执行以下命令安装 CLI：

npm install --global @openai/codex
codex --version

2. 配置

准备一个 API Key，并在模型目录确认可用模型。下方以 gpt-5.6-sol 为例。

配置文件位于 %USERPROFILE%\.codex\config.toml。

  1. 按 Win + E 打开文件资源管理器。
  2. 在地址栏输入 %USERPROFILE%\.codex，按回车。
  3. 右键 config.toml，选择打开方式 → 记事本。没有 .codex 文件夹时，先在 %USERPROFILE% 目录中新建它；没有文件时，在记事本中新建。

在文件中填写：

config.toml
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
model_provider = "get-codex"

[model_providers.get-codex]
name = "Get-Codex"
base_url = "https://api.get-apikey.com/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "your-api-key"

将 your-api-key 替换为自己的 API Key，按 Ctrl + S 保存。新建文件时选择另存为，保存到 .codex 文件夹，文件名填 config.toml，保存类型选所有文件，编码选 UTF-8。在资源管理器中显示文件扩展名，确认不是 config.toml.txt。

文件已有内容时，先备份并更新同名字段。前三行放在任何 [表名] 之前，同名字段和 Provider 段只保留一份；保留其他 MCP、项目和权限设置。

3. 使用

  1. 用资源管理器打开项目文件夹，在地址栏输入 powershell 并按回车。
  2. 运行：
codex
  1. 按提示确认项目，发送 只回复 OK。收到回复后，即可输入编程任务。

继续项目中的旧会话时，在同一个项目文件夹运行：

codex resume

macOS

1. 安装

打开“终端”，检查 Node.js 和 npm：

node --version
npm --version

如果提示找不到命令，从 Node.js 官网安装 LTS 版本，再重新打开终端。

确认能看到版本号后，执行以下命令安装 CLI：

npm install --global @openai/codex
codex --version

2. 配置

准备一个 API Key，并在模型目录确认可用模型。下方以 gpt-5.6-sol 为例。

配置文件位于 ~/.codex/config.toml。

  1. 打开 Finder（访达），按 Command + Shift + G。
  2. 输入 ~/.codex，点击前往。
  3. 右键 config.toml，用“文本编辑”或 VS Code 打开。可按 Command + Shift + . 显示隐藏文件。
  4. 如果目录或文件不存在，打开 VS Code，选择文件 → 打开文件夹，按 Command + Shift + G，输入 ~ 并打开用户主目录。在左侧资源管理器中新建 .codex 文件夹，再在其中新建 config.toml。

在文件中填写：

config.toml
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
model_provider = "get-codex"

[model_providers.get-codex]
name = "Get-Codex"
base_url = "https://api.get-apikey.com/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "your-api-key"

将 your-api-key 替换为自己的 API Key，按 Command + S 保存。使用“文本编辑”时，先选择格式 → 制作纯文本，文件名保持为 config.toml。

文件已有内容时，先备份并更新同名字段。前三行放在任何 [表名] 之前，同名字段和 Provider 段只保留一份；保留其他 MCP、项目和权限设置。

3. 使用

  1. 打开“终端”，输入 cd （末尾留一个空格），将项目文件夹从 Finder 拖入终端，再按回车。
  2. 运行：
codex
  1. 按提示确认项目，发送 只回复 OK。收到回复后，即可输入编程任务。
macOS 终端中的 Codex CLI，顶部为模型信息，下方为任务输入框。

继续项目中的旧会话时，在同一个项目文件夹运行：

codex resume

Linux CLI 使用同样的安装和命令；配置文件位于 ~/.codex/config.toml。

配置字段说明

model_provider 填写 get-codex，对应配置段为 [model_providers.get-codex]；name 填写显示名称 Get-Codex。App 与 CLI 在同一系统用户和 CODEX_HOME 下共用配置。如果设置了 CODEX_HOME，配置文件位于该目录中的 config.toml。

字段含义
model使用的模型，本例为 gpt-5.6-sol
model_reasoning_effort推理强度，high 表示高
model_provider要使用的连接配置 ID，必须对应下方段名
name界面显示名称，填写 Get-Codex
base_urlAPI 地址，保留末尾的 /v1
wire_api使用 Responses 接口，填写 responses
requires_openai_auth认证兼容选项，填写 true
experimental_bearer_token你的 API Key

旧会话未显示

  1. 确认当前系统用户、项目文件夹和 CODEX_HOME 与创建会话时相同。
  2. 在 App 中检查项目筛选、搜索和归档；CLI 回到会话所在项目后运行 codex resume。
  3. 仍找不到时，保留 .codex 目录中的文件，联系支持并提供系统、客户端版本和问题描述。

API Key 使用总览

创建 GetRun API Key，选择模型并完成客户端配置。

Claude Code

按 Windows 或 macOS 步骤安装 Claude Code，手动配置 API 地址和 Key，然后开始使用。

本页内容

Codex AppWindows1. 安装2. 配置3. 使用macOS1. 安装2. 配置3. 使用Codex CLIWindows1. 安装2. 配置3. 使用macOS1. 安装2. 配置3. 使用配置字段说明旧会话未显示