codex-mobile 接入 Big Pickle 免费模型:5 个避坑要点完整指南

原创2026-10-23 00:38:522,160 阅读

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 个坑里栽跟头——读完本文你可以一次配置成功。

codex-mobile 聊天界面:左侧为会话与项目列表,右侧为消息输入框

为什么选择 Big Pickle 免费模型?

  • 完全免费:beta 期间 0 成本,200K 上下文窗口 + 128K 最大输出
  • 免登录也能用:codex-mobile 在无 Codex 登录态时会自动回退到 OpenCode Zen 提供
  • 移动端可用:Termux 跑起来后,手机上直接体验免费模型

先启动项目确认环境正常(详见 README.md):

npx @brutalstrikedevs/codexapp
# 然后打开 http://localhost:18923

codex-mobile 移动端聊天界面:底部输入框可切换模型、Skills 与推理等级

要点一:认准 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,会发现配置完全不生效。解决办法二选一:

  1. 降版本:npm install -g @openai/codex@0.93.0(v0.93.0 对 wire_api = "chat" 的弃用警告可以安全忽略)
  2. 走 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 登录态后这些配置不会被覆盖,只有匿名社区回退状态会被抑制。

要点五:模型菜单加载顺序与"首轮假报错"

两个容易误判的问题:

  1. 模型菜单为空/陈旧:无登录态下,/codex-api/provider-models 才是 Zen 模型的权威来源;Codex 的 model/list 可能返回 Codex 目录行甚至独立失败。codex-mobile 已修复为先拉取 provider 模型(见 opencode-zen-docker-auth-provider-models.md)
  2. 首轮启动报错:认证模式下第一条消息发出时,可能短暂看到 thread ... is not materialized yet; includeTurns is unavailable before first user message——这是瞬时的进行中状态,不是聊天故障,回合会正常完成(桥接层实现见 codexAppServerBridge.ts)
  3. 配置热更新:运行中拷入 auth.json 或切换 Provider 后,桥接层会比对启动配置签名,必要时重启 app-server,避免 Settings 显示 Codex 而输入框还停留在 big-pickle 的不一致现象

快速上手:5 步接入清单

  1. ✅ 启动 codex-mobile:npx @brutalstrikedevs/codexapp
  2. ✅ 确认 Provider:Settings 中选 OpenCode Zen(或留空走免登录回退)
  3. ✅ 有 Key 就填 sk-...;没有 Key 也能用免费模型
  4. ✅ 输入框模型下拉里选中 big-pickle,确认 API 格式为 Chat Completions
  5. ✅ 发一条 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 工作流的话,现在就是最佳时机。

登录后查看全文
codex-mobile