MAC 配置指南 · 本地 WORK / CODEX

官方 ChatGPT Mac 应用
接入家庭中转

在自己的 Mac 上配置模型提供商,再新建本地 Work/Codex 任务验证。无需安装 Chatbox 或 Open WebUI。

下载 Markdown 说明 ↓更新于 2026-09-18

先备份,再领取专用密钥

向管理员私下领取专用客户端密钥。它不是 ChatGPT 密码,也不是上游登录文件;不要发到聊天、截图或共享文档中。

在使用者的 Mac 上,备份 ~/.codex/config.toml 和已有的 ~/.codex/.env。如果设置了自定义 CODEX_HOME,以该配置目录为准。备份可能含有秘密,也应仅由本人保管。

模型接口认证与应用自身账户登录是两件事。更换模型提供商不会替代应用登录,也不代表获得全部 ChatGPT Pro 功能或独立额度。

合并模型配置

用文本编辑器打开 ~/.codex/config.toml,合并以下内容;文件不存在时可创建。保留其他设置,不要覆盖整个文件。

config.toml
model = "gpt-5.6-luna"
model_provider = "family_proxy"

[model_providers.family_proxy]
name = "Family proxy"
base_url = "https://proxy.rick1.fun/v1"
wire_api = "responses"
supports_websockets = false
env_key = "FAMILY_PROXY_API_KEY"

已有同名键时修改原值,不要重复追加。顶层 model、model_provider 应放在所有 TOML 表([ ... ])之前;已有 [model_providers.family_proxy] 时合并该表。

先使用 HTTP Responses 流式,因此明确设置 supports_websockets = false。保留 HTTPS 域名地址,不要改成裸 IP 或关闭证书校验。

仅在自己的 Mac 上保存密钥

桌面应用可能不继承终端环境变量。在 ~/.codex/.env 中添加或更新以下一行,并保留其他设置:

.env · 下方仅为占位符
FAMILY_PROXY_API_KEY=REPLACE_WITH_YOUR_CLIENT_KEY

必须将 REPLACE_WITH_YOUR_CLIENT_KEY 替换为管理员私下提供的专用密钥。不要填 ChatGPT 密码,不要复制整个 JSON 或 Bearer 前缀。

保存后在终端执行,使文件仅由本人读写。自定义 CODEX_HOME 时,改用实际 .env 路径:

终端
chmod 600 ~/.codex/.env

本页和下载文件都不包含真实密钥。配置好密钥后,不要将 .env 一并分享。

重启应用,新建本地任务验证

  1. 彻底退出官方 ChatGPT 应用,再重新打开。
  2. 选择 Work 或 Codex,新建在本机运行的任务;不要用旧任务的回复代替新配置验证。
  3. 确认模型为 gpt-5.6-luna,提供商为 family_proxy。若界面不显示提供商,请管理员结合不含秘密的客户端日志与中转请求记录确认;回答成功本身不能证明走了中转。
  4. 发送“只回答结果:17 + 26 等于多少?”,确认回答为 43,并观察流式输出正常结束。
  5. 在同一任务中继续追问,再单独验证较长对话及需要使用的其他能力。

哪些已验证,哪些还要测试

项目当前状态
HTTPS API、鉴权、短文本与 Responses 流式请求已通过 API 层验收
官方 Mac 应用读取配置并完成真实对话端到端待验收
实际使用者的设备与网络待验收
长对话、上下文压缩(compact)待验收;当前未开放 /v1/responses/compact
WebSocket、图片、文件、语音等能力未验收

当前开放 GET /v1/models、POST /v1/chat/completions 和 POST /v1/responses。若客户端需要其他接口,请管理员根据实际请求核验后处理,不要自行扩大开放范围。

服务器不需要运行 Open WebUI 才能提供这个 API;本方案不使用 WebUI 登录。

遇到问题时

官方参考与适用边界

第一份文档以 Bedrock 为例;这里仅引用其对桌面客户端、本地配置及验证范围的说明,不将其服务商能力表套用到本中转。本文结合通用自定义提供商配置,实际兼容性仍以官方应用的端到端测试为准。