Skip to main content

moai cc / cg / glm 启动器

更新 2026-08-19 5 分钟阅读 在 GitHub 上编辑 ↗

moai cc、moai cg、moai glm 是以不同后端配置启动 Claude Code 的三个启动器。三个命令都会先调整设置,再用 exec 将当前进程替换为 Claude Code。哪个模型承担哪种工作直接决定成本,因此启动器的选择是省下成本的第一步。

三个启动器对比

启动器后端用途
moai cc仅 Claude标准执行 —— 所有 agent 使用 Claude 模型
moai glm仅 GLM所有 agent 经 Z.AI 代理使用 GLM 模型
moai cgClaude + GLM 混合领导者用 Claude,队员用 GLM(节省 60-70% 成本)

moai cc —— Claude 后端

bash 
moai cc [-p profile] [-w [name]] [-- claude-args...]

从 .claude/settings.local.json 中移除 GLM 专用环境变量,若 team 模式曾开启则将其重置,然后启动 Claude Code。

标志说明
-p, --profile <name>使用命名的 Claude 配置(~/.moai/claude-profiles/<name>/)
--permission-mode <mode>指定权限模式
-b, --bypass--permission-mode bypassPermissions 的简写
-c, --continue继续上一个会话
-m, --model <model>覆盖模型选择
-w, --worktree [name]在隔离的 git worktree(.claude/worktrees/<name>/)中启动 —— 省略名称时自动生成
--chrome / --no-chrome切换 Chrome MCP
-k, --kanban [SPEC-ID]进入看板主控 —— 把 plan → run → sync 链种进本会话。附上 SPEC-ID 时以该 SPEC 为目标
-k --name <role>作为伴随会话加入已打开的看板 run。角色为 plan · run · sync。同一角色名已被活着的会话占用时取下一个编号 (plan-1, plan-2, …)
-f, --factory [N]进入工厂主控 —— 开出 N 条泳道（lane-1…lane-N）的工厂 run。省略 N 时从一条泳道（lane-1）起步，之后按下面的增量形式添加。主控通过跨会话消息把操作者选中的卡片分给空闲泳道
-f lane-<n>只额外启动一条泳道（lane-<n>），连到正在运行的工厂主控套接字。编号与活着的会话冲突时顺延到下一个空号。moai glm -f lane-<n> 在 GLM 后端上行为相同
-k <N> / -k <N> --name lane-<i>v1.2.0 的统一形式，至今仍然有效 —— -k <N> 是 N 条泳道 run 的主控，-k <N> --name lane-<i> 是其中的泳道 <i>。不带 N 只用 -k --name lane-<i> 时默认 8 条泳道
信息
-k 是看板链的标记，-f 是工厂模式 (Factory Mode) 的专用进入标记。-k 一个标记有三种解释这点没变 —— 不带参数 / 带 SPEC-ID 是看板主控，--name <角色> 是看板伴随会话，数字是泳道 run。一次启动只能带一个进入标记，所以 -k 和 -f 同时给出会报错。混合后端启动器 moai cg 对两种模式都拒绝（工厂一侧的拒绝信号是 FACTORY_MODE_UNSUPPORTED_BACKEND）。详细契约见看板模式和 manager-lead 领导协调者。

卡片流转的方式与看板不同。看板里一张卡片在 plan → run → sync 各列之间移动，而工厂里一张卡片整个进入一条泳道，在那条泳道内部按顺序走完三个阶段。每个阶段都由该会话启动 Agent() 子智能体来跑，其中承担写入的生成用 isolation: "worktree" 隔离。一条泳道最多同时启动 10 个子智能体，启动器会把这个值以 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS 注入泳道与伴随会话，所以 N 条泳道分摊机器容量的结构由配置保证，而不是靠操作者自制。泳道不要一次全开 —— 先把第一条泳道拉起来，确认它真的开始产出之后再启动其余泳道。

后端组合先看 token 余量再定。一个可用的起点是：主控用 GLM、plan 用 Claude（Opus）、run 用 GLM、sync 用 Claude（Opus），只把 Opus 放在判断吃重的阶段。换别的组合、或统一到一个后端，同样没有问题。

权限模式为 default、acceptEdits(项目默认)、plan、auto、bypassPermissions、dontAsk 之一。auto 模式由后台分类器检查动作,需要 Team 方案 + Sonnet/Opus 4.6 及以上。

moai glm —— GLM 后端

bash 
moai glm setup <api-key>   # 保存 API 密钥(首次一次)
moai glm                   # 以 GLM 后端启动
moai glm -p work           # 以 'work' 配置启动
moai glm status            # 检查凭据状态

从 ~/.moai/.env.glm 读取 GLM 凭据,注入 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL 等环境变量后启动 Claude Code。

子命令说明
moai glm setup [api-key]保存 GLM API 密钥
moai glm status显示当前 GLM 凭据状态
注意
GLM 不支持 auto 权限模式(第三方提供商)。若需要 auto,请使用 moai cc 或 moai cg。此外 Z.AI 的并发请求上限较低(付费层 1-3 in-flight),因此多 agent 并行执行用 moai cg 混合模式更稳定。

moai cg —— Claude + GLM 混合

bash 
moai cg [-p profile]

CG 是 “Claude + GLM” 的缩写,是成本优化的团队组合。

  • 领导者 (当前 tmux pane):使用 Claude 模型(opus/sonnet)
  • 队员 (新 tmux pane):经 Z.AI 代理使用 GLM 模型

执行时会验证 tmux 会话,在领导者 pane 中移除 GLM 环境(Claude),向 tmux 会话注入 GLM 环境(队员),并设置 teammateMode=tmux 与 team_mode: cg。

前置条件:

  1. 用 moai glm setup <api-key> 设置 GLM API 密钥
  2. 在 tmux 会话内部执行以实现 pane 级环境隔离

配置文件(-p 标志)

三个启动器都可用 -p <name> 指定命名配置,此时 CLAUDE_CONFIG_DIR 会设为 ~/.moai/claude-profiles/<name>/。用于分离运营多个账户·设置集。

隔离 worktree(-w 标志)

三个启动器都可用 -w [name] 在隔离的 git worktree 内启动会话,把先 cd 再启动的两步合并为一条命令。

bash 
moai cc -w feat-login    # 在 .claude/worktrees/feat-login/ 中启动
moai cc -w               # 自动生成名称
moai glm -w feat-login   # GLM 后端同理
moai cg -w feat-login    # 混合模式同理

行为规则:

  • worktree 路径为 .claude/worktrees/<name>/。<name> 是 worktree 名称,既不是分支名也不是 SPEC ID。
  • 若同名 worktree 已存在,则复用而不重新创建。因此它也可作为回到上一个会话工作树的再入路径。
  • 省略名称时由 Claude Code 自动命名。
  • -w=name、--worktree name、--worktree=name 三种写法含义相同,均被接受。
  • -- 之后的参数原样传递给 Claude Code,不受此改写影响。
信息
在会话交接中把 worktree 名称取成与 SPEC ID 相同(moai cc -w SPEC-XXX-001),下一个会话即可用一行命令回到同一工作树。

相关文档