codex-mobile 接入 Big Pickle 免费模型:5 个避坑要点完整指南
codex-mobile 接入 Big Pickle 免费模型:5 个避坑要点完整指南
codex-mobile(Codex UI / codexapp)是一个让你在 Linux、Windows 或 Android Termux 上通过浏览器运行 Codex 桌面体验的开源 Web 界面项目。Big Pickle 是 OpenCode Zen 在 beta 期间提供的免费隐藏模型(200K 上下文、128K 最大输出)。把 codex-mobile 接入 Big Pickle 免费模型其实不复杂,但新手经常在这 5 个坑里栽跟头——读完本文你可以一次配置成功。
为什么选择 Big Pickle 免费模型?
- 完全免费:beta 期间 0 成本,200K 上下文窗口 + 128K 最大输出
- 免登录也能用:codex-mobile 在无 Codex 登录态时会自动回退到 OpenCode Zen 提供
- 移动端可用:Termux 跑起来后,手机上直接体验免费模型
先启动项目确认环境正常(详见 README.md):
npx @brutalstrikedevs/codexapp
# 然后打开 http://localhost:18923
要点一:认准 Chat Completions,别选错 API 格式
Big Pickle 只支持 /v1/chat/completions,不支持 Responses API(/v1/responses)。 如果请求发错端点,会得到类似 Model big-pickle not supported for format openai 的报错。
- 在 UI 里:Settings 的 Provider 下拉框选 "OpenCode Zen",或选择 Custom endpoint 后把 API format 设为 Chat Completions(而不是默认的 Responses API),保存即可,配置会持久化到
~/.codex/webui-custom-providers.json - 在 Codex CLI 里:
~/.codex/config.toml中wire_api必须是"chat":
[model_providers.opencode-zen]
base_url = "https://opencode.ai/zen/v1"
env_key = "OPENCODE_ZEN_API_KEY"
wire_api = "chat"
更多细节见 opencode-zen-provider-and-wire-api-selector-in-codexui.md。
要点二:Codex CLI 版本太新会导致配置被拒
这是一个隐藏很深的坑:
| Codex CLI 版本 | 能否用 Big Pickle |
|---|---|
v0.93.0(最后支持 wire_api = "chat" 的版本) |
✅ 可以 |
| v0.118.0 及以上 | ❌ 已移除 chat completions 支持 |
如果你直接用新版 Codex CLI 配 Big Pickle,会发现配置完全不生效。解决办法二选一:
- 降版本:
npm install -g @openai/codex@0.93.0(v0.93.0 对wire_api = "chat"的弃用警告可以安全忽略) - 走 codex-mobile 的本地代理(推荐):它内置了 Responses → Chat Completions 的格式转换,你不用关心 CLI 版本。相关实现见 zenProxy.ts 和 unifiedResponsesProxy.ts
背景资料:opencode-zen-big-pickle-codex-cli.md。
要点三:免登录模式会自动回退到 Big Pickle
codex-mobile 的设计是:容器里没有 auth.json 时,OpenCode Zen 只作为运行时回退方案。此时 config/read 会报告 model = "big-pickle",模型菜单里只会出现 big-pickle 和 *-free 免费模型(Android 无登录态下不会出现 GPT/Claude/Gemini 等付费模型)。
注意两条规则:
- 回退状态不会被永久写入配置,补上登录态后会自动退出
- 免费模型走的是公共准入通道:代理会带上
Authorization: Bearer public、OpenCode 客户端 User-Agent 和X-Opencode-*请求头(见 zenProxy.ts)
验证流程可参考 android-opencode-zen-no-auth-model-filtering.md。
要点四:线程"锁定"Provider,切换后别混淆
每个会话(Thread)在创建时就捕获了当时的 Provider,之后不会跟随全局设置变化。典型现象:
- 你先用 Zen 免费模式建了聊天 A(模型是
big-pickle) - 之后把
auth.json拷进CODEX_HOME并重新加载,Provider 升级为 Codex - 此时新建聊天 B 用的是 GPT 模型,但旧聊天 A 的模型菜单依然只有 Zen 模型,发消息也仍然走
big-pickle
这不是 Bug,而是刻意设计:同一个项目里可以共存 Zen、Codex、OpenRouter 三种线程,模型菜单互不串台。行为细节见 thread-locked-providers-across-zen-codex-and-openrouter.md 和 copied-auth-provider-promotion.md。
避坑提示:如果你已经手动配置了 OpenRouter 自定义 Key、或 Zen 显式 API Key,补上 Codex 登录态后这些配置不会被覆盖,只有匿名社区回退状态会被抑制。
要点五:模型菜单加载顺序与"首轮假报错"
两个容易误判的问题:
- 模型菜单为空/陈旧:无登录态下,
/codex-api/provider-models才是 Zen 模型的权威来源;Codex 的model/list可能返回 Codex 目录行甚至独立失败。codex-mobile 已修复为先拉取 provider 模型(见 opencode-zen-docker-auth-provider-models.md) - 首轮启动报错:认证模式下第一条消息发出时,可能短暂看到
thread ... is not materialized yet; includeTurns is unavailable before first user message——这是瞬时的进行中状态,不是聊天故障,回合会正常完成(桥接层实现见 codexAppServerBridge.ts) - 配置热更新:运行中拷入
auth.json或切换 Provider 后,桥接层会比对启动配置签名,必要时重启 app-server,避免 Settings 显示 Codex 而输入框还停留在big-pickle的不一致现象
快速上手:5 步接入清单
- ✅ 启动 codex-mobile:
npx @brutalstrikedevs/codexapp - ✅ 确认 Provider:Settings 中选 OpenCode Zen(或留空走免登录回退)
- ✅ 有 Key 就填
sk-...;没有 Key 也能用免费模型 - ✅ 输入框模型下拉里选中
big-pickle,确认 API 格式为 Chat Completions - ✅ 发一条
hi,看到回复即成功;报not supported for format openai就回去检查要点一
完整概念速查表见 opencode-zen-big-pickle.md,兼容性矩阵涵盖 Codex CLI、OpenCode CLI 和直接 curl 三种调用方式。
总结
| 坑 | 一句话解法 |
|---|---|
| API 格式选错 | 只用 Chat Completions,别碰 Responses |
| Codex CLI 版本太新 | 降到 v0.93.0,或直接用 codex-mobile 内置代理 |
| 不知道免登录也能用 | 无 auth.json 时自动回退 Big Pickle |
| 切换 Provider 后菜单混乱 | 线程创建时锁定 Provider,属正常设计 |
| 菜单空 / 首轮报错 | 信 provider-models;materialized 提示是瞬时状态 |
Big Pickle 目前免费仅限 beta 期,想体验完整移动端 Codex 工作流的话,现在就是最佳时机。

