Codex + TrueSOTA 接入指南

AI新手教学
1

:one: 准备工作

在开始之前，请确认以下信息：

  • 操作系统：Windows 11（推荐）或 macOS 12+
  • 网络环境：可正常访问 https://true-sota.com（国内直连）
  • 权限：Windows 用户需管理员权限，Mac 用户需 sudo 权限
  • 账号：已在 TrueSOTA 完成注册（下文详述）

:two: 获取 TrueSOTA API Key

:warning: 这是登录 Codex 的唯一凭证，请妥善保管！

  1. 浏览器打开： TrueSOTA - AI API Gateway
  2. 使用邮箱注册并登录（支持 Linux.do 一键登录）
  3. 进入「API Keys」页面 → 点击「创建 API Key」
    1. 1280×720 125 KB
  4. 复制并保存这串以 sk- 开头的密钥，禁止截图、禁止上传至任何代码仓库

:three: 下载安装 CC Switch（代理管理工具）

CC Switch 是连接 Codex 与 TrueSOTA 的桥梁，用于管理 API 路由和模型切换。

  1. 访问内部镜像站（或 GitHub 发布页）： Releases · farion1231/cc-switch · GitHub
  2. 下载对应安装包：
    1. Windows：CC-Switch-vX.X.X-Windows.msi
    2. macOS：CC-Switch-vX.X.X-mac.dmg
  3. 双击安装，一路「Next」（Windows）或拖入 Applications（Mac）
    1. 1280×804 73.5 KB
  4. 确认版本号 ≥ 3.16.2（点击「帮助」→「关于」查看）

:four: 下载安装 Codex 桌面版（Windows）

Windows 用户推荐以下两种方式：

方式一：Microsoft Store（推荐）

  1. 打开「Microsoft Store」（微软商店）
  2. 搜索「Codex」
  3. 核对发布者为 OpenAI，点击「获取」或「安装」
  4. 等待下载完成

方式二：官网引导安装

  1. 访问 OpenAI 官方下载页：https://openai.com/codex
  2. 点击 Windows 版本下载按钮，会下载一个约 1.3MB 的引导程序
  3. 双击运行，它会自动唤起 Microsoft Store 完成安装

1280×719 62.6 KB

:light_bulb: 避坑：如果商店搜不到 Codex，按 Win+I 打开设置 →「时间和语言」→ 把「地区」切换为美国，重新打开商店即可。

:five: 配置 CC Switch 对接 TrueSOTA（核心！）

这一步是让 Codex 通过 TrueSOTA 进行认证和模型调用的关键，请仔细操作。

第一步：添加 TrueSOTA 供应商

  1. 打开 CC Switch
  2. 点击顶部「Codex」标签
  3. 点击右上角「+」按钮
  4. 在弹出的配置界面中：
    1. 供应商名称：填写 TrueSOTA
    2. API Key：粘贴第 2 步获取的 sk- 密钥
    3. Base URL：填入 https://true-sota.com/v1（若失败可尝试去掉 /v1）
  5. 其他参数保持默认，点击「保存」

1280×853 158 KB

1280×720 127 KB

第二步：开启本地路由（极易遗漏！）

:warning: 不开路由，Codex 永远连不上 TrueSOTA！

  1. CC Switch →「设置」→「路由」→「本地路由」
  2. 打开「路由总开关」（地址 127.0.0.1:15721）
  3. 「路由启用」中勾选「Codex」

1280×853 89 KB

  1. 确认状态显示「运行中」

▲ 必须打开「路由总开关」并勾选 Codex

第三步：启用 TrueSOTA 并重启 Codex

  1. 回到 CC Switch 的 Codex 标签页
  2. 找到刚刚创建的 TrueSOTA 配置，点击「启用」
  3. 完全关闭 Codex（包括系统托盘进程），重新打开

:six: 修改 config.toml 配置文件（Windows）

打开文件管理器，访问路径：

C:\Users\你的用户名\.codex\config.toml

用记事本打开，修改 model 字段为 TrueSOTA 支持的模型名称（如 deepseek-v4-pro 或 gpt-4，请以 TrueSOTA 官方列表为准）：

# 原默认值（可能报错）
model = "gpt-5.6-sol"

# 推荐使用（二选一，TrueSOTA 均支持）
model = "deepseek-v4-pro"      # 编码能力强，推荐
model = "deepseek-v4-flash"    # 速度更快

确认 base_url 指向本地代理（CC Switch 路由地址）：

[model_providers.custom]
base_url = "http://127.0.0.1:15721/v1"

▲ 修改 config.toml 中的 model 字段

:light_bulb: 保存后 必须重启 Codex 才能生效。

:pushpin: 若使用 Mac，配置文件路径为 ~/.codex/config.toml，内容完全相同。

:seven: 使用 Codex CLI（命令行版）

桌面版已内置 CLI，无需额外下载。

  • 打开 PowerShell（Windows）或 Terminal（Mac）
  • 启动 Codex CLI
codex
  • 验证安装
codex --version
codex --help
  • 试用
codex
> 用中文写一个 Python 程序，计算 1 到 100 的和

▲ 直接输入问题即可

:warning: 启动前务必确保 CC Switch 已打开且本地路由已开启，否则会连接失败。

:eight: 让 Codex 操作你的电脑（权限配置）

默认 Codex 较为保守，需手动授予文件读写和命令执行权限。

打开 C:\Users\你的用户名\.codex\config.toml（Mac 同路径），添加以下内容：

[windows]   # Mac 下对应 [darwin]，但字段类似
# elevated: 独立低权限沙箱用户（推荐）
sandbox = "elevated"

# 允许操作的目录
read_roots = ["C:\\Users\\你的用户名"]   # Mac 改为 ["/Users/你的用户名"]
write_roots = ["C:\\Users\\你的用户名"]

# 允许的工具权限
allow_shell = true
allow_file_read = true
allow_file_write = true
allow_command_run = true

▲ 添加权限配置

:warning: 安全提示（内部必读）：

  • 请将「你的用户名」替换为实际用户名
  • 开启后 Codex 可读写整个用户目录，切勿执行不可信指令
  • 首次操作时 Codex 仍会弹出确认框，请仔细核对

:nine: Mac 用户补充说明

若您使用 macOS，请参照以下简版流程：

  1. 安装 Codex（任选其一） 
    1. brew install --cask codex
# 或 curl -fsSL https://chatgpt.com/codex/install.sh | sh
  2. 配置 CC Switch：同 Windows 第 5 步，供应商和路由设置完全一致。
  3. 配置文件位置：~/.codex/config.toml，内容与 Windows 相同（路径格式改为 Unix 风格）。
  4. 登录验证：执行 codex login，Codex 会读取配置文件中的 API Key（通过 CC Switch 代理），无需额外 OAuth 流程。