资讯动态

免登录也能跑:codex-mobile Free Mode 免费接入 OpenRouter 模型的实战教程

发布时间:2026/10/23 4:33:34 来源:尧图企业网站定制
【免费下载链接】codex-mobile Run Codex Mobile Anywhere: Linux, Windows, or Termux on Android 项目地址https://gitcode.com/gh_mirrors/co/codex-mobile点击查看免费下载codex-mobile是一款可以在 Linux、Windows 或 Android Termux 上运行的 Codex 网页版客户端。它的Free Mode免费模式让你无需登录 Codex 账号、无需 OpenAI API Key就能直接接入OpenRouter 的免费模型开始对话。本文是一份面向新手的完整实战教程从一条命令启动项目到在设置里切换 OpenRouter 提供方、绑定自己的 API Key最后用真实对话验证效果。为什么 Free Mode 可以免登录运行在动手之前先花一分钟了解 Free Mode 的底层机制你就能明白它为什么免费又省心社区共享 Key 池codex-mobile 内置了一批经过 XOR 加密的 OpenRouter 社区 Key源码见 freeMode.ts每次请求随机轮换其中一把避免单把 Key 被限流卡死。默认模型openrouter/free这是 OpenRouter 的元模型会自动把请求路由到当前负载最低的免费模型gemma、llama、qwen 等从而绕开单个模型的限流。配置完全隔离Free Mode 的状态保存在~/.codex/webui-custom-providers.json通过-c参数传给 app-server永远不会修改你的~/.codex/config.toml不会影响 Codex 桌面版的正常使用。第一步一条命令免登录启动 codex-mobile前置要求Node.js 18并已安装 Codex CLI需在 PATH 中可用。Linux / WindowsPowerShellnpx brutalstrikedevs/codexapp --no-login--no-login参数会跳过启动时的 Codex 账号登录引导CLI 定义见 cli/index.ts这是免登录体验的关键。Android Termuxpkg update pkg upgrade -y pkg install nodejs -y npx brutalstrikedevs/codexapp --no-login Android 后台小贴士保持 Termux 会话不要关闭、关闭 Termux 的电池优化、开启 Termux 常驻通知还可以执行termux-wake-lock防止进程被杀。启动后浏览器打开终端打印的地址默认http://localhost:5999端口被占用时自动顺延即可进入界面。第二步在设置面板切换到 OpenRouter 提供方早期的 Free Mode 是一个独立的开关现在它已经整合进设置面板的Provider提供方下拉框演进过程见 provider-dropdown-in-settings-replaces-free-mode-toggle.md操作只需三步点击侧边栏底部的⚙️ Settings打开设置面板找到Provider下拉框默认是Codex展开后选择OpenRouter切换后 app-server 会自动重启模型下拉框随之变化。验证是否生效的两个信号模型下拉框默认变为openrouter/free下拉框里只出现免费模型gemma、llama、qwen 等带:free后缀的模型GPT 系列默认模型不再显示。第三步可选绑定你自己的 OpenRouter API Key社区 Key 池在高峰时段可能被限流429 错误。如果你有自己的 OpenRouter Key强烈建议绑定稳定性会更好选择 OpenRouter 提供方后设置面板会展开OpenRouter API key输入框旁边还有一个 Get API key 链接输入你的sk-or-v1-...Key点击Set或按回车保存保存成功后输入框会显示脱敏的 Key 片段点击 ✕ 即可清空并回退到社区 Key。整个交互逻辑位于 App.vue 的设置面板区域行为约定在 freeMode.test.ts 中有完整覆盖当你已经登录了 Codex 账号且没有填自定义 Key 时社区 Key 兜底会被自动抑制优先走你的 Codex 登录态。第四步发一条消息验证免费模型真的能跑新建一个线程输入Say hello之类的简单指令发送。正常情况下免费模型几秒内就会回复。如果运气不好遇到限流默认模型openrouter/free会自动换路由到负载更低的免费模型多数情况下重试即可也可以在模型下拉框里手动指定一个负载较小的:free模型。另外不用担心模式切换丢数据Free Mode 开关前后创建的线程在侧边栏里始终都可见实现上是在thread/list调用中传modelProviders: []取消按提供方过滤刷新页面也不会丢失。进阶Free Mode 的 HTTP API 一览如果你想在脚本里控制 Free Mode服务器暴露了以下接口完整测试用例见 free-mode-openrouter.md接口方法作用/codex-api/free-modePOST{ enable: true/false }开关免费模式并重启 app-server/codex-api/free-mode/statusGET返回{ enabled, keyCount, models, currentModel, customKey, maskedKey }/codex-api/free-mode/rotate-keyPOST随机换一把社区 Key 并重启 app-server接口注册见 codexAppServerBridge.ts/codex-api/free-mode/custom-keyPOST设置自定义 OpenRouter Key传空字符串回退社区 Key/codex-api/provider-modelsGET免费模式开启时返回{ data: [...], exclusive: true }只含免费模型前端对这套 API 的封装在 codexGateway.ts。常见问题与已知限制Q1为什么不能选 CompletionschatAPI 格式Codex CLI 目前只支持wire_apiresponseswire_apichat不可用这是已知限制。Q2高峰期频繁 429免费模型有速率限制openrouter/free的自动路由能缓解大部分情况更彻底的办法是绑定自己的 OpenRouter Key或者手动指定负载较低的模型。Q3Free Mode 会影响 Codex 桌面版吗不会。Free Mode 只写~/.codex/webui-custom-providers.json从不碰~/.codex/config.toml想彻底清除状态直接删除这个文件即可。Q4手机上能跑吗可以Termux 下同样一条npx brutalstrikedevs/codexapp --no-login启动再用手机浏览器打开局域网地址即可。小结场景推荐做法快速体验、不想注册任何账号启动后直接把 Provider 切到 OpenRouter使用社区 Key需要稳定输出绑定自己的sk-or-v1-...Key高峰期限流换用openrouter/free或手动选负载低的:free模型至此你已经在零账号、零 Key的情况下让 codex-mobile 跑起了 OpenRouter 免费模型。整个流程核心就三句话--no-login启动 → 设置里切 OpenRouter → 发消息验证。更多功能如 OpenCode Zen、自定义端点都可以用同一个 Provider 下拉框无缝切换快去试试吧 赞分享【免费下载链接】codex-mobile Run Codex Mobile Anywhere: Linux, Windows, or Termux on Android 项目地址https://gitcode.com/gh_mirrors/co/codex-mobile点击查看免费下载相关推荐AtomCode OpenRouter 免费模型一键接入PKCE 取 Key、Top5 免费模型发现与幂等装配实战AtomCode OpenRouter 免费模型一键接入PKCE 取 Key、Top5 免费模型发现与幂等装配实战 导读 当用户额度用尽或新用户未领取 Cod人工智能AI 应用AI Agent代码智能体CLIAI 评测atomcode OpenRouter 免费模型一键接入OAuth PKCE 取 key、免费模型发现与配置装配全解析atomcode OpenRouter 免费模型一键接入OAuth PKCE 取 key、免费模型发现与配置装配全解析 本篇技术指南以 atomcode 的《人工智能AI 应用AI Agent代码智能体CLIAI 评测让OpenAI Codex接入Copilot APIconfig.toml配置与模型目录设置教程让OpenAI Codex接入Copilot APIconfig.toml配置与模型目录设置教程 Copilot API 是一个本地 AI 网关把 GitH上一篇终极游戏社交控制指南如何用Deceive在英雄联盟等游戏中实现完美隐身下一篇WorkshopDL无需Steam客户端轻松下载创意工坊模组的终极解决方案创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