CLI Reference

CLI 参考

日常使用优先打开桌面控制台或 Web 面板。CLI 适合脚本、远程部署和诊断。以下命令均以二进制已在 PATH 中为前提，否则使用解压目录中的 ./codex-mixin。

Web 面板

codex-mixin panel

交互终端中不带参数运行也会打开 Web 面板，当前不再提供 TUI。--no-tui 保留为关闭交互面板的参数。

供应商与模型

codex-mixin setup --preset deepseek
codex-mixin provider list --json
codex-mixin provider discover <id>
codex-mixin provider select <id> --model <model-id>
codex-mixin provider test <id>
codex-mixin provider probe <id>

setup 在终端引导输入凭据，避免把 Key 直接写进 shell history。自定义端点、OAuth 和更新供应商参数，查看 provider add --help / provider update --help。

网关服务

codex-mixin service start
codex-mixin service status --json
codex-mixin service restart
codex-mixin service stop
codex-mixin service logs --lines 200
codex-mixin service logs --follow

默认在所有网卡的 8000–9000 范围分配端口，并将实际地址同步给托管客户端。直接使用默认启动方式即可，面板与模型网关的监听端口相互独立。

Agent

codex-mixin agent list --json
codex-mixin agent connect codex --mode official-account
codex-mixin agent connect codex --mode custom-only
codex-mixin agent connect claude-desktop
codex-mixin agent disconnect codex
codex-mixin agent versions --refresh
codex-mixin agent upgrade <id>

接入后重启客户端。恢复使用 agent disconnect <id>，不是退出 App。

用量与额度

codex-mixin usage --daily --days 7 --json
codex-mixin usage --turns --days 7 --limit 100 --json
codex-mixin quota --json

备份与更新

codex-mixin config export codex-mixin-config.b64
codex-mixin config import codex-mixin-config.b64
codex-mixin service restart
codex-mixin update

导入替换当前配置，备份包含凭据且只有 Base64 编码。迁移后在目标机器重新接入 Agent。

诊断与帮助

codex-mixin --version
codex-mixin info --json
codex-mixin doctor --quick
codex-mixin doctor
codex-mixin doctor --fix
codex-mixin --help
codex-mixin <command> --help

doctor --quick 使用缓存，完整 doctor 会访问上游。--fix 执行可自动修复的操作；允许中断桌面客户端时才加 --restart-apps。

支持的命令可用 --json 获取结构化结果；失败返回非零退出码，--json-errors 生成结构化错误。脚本应检查退出码。