这篇使用 Codex CLI（终端 Agent）。先按 CC Switch 安装教程 在「应用」页安装 Codex。CC Switch 用来管理配置，实际对话在启动的 Codex 中完成。

先确认模型支持 Responses#

Codex 原生使用 OpenAI Responses。请选择归壹中明确支持 Responses、工具调用与流式输出的模型，并确认密钥分组、余额和额度可用。仅能完成 Chat Completions 的型号，不能据此认定可以原生用于 Codex。

第 1 步：添加归壹供应商#

  1. 1

    在侧栏选 Codex

    进入「直连」，点击「添加供应商」（+），选择「自定义配置」。

  2. 2

    填写名称、地址和密钥

    按下面的表操作。API Key 填你自己的归壹密钥；由 CC Switch 管理配置即可，不需要手动覆盖 Codex 的登录文件。

字段 / 设置填写什么
名称归壹 · Codex
请求地址 / Base URLhttps://univto.com/v1
API KeyYOUR_GUIYI_API_KEY（占位文字，替换成你自己的归壹 API 密钥）
上游格式Responses（原生）
默认模型新手先留空，使用下面模型映射表的第一行
Codex 的请求地址，需要带 /v1
https://univto.com/v1

第 2 步：填写模型映射#

在自定义供应商的「模型映射」表中添加模型。可以先获取模型列表，再按实际支持情况填写；不要凭模型品牌猜测 ID。

模型映射列名怎么填写
菜单显示名自己容易识别的名字，例如「我的归壹模型」
实际请求模型从归壹复制、支持 Responses 的完整模型 ID
上下文窗口（可选）不确定时先留空；确认归壹线路限制后再填写
思考等级（可选）只填写该模型和线路实际支持的等级，不确定时不自定义

第 3 步：保存、切换，并重启#

  1. 1

    点击「添加」并切换

    保存后回到列表，在归壹卡片点击「切换／启用」，确认「使用中」。

  2. 2

    关闭旧终端再打开

    Codex 需要重启以加载供应商和模型列表。关闭正在使用的 Codex 及终端，重新打开终端；仅保存配置或刷新网页不够。

  3. 3

    启动新的 Codex 会话

    在空白测试目录中运行下面的命令。如果此前一直开着 Codex，改完模型映射后也应再次重启。

启动 Codex CLI
codex

第 4 步：发出第一句问候#

进入 Codex 后输入，不需要先写代码
你好，请用一句话介绍自己，不要读取或修改文件。

如果需要选模型，在 Codex 输入 /model，选择刚配置的归壹模型。收到回答后，打开 归壹使用日志，按时间核对模型和扣费。

遇到的情况先检查
模型菜单没更新模型映射是否已保存，是否关闭重开终端并重启 Codex
404 / 接口不存在地址应为 https://univto.com/v1，最终接口 /v1/responses；模型和线路是否支持 Responses
401 / 密钥无效完整归壹密钥是否填对、是否过期或停用
普通 Chat 成功，Codex 失败这是不同协议；应核对 Responses 支持和 Agent 工具能力

CC Switch 总教程

从下载工具到切换供应商。

Claude Code 教程

改用 Messages 时，基础地址也要调整。

接口地址对照

区分 Base URL 与完整请求地址。

本页操作名称依据 CC Switch 官方安装手册 与 添加供应商手册。模型的可用性和实际能力，以归壹当前说明与调用结果为准。