Codex 桌面版 · 快速接入 Agent

Codex 客户端（Codex Desktop）是 OpenAI 的桌面端 AI 编程助手。本教程介绍如何通过 Galaxis 接入 Codex，推荐使用 Galaxis 客户端完成配置。

方式一：galaxis 客户端一键接入（推荐）

Galaxis 客户端可以帮助你完成 Codex 的安装、平台接入和模型切换，省去手动编辑配置文件的步骤。

1. 下载并登录 Galaxis

前往 Galaxis 平台，获取适合你电脑系统的 Galaxis 客户端并安装。首次使用请注册账号，然后登录客户端。

安装后打开 Galaxis。已有账号的用户，输入邮箱或用户名及密码，点击「登录」；首次使用的用户，点击登录按钮下方的「去注册」，按页面提示完成注册后再登录。

2. 安装 Codex 桌面版

进入 Galaxis 首页，找到「Codex 桌面版」卡片。如果尚未安装，按客户端提示完成安装；也可以前往 Codex 官方页面下载。

如果已经安装 Codex，可直接进行下一步。

3. 接入 Galaxis 并选择模型

在 Galaxis 首页找到「Codex 桌面版」卡片，点击右侧的「一键接入」。注意选择「Codex 桌面版」，不要选下方的「Codex 命令行」。

在弹出的「接入 Codex 桌面版」窗口中，先选择需要使用的分组，再选择模型，最后点击底部的「确认接入」。截图以「codex pro」分组和「gpt-6-astra」模型为例；分组、倍率和可用模型以客户端实时显示为准。Galaxis 会先备份原配置，再完成接入配置。

接入成功后，卡片会显示「已接入」和「当前模型」。如需切换模型，点击「换模型」，选择目标模型并确认即可。可用模型以 Galaxis 客户端实时显示的列表为准。

4. 打开 Codex 开始使用

看到「接入成功」提示后，请按以下顺序操作，让 Codex 加载最新的配置信息：

完全退出 Codex：如果 Codex 已经打开，请先退出应用，不要只关闭窗口。macOS 可在 Codex 中按 Command + Q；Windows 请退出所有 Codex 窗口，如托盘中仍有 Codex 图标，也请退出。
重新打开 Codex：回到 Galaxis，点击接入成功弹窗中的「打开应用」；如果已关闭弹窗，就在首页「Codex 桌面版」卡片中点击「打开」。重新启动后，Codex 才会加载最新配置。

选择本地项目，创建一个新对话并发送简单任务。收到正常回复后，即可开始使用。

5. 查看用量或断开接入

在 Galaxis 客户端点击「记录」，或进入 Galaxis 平台查看请求记录与用量。

如需停止使用 Galaxis 接入，点击「Codex 桌面版」卡片中的「断开」。若要使用 OpenAI 官方订阅，请断开后重新打开 Codex，并按 Codex 提示登录官方账号。

方式二：手动配置（不推荐）

如果不使用 Galaxis 客户端，也可以手动安装 Codex 并配置 Galaxis。此方式需要自己维护配置文件和 API Key，建议有相关经验的用户使用。

1. 下载 Codex

前往 Codex 官方页面，根据系统选择对应的版本并完成安装。已安装的用户可以跳过这一步。系统支持情况以官方下载页面为准。

2. 获取 Galaxis API Key

平台配置 URL：

https://galaxisrouter.cn/v1

3. 修改配置文件

先完全退出 Codex。找到以下文件；如果不存在，请创建对应目录和文件。

系统	配置文件位置
macOS	`~/.codex/config.toml`
Windows	`%USERPROFILE%\.codex\config.toml`

如已存在配置，请先备份，再合并以下设置。顶层的 model_provider、model 和 model_reasoning_effort 应放在第一个 [表名] 之前；同名配置项不要重复添加。若设置了自定义 CODEX_HOME，请修改该目录下的 config.toml。

model_provider = "galaxis"
model = "gpt-6-astra"
model_reasoning_effort = "high"

[model_providers.galaxis]
name = "galaxis"
base_url = "https://galaxisrouter.cn/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

gpt-6-astra 是本教程的模型示例，请按 Galaxis 平台实际提供且你的账号可用的模型 ID 填写。不同模型支持的推理强度可能不同，如不支持 high，请按该模型说明调整或移除 model_reasoning_effort。

4. 设置 API Key

将以下命令中的 你的-Galaxis-API-Key 替换为你在 Galaxis 创建的 API Key。不要把真实 Key 发给他人或放入公开文档。

macOS 用户

打开「终端」，执行：

export OPENAI_API_KEY='你的-Galaxis-API-Key'
launchctl setenv OPENAI_API_KEY "$OPENAI_API_KEY"

然后完全退出 Codex，再从「应用程序」中重新打开。launchctl setenv 用于让当前登录会话中新启动的桌面应用读取这个变量；注销或重启电脑后需要重新设置。

仅在终端中执行 export 或写入 ~/.zshrc，不保证从 Dock 或访达启动的桌面应用能读取到变量，因此更推荐使用 Galaxis 客户端接入。

Windows 用户

打开 PowerShell，执行：

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的-Galaxis-API-Key", "User")

保存后完全退出 Codex 并重新打开。如果仍提示找不到 API Key，请注销 Windows 账号后重新登录再打开 Codex，确保应用获得新的用户环境变量。

5. 启动并验证

打开 Codex，选择一个本地项目，新建对话并发送简单任务。随后在 Galaxis 平台查看是否产生对应的请求记录。

提示 API Key 无效：检查 Key 是否来自 Galaxis、是否完整，以及环境变量是否生效。
提示模型不存在或无权限：核对 model 是否为平台提供且当前账号可用的模型 ID。
提示额度不足：进入 Galaxis 平台查看账户额度。
修改后仍使用旧配置：确认编辑的是当前 CODEX_HOME 对应的配置，并完全退出 Codex 后重新打开。

进入 Galaxis 平台