Dev Resource | 安装指南

先看这里先安装软件，再进入 Tailscale，最后配置 Codex。中国区设备不执行在线安装命令；账号和密钥从账号与密钥页面读取。

本地资源

先下载页面里的安装包

所有安装包从本页下载。NAS 资源地址：10.0.0.78，SMB 路径：smb://10.0.0.78/web。没有对应系统的本地包时，停止安装并联系管理员补包。

PKGTailscale / macOS私有网络客户端下载 EXETailscale / Windows私有网络客户端下载 DMGCodex App / macOS团队提供的本地包下载 7ZCodex App / Windows解压后注册使用下载

系统安装

按系统完成本地安装

MACOS

Mac

下载 Tailscale `.pkg` 并双击安装。
下载 Codex `.dmg`。
打开 DMG，将 Codex 拖入“应用程序”。
保留原始安装包作为同版本备份。

安装过程不打开在线更新或在线安装提示。

WINDOWS

Windows

下载 Tailscale `.exe` 并运行安装程序。
下载本页的 `Codex Win.7z`。
如果系统不能解压 7z，先安装 7-Zip。
解压到 `C:\Codex\OpenAI.Codex_26.730.8199.0_x64__2p2nqsd0c76g0`，不要移动或删除其中的文件。

完成解压后，按下方“Windows 注册”步骤注册 Codex。

LINUX

Linux

当前没有 Linux Codex 本地包。
不要执行在线安装脚本。
向管理员申请离线包。
拿到包后再按 Linux 版本补充步骤。

没有离线包时不要继续。

Windows 注册 Codex App

PowerShell

打开 PowerShell，把下面整段命令粘贴并执行。路径必须与实际解压目录一致。

$CodexRoot = "C:\Codex\OpenAI.Codex_26.730.8199.0_x64__2p2nqsd0c76g0"
Add-AppxPackage -Register -DisableDevelopmentMode "$CodexRoot\AppxManifest.xml"

注册成功后，从开始菜单打开 Codex；如果没有开始菜单项，直接运行 $CodexRoot\app\ChatGPT.exe。

如果已经安装 Codex App

打开 Codex App，确认程序可以启动。
不要重新下载或安装 Codex App。
继续进入第 03 节，安装并登录 Tailscale。
完成 Tailscale 后，完全退出 Codex App，再进入第 05 节配置。

已有配置时先备份

Mac / Linux 终端

mkdir -p "$HOME/.codex"
cp "$HOME/.codex/config.toml" "$HOME/.codex/config.toml.bak.$(date +%Y%m%d%H%M%S)" 2>/dev/null || true

已有配置时先备份

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
if (Test-Path "$HOME\.codex\config.toml") { Copy-Item "$HOME\.codex\config.toml" "$HOME\.codex\config.toml.bak" -Force }

没有旧的 config.toml 时，备份命令只会创建配置目录，不会报错。备份完成后按第 03、04、05 节继续。

Tailscale

安装并加入团队网络

01读取登录资料

打开“账号与密钥” → 解锁 → Tailscale

账号和密码只从加密页面获取。

02安装并登录 Tailscale

从本页下载对应系统的 Tailscale 离线安装包。
安装后打开 Tailscale App。
使用加密页面中的账号登录团队网络。
在 Tailscale 设备列表中看到当前设备，即表示接入完成。

Codex App

启动桌面 App

主要使用

Codex App

本指南只使用 Codex App。Mac 打开“应用程序”中的 Codex；Windows 打开解压后的 Codex 程序。

配置工具

终端命令

终端只用于创建 config.toml。不需要另外安装 Codex CLI。

连接顺序

Tailscale → App

先在 Tailscale 设备列表确认当前设备，再打开 Codex App。修改配置后完全退出并重新打开 App。

自定义模型登录

创建 APImode 配置并登录

这一步把 Codex App 指向团队 API 服务。模型名、API 地址和配置参数已经写好，用户只需要在 App 内输入 API key。

开始前先完成

已安装 Codex App，但先完全退出 Codex App。
已安装并登录 Tailscale，且在设备列表中看到当前设备。
已从“账号与密钥”页面取得 Codex 虚拟密钥。

本步骤不需要安装 Codex CLI，也不需要先打开 Codex App。除 API key 外，不需要填写其他配置。

第 0 步：打开正确的终端Mac 打开“应用程序”→“实用工具”→“终端”。Linux 打开系统自带的 Terminal。Windows 不执行下面的命令，使用下方的 PowerShell 区块。

