教程文档 / 接入 Codex 配置

接入 Codex 配置

先拿到 API Key，再选择系统、模型和推理档位。页面会在本地生成脚本，帮助你写入 Codex 配置。

1. 创建 API Key进入 API 控制台，创建并复制自己的 key。

2. 生成配置脚本选择系统、模型和推理档位，脚本只在浏览器本地生成。

3. 重启并验证重启 Codex，确认模型和推理档位正常可用。

准备 API Key

打开 https://api.wowfish.me/dashboard。
登录后进入控制台，创建并复制自己的 API Key。
回到本页，把 API Key 填进脚本生成器。输入内容只在你的浏览器本地处理，不会上传到服务器。

如果你想让 Codex 帮你操作，不要把真实 API Key 发到对话里。可以先让它用占位符写配置，最后你自己替换。

生成本机脚本

脚本会创建 .codex 目录，备份旧的 config.toml 和 auth.json，再写入 Wowfish 配置。

API Key

系统

默认模型

推理档位

等待输入 API Key

脚本预览

Windows 下载的是 install-wowfish-codex.ps1，在 PowerShell 里执行；macOS / Linux 下载的是 install-wowfish-codex.sh，先 chmod +x 再运行。

手动配置也可以

不想运行脚本时，手动创建下面两个文件即可。路径里的 ~ 代表你的用户目录；Windows 对应 C:\Users\你的用户名。

`~/.codex/config.toml`

`~/.codex/auth.json`

{
  "OPENAI_API_KEY": "sk-你的真实 API Key"
}

保存后重启 Codex CLI、Codex App 或 IDE 插件，让新配置生效。

验证是否接入成功

打开一个项目目录，重新启动 codex。
让 Codex 回答一个简单问题，确认没有认证错误。
需要高推理任务时，确认使用的模型和推理档位是你刚才选择的值。

gpt-5.5 gpt-5.4 gpt-5.4-mini high / medium / low / minimal

扩展接入：CC-Switch

CC-Switch 适合长期管理多个 AI CLI 配置。你可以把 Wowfish、官方账号和其他服务商都放进去，需要时一键切换。

先安装并启动 CC-Switch。
在本页脚本生成器填入 API Key，点击「一键导入 CC-Switch」。
浏览器询问是否打开 ccswitch:// 时选择允许。
在 CC-Switch 里确认配置，点击应用或启用。

应用类型: codex
名称: Wowfish
Endpoint: https://api.wowfish.me/v1
Homepage: https://api.wowfish.me/dashboard
默认模型: gpt-5.5，也可选择 gpt-5.4 或 gpt-5.4-mini

不要把包含真实 API Key 的 ccswitch:// 链接公开发给别人。它只适合在自己的设备上点击使用。

使用技巧

官方账号和 Wowfish 并用

如果你已经登录 OpenAI 官方账号，又想临时使用 Wowfish，推荐用 CC-Switch 管理两套配置。手动切换时，先退出正在运行的 Codex，再备份 config.toml 和 auth.json。

# macOS / Linux
mv ~/.codex/config.toml ~/.codex/config.toml.openai
mv ~/.codex/auth.json ~/.codex/auth.json.openai

恢复聊天记录

Codex 的聊天记录在本地，切换 provider 后可能像是“不见了”。通常不是记录丢失，而是 provider 名称变了。

model_provider = "wowfish"

[model_providers.wowfish]
name = "wowfish"

用 Codex 做图片任务

图片能力建议做成 Codex Skill：把 SKILL.md、调用脚本和密钥配置分开管理，避免每次重复贴一大段命令。

让 Codex 更稳

把目标、上下文、约束和完成标准一次说清楚。
复杂任务先让 Codex 规划，再开始改文件。
把项目长期规则写进 AGENTS.md。
做完后要求 Codex 跑测试、检查 diff，并说明验证结果。

常见问题

能用 Codex，high 吗？

目前支持 gpt-5.5、gpt-5.4、gpt-5.4-mini 三个模型。每个模型的 high / medium / low / minimal 等推理档位都支持。

脚本会覆盖我原来的配置吗？

会写入新的 config.toml 和 auth.json，但写入前会创建带时间戳的 .bak-YYYYMMDD-HHMMSS 备份。

API Key 安全吗？

页面不会上传 API Key；脚本文件会包含你输入的密钥，只在自己的设备上运行和保存，不要转发给别人。

配置后还是认证失败？

重新复制控制台里的 API Key，确认没有多余空格；再检查 auth.json 里是否是最新 key，最后重启 Codex。

安装维护

运营安装维护联系微信 wowfish1566。本页只修改你电脑上的 Codex 配置，不涉及服务器防火墙、Docker 端口绑定或 Nginx 端口规则，也不会影响 2333/tcp 和 2333/udp。