Codex 接入用户手册

创建密钥，连接 FocusAI，开始使用 Codex。

新手图解版 · 更新于 2026 年 10 月 31 日

按本手册完成密钥创建、CC Switch 配置、启用和重启，即可在 Codex 客户端使用 FocusAI。每幅图的红框数字对应紧邻图片的操作说明；数字在每幅图内重新开始。

开始前准备好这三项

1　FocusAI 账号可以登录，钱包中有可用余额或额度。API Key 是访问密钥，不是登录密码。

2　Codex 客户端已经安装，且能打开。如果尚未安装，先打开下方官方入口，选择你的操作系统并按页面指引安装、完成首次启动。

3　本手册使用 Codex 桌面客户端。配置阶段无需打开终端，也无需执行命令。

本手册用到的全部网址

FocusAI 首页与登录入口https://focus-ai.top（新窗口打开）

API 密钥页面（登录后打开）https://focus-ai.top/keys（新窗口打开）

钱包页面（查看可用额度）https://focus-ai.top/wallet（新窗口打开）

CC Switch 下载页面https://ccswitch.io/zh/download（新窗口打开）

Codex 官方安装指引https://learn.chatgpt.com/docs/app（新窗口打开）

使用日志（最后验证用）https://focus-ai.top/usage-logs/common（新窗口打开）

填写到 CC Switch 的 API 请求地址：

这个地址用于「API 请求地址」输入框，不是登录入口。不要填到「官网链接」，不要追加 /responses、/models 或控制台路径。

操作顺序：创建密钥 → 下载 CC Switch → 添加供应商 → 填写信息 → 选择模型 → 启用 → 开启历史开关 → 重启验证。

界面截图以 macOS 上的 CC Switch 4.0.19 为例。不同版本的按钮位置可能略有变化，请按按钮名称操作。官方安装页当前标题可能显示 ChatGPT desktop app；使用其中的 Codex 工作区。

1 在 FocusAI 创建并复制密钥

打开密钥页面https://focus-ai.top/keys（新窗口打开）

若出现登录页，先用自己的 FocusAI 账号登录，再打开上面的地址。

图 1：① 确认左侧为「API 密钥」；② 点击「创建 API 密钥」；③ 完成下方表单保存后，回到列表点击新密钥右侧的复制图标。

图 2：① 名称填写「Codex 新手手册演示」（也可自定义）；② 分组选择 default，其他项目保持默认；③ 点击「保存更改」。

返回列表后应显示「已启用」。点击图 1 的 ③ 复制完整密钥，在第 4 步粘贴。不要复制带星号的显示文本，也不要照抄演示密钥。「无限配额」不代表免费或账户有无限余额。

2 下载并安装 CC Switch

下载地址https://ccswitch.io/zh/download（新窗口打开）

进入下载页后找到「全部平台」。图 3 以 macOS 为例；Windows 和 Linux 用户先切换到自己的平台。

① 选择与你的电脑一致的平台。② 点击对应安装包；macOS 选择 .dmg 区域的 Universal。

不确定 Windows 架构：在「设置 → 系统 → 系统信息（或关于）」查看「系统类型」。Intel / AMD 64 位电脑选 x64，ARM 电脑选 ARM64。

已有 CC Switch 可直接打开。若下载按钮被浏览器拦截，可点击下载页底部「前往 GitHub Releases」，选择相同平台的安装包。

完成标志：能看到 CC Switch 主窗口。

3 在 CC Switch 中配置 Codex

打开 CC Switch，在左侧选择「Codex」配置空间。本步骤及后续第 4～7 步均在 CC Switch 中操作；完成配置后，第 8 步再重启 Codex 客户端。

①　在 CC Switch 窗口左侧点击「Codex」，进入 Codex 的配置空间。

②　选择顶部「直连」。如果已经选中，保持不变。

③　点击右上角「添加供应商」。首次使用时中间没有供应商卡片也正常，入口位置相同。