第 1 步：Mac / Linux 创建 config.toml

~/.codex/config.toml

打开终端，将下面整段命令粘贴并执行。

MODEL="gpt-5.6-sol"
BASE_URL="http://100.69.66.78:4000/v1"
mkdir -p "$HOME/.codex"
cat > "$HOME/.codex/config.toml" <<EOF
model = "$MODEL"
model_provider = "toronto_gateway"
model_reasoning_effort = "medium"

[model_providers.toronto_gateway]
name = "Toronto Mac mini"
base_url = "$BASE_URL"
wire_api = "responses"
requires_openai_auth = true
EOF

这段命令中的模型名、API 地址和配置参数已经固定，不需要修改；API key 留到 App 登录界面输入。

第 1 步：Windows PowerShell 创建 config.toml

$HOME\.codex\config.toml

打开 Windows PowerShell，将下面整段命令粘贴并执行。

$MODEL = "gpt-5.6-sol"
$BASE_URL = "http://100.69.66.78:4000/v1"
New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
@"
model = "$MODEL"
model_provider = "toronto_gateway"
model_reasoning_effort = "medium"

[model_providers.toronto_gateway]
name = "Toronto Mac mini"
base_url = "$BASE_URL"
wire_api = "responses"
requires_openai_auth = true
"@ | Set-Content -Encoding utf8 "$HOME\.codex\config.toml"

这段命令中的模型名、API 地址和配置参数已经固定，不需要修改；API key 留到 App 登录界面输入。

02打开 Codex App

完全退出后重新打开 Codex App

App 会读取刚刚创建的 config.toml。修改配置后必须重新打开 App。

03选择 API 登录

Other ways to sign in → API key

在登录界面选择 “Other ways to sign in”，再选择 “API key”。

04输入 Codex 虚拟密钥

粘贴账号与密钥页面中的 Codex 虚拟密钥

密钥只在 App 登录界面输入，不写进 config.toml。

验证

按顺序验证安装和登录

01安装验证

打开 Codex App

确认 App 能正常打开。

02配置验证

Mac / Linux

Terminal

grep -E '^(model_provider|requires_openai_auth)' "$HOME/.codex/config.toml"

输出中应同时出现 model_provider = "toronto_gateway" 和 requires_openai_auth = true。

Windows

PowerShell

Select-String -Path "$HOME\.codex\config.toml" -Pattern 'model_provider = "toronto_gateway"','requires_openai_auth = true'

输出中应同时出现这两项配置。两套命令只执行与你的系统对应的一套。

03App 连接验证

新建会话 → 发送：请回复“连接正常”

在 Codex App 内新建会话并发送测试消息；能收到回复，即表示配置和 API 登录生效。

排错

失败时先确定卡在哪一步

本地包打不开

检查文件完整性、扩展名和解压结果。不要用在线安装器替代。

Tailscale 不在线

检查客户端、登录账号、系统权限和团队网络状态。

没有 Other ways to sign in

确认选择的是 TorontoGptAuth（APImode），并确认 provider 中存在 requires_openai_auth = true，然后完全退出并重新打开 Codex App。

登录后请求失败

重新确认 Tailscale、模型名、API 服务地址和虚拟密钥。

敏感资料位置

API 密钥、账号和密码统一放在“账号与密钥”页面的加密资料中。安装指南只保存配置格式和操作步骤。

模式切换

创建并使用 codex-model

Mac / Linux：先创建命令在终端执行下面整段命令。它会下载本页提供的无密钥脚本，创建 codex-model 命令并加入当前用户的命令路径。

mkdir -p "$HOME/.local/bin"
curl -fsSL "https://resource.casa/resources/codex-model" -o "$HOME/.local/bin/codex-model"
chmod +x "$HOME/.local/bin/codex-model"
printf '\nexport PATH="$HOME/.local/bin:$PATH"\n' >> "$HOME/.zshrc"
export PATH="$HOME/.local/bin:$PATH"

脚本不包含 API key，只负责修改本机的 config.toml。

01运行模式选择器

codex-model

在终端运行后，输入 1 选择 APImode，输入 2 选择 OpenAI 正常模式。

02重新打开 Codex App

退出 Codex App → 重新打开

模式切换写入配置后，完全退出并重新打开 App 才会生效。

聊天记录互不干扰APImode 和正常模式使用不同的模型服务与登录状态。切换模式不会合并、删除或改写另一种模式的聊天记录；两种模式的聊天内容彼此独立。