Codex App
Codex 桌面客户端
Codex 桌面版手动安装配置
自行安装 Codex 桌面版并填写服务配置。Windows 用户也可使用中文助手完成安装与连接。
本页内容
使用平台账户配置
使用项目控制台创建的 Key，API 根地址为
https://gateway.mosshubs.com。在客户端或 CC Switch 中选择自定义服务，按本页填写。已下载的一键助手可能带有原有服务预设；平台配置按本页手动填写，不直接沿用旧服务地址。
1. 安装桌面版
目标电脑系统默认 Windows，可按实际使用的电脑切换
镜像当前版本
- Windows：下载对应 x64 / ARM64 的完整 MSIX，打开后按系统提示安装；系统请求管理员授权时按提示处理。
- Mac：下载对应芯片版本，打开安装文件并按安装提示完成。
- 安装后打开一次桌面应用。开始修改配置前，保存现有工作并完全退出应用。
2. 准备 API Key 与模型
- 打开 网关控制台，登录后进入 API 密钥页面，创建用于 Codex / OpenAI 分组的 Key。
- 复制完整 Key，并确认该 Key 可用的模型 ID，例如 gpt-6-sol。不要使用账户登录密码代替 Key。
3. 编辑桌面版读取的配置
Windows：按 Win+R，输入
%USERPROFILE%\.codex 并回车。Mac：访达 → 前往 → 前往文件夹，输入 ~/.codex。目录不存在时先创建。设置了 CODEX_HOME 时，请使用桌面应用实际读取的该目录。备份已有 config.toml，再用文本编辑器打开；不存在则创建同名文件。已有配置请合并以下字段，避免重复 model、model_provider 或同名表，不要覆盖 MCP、权限和项目设置。
将 YOUR_MODEL_ID 和 YOUR_API_KEY 替换为自己的模型 ID 和完整 Key。API 地址已预填主线路，保留末尾 /v1。
toml
model_provider = "mosshubs-openai"
model = "YOUR_MODEL_ID"
[model_providers.mosshubs-openai]
name = "MossHubs API"
base_url = "https://gateway.mosshubs.com/v1"
wire_api = "responses"
requires_openai_auth = false
experimental_bearer_token = "YOUR_API_KEY"4. 保存并重新打开桌面版
- 保存文件，确认文件名是 config.toml，没有额外的 .txt 后缀。
- 重新打开 Codex 桌面版，进入新任务，核对模型后发送一条简短请求。实际模型请求会按服务额度计费。
- 第三方 Key 位于该 provider 内，保留已有 auth.json 登录文件。原文件若有 profile 默认选择，应同步核对它是否覆盖新配置。
- 配置文件与备份包含 Key，请限制其他账户读取，不要上传或发送给他人。