图 5 的 ①：点击「自定义配置」，进入下一步的填写表单。无需选择其他预设。

本手册只使用一个 FocusAI 供应商和一个模型。已经存在的其他供应商不需要删除。

4 填写信息并获取模型

「备注」「官网链接」留空；其他项目保持默认。下方若还看到 config.toml，同样无需手工修改。

看到旧的「默认模型」行先不用改，下一步从接口获取模型后统一精简。此时先不要点击右下角「添加」。

5 选择模型并保存

在弹出的「选择模型」窗口中：点击「全不选」→ 搜索 gpt-6.1-sol → 勾选 gpt-6.1-sol → 确认已选 1 个 → 点击右下角「应用」。

返回表单后，按图 7 检查。获取过模型后，原来的「获取模型列表」按钮可能显示为「选择模型」，这是正常状态。

①　如果仍有 gpt-5.6-sol 等不需要的预置行，点击那一行最右侧的垃圾桶删除。红框 ① 横跨整行，垃圾桶就在其最右侧。

②　保留 gpt-6.1-sol；「菜单显示名」与「实际请求模型」都应为这个名称。最终列表只剩这一行，第一行就是默认模型。

③　确认后点击右下角橙色「添加」，保存供应商。若你是编辑已有卡片，该按钮名称是「保存」。

只删除多余模型行，不删除供应商，不删除最后一个模型。「上下文窗口」「思考等级」「子代理模型」「自动审批模型」及高级选项均保持默认。

找不到 gpt-6.1-sol 时，先检查 URL、密钥状态与分组，联系 FocusAI 管理员确认模型权限；不要凭空填写一个未返回的模型名称。

6 启用 FocusAI 供应商

保存后回到 Codex 供应商列表，找到名称为 FocusAI、地址为 https://focus-ai.top/v1 的卡片。

① 核对卡片名称与地址。② 点击三角形「切换」按钮；旁边的铅笔是编辑，不是启用。

①　顶部应显示「直连 · FocusAI」。

②　FocusAI 卡片右侧应显示「使用中」。只保存、未切换时还不算启用。

③　黄色提示要求完全退出并重开 Codex。先完成下一步的历史开关设置，再按第 8 步重启。

完成标志：顶部供应商名称和卡片「使用中」同时正确。

7 开启统一 Codex 会话历史

点击 CC Switch 左下角齿轮「设置」，再按图 10 操作。

①　点击左侧「应用配置」。

②　找到「Codex」区域中的「统一 Codex 会话历史」，将右侧开关打开。橙色、圆点在右侧表示开启；已经开启则不再点击。

这不是上方 Claude Code 的开关，也不是下方「压缩 Codex 历史会话」。其他开关和配置目录保持原样。

首次使用没有旧会话，无需执行迁移操作。设置中的目录是你电脑上的实际路径，不要照抄截图里的 /Users/novice/...。

完成标志：「统一 Codex 会话历史」保持开启。随后进入第 8 步，完全退出并重开 Codex。

8 重启 Codex 并完成验证

先保存正在进行的工作。重启的对象是 Codex 客户端，不是电脑，也不是只重开 CC Switch。

用一条消息确认连接

1　重新打开后进入 Codex，创建新会话；在输入框附近的模型选择器中选择 gpt-6.1-sol。使用新会话验证，避免旧会话仍保留原模型。

2　在 Codex 的聊天输入框发送下面这句话。这是一条聊天消息，不是终端命令：

请只回复「连接成功」，不要读取文件或执行命令。

3　收到正常回复后，打开 FocusAI 使用日志，刷新并确认出现对应时间、模型的成功调用记录。消息测试会正常计费。

使用日志地址https://focus-ai.top/usage-logs/common（新窗口打开）

完成标志：模型可选、聊天能回复、FocusAI 日志有对应成功调用。仅显示「使用中」或仅获取到模型列表，不能替代这一验证。

遇到问题按现象检查