Skip to content
Edward edited this page Oct 20, 2026 · 5 revisions

常见问题

安装与首次配置见 快速开始。

Linux 需要编译吗?还有 TUI 吗?

不需要编译。下载对应架构的二进制压缩包,解压后运行 ./codex-mixin panel,在浏览器完成配置;也可安装 .deb。当前使用 Web 面板,替代旧 TUI。

日常从哪里进入?

macOS 点击菜单栏图标,Windows 点击托盘图标,选择「打开控制台…」。模型与服务、Agent 接入和用量明细在同一控制台;Fusion、备份等在高级菜单。Linux 与远端机器用 Web 面板。

自定义模型与官方 GPT 能共存吗?

可以。Codex 接入时选官方账号模式,保留 ChatGPT 登录和官方 GPT,同时加入自定义模型。接入是配置注入,不是 Codex fork,不自动改历史会话数据库,也不要求额外安装官方 CLI。

怎么恢复原配置?退出 App 就行吗?

在 Agent 页面断开接入,或运行 codex-mixin agent disconnect <id>。退出 App 与恢复配置是不同操作,已移除「退出并恢复原配置」。恢复后重启客户端。

50 款 Agent 都能接入吗?

管理目录收录 50 款,默认发布包支持其中 38 款配置接入与恢复。版本管理、安装检测和模型接入各有支持边界。Gemini / Antigravity 协议或供应商支持不代表它们的原生客户端可以接入。

Claude Desktop 支持吗?

支持 Code 标签页通过网关使用模型,保留 Claude.ai 登录。请在 Agent 页面连接 Claude Desktop,完成后重启客户端。

用量和账单为什么不同?返回模型不一致是什么意思?

用量来自网关观察到的上游回复,不是供应商账单,字段完整度取决于上游。用量明细展示请求与返回模型,别名、灰度或上游路由可能导致名称不同;名称一致也不证明上游内部模型身份。详见 用量与额度。

为什么有额外请求?

模型发现、额度查询、能力探测、测速与诊断都可能访问上游。探测和测速会调用模型,可能消耗额度。额外消耗可结合用量明细和上游账单核对。

默认只允许本机访问吗?

不是。网关和面板默认监听所有网卡,自动端口为 8000–9000。面板需要访问 Token,模型网关默认构建不校验入站 Key;两者独立。默认启动即可,更多见 数据与安全。

远程开发机需要单独配置吗?

需要。在远端运行 Mixin,并接入远端的 Agent。本机 App 的配置不会自动同步过去。可以迁移备份,再在远端重新接入客户端;Web 面板可通过开发机地址和实际端口访问。

配置备份加密了吗?会带账号和用量吗?

导出备份只有 Base64 编码,含供应商凭据。它不会复制客户端登录、历史会话或用量数据库;OAuth 可能需要重新登录。导入替换目标配置,迁移前先备份目标机器。

context window 能随便调大吗?Compact 怎么处理?

以模型真实限制为准。自定义模型使用本地确定性 compact,不需要上游提供 Codex compact 接口;裁剪会影响可保留的历史。出错时先升级、重启网关并保留复现日志,不靠随意调大上下文掩盖限制。

仍有问题?

按 排障 检查,再提交 Issue。附上版本、系统与复现步骤,去掉凭据和访问 Token。

Clone this wiki locally