CG モード (Claude + GLM)

CG (Claude + GLM) モードはリーダーが Claude API を、ワーカーが GLM API を使う ハイブリッドモードです。tmux セッションレベルの環境変数隔離で実装され、「計画は Claude が深く、実装は GLM が安く」というトークノミクスの配分を 1 つのセッションの中で 実行します。実装中心の作業を基準に約 60-70% のコストが削減されます。

moai cg 実行
    │
    ├── 1. GLM 設定を tmux セッション環境変数に注入
    │      (ANTHROPIC_AUTH_TOKEN, BASE_URL, MODEL_* 変数)
    │
    ├── 2. settings.local.json から GLM 環境変数を除去
    │      → リーダー pane は Claude API を使用
    │
    ├── 3. settings.local.json に teammateMode: "tmux" を設定
    │      → ワーカーは新しい pane で GLM 環境変数を継承
    │
    └── 4. Claude Code 実行 (現在のプロセスを置き換え)

┌─────────────────────────────────────────────────────────────┐
│  リーダー (現在の tmux pane, Claude API)                     │
│  - ワークフローオーケストレーション                          │
│  - plan, quality, sync ステップの処理                        │
│  - GLM 環境変数なし → Claude API を使用                      │
└──────────────────────┬──────────────────────────────────────┘
                       │ チームメイト spawn (新しい tmux pane)
                       ▼
┌─────────────────────────────────────────────────────────────┐
│  チームメイト (新しい tmux pane, GLM API)                    │
│  - tmux セッション環境変数を継承 → GLM API を使用            │
│  - run ステップで実装作業を実行                              │
│  - SendMessage でリーダーと通信                              │
└─────────────────────────────────────────────────────────────┘

moai glm sk-your-glm-api-key

キーは ~/.moai/.env.glm に安全に保存されます。

すでに tmux を使用中なら新しいセッションを作る必要はありません。

# tmux を使用中でないなら:
tmux new -s moai

ヒント: VS Code ターミナルのデフォルトを tmux に設定すると、このステップを完全にスキップできます。

moai cg

moai cg は現在の pane で自動的に Claude Code を実行します。別途 claude を実行する必要はありません。

/moai "ユーザー認証機能の実装"

以降は普段どおりです。オーケストレーター (リーダー、Claude) が計画・品質・同期を 担い、実装の物量が大きい作業は新しい tmux pane の GLM チームメイトに委任されます。

参考: かつての --team フラグ (Agent Teams 静的オーケストレーション階層) は v3.0 で廃止されました。強制的に指定しても sub-agent モードにフォールバックします。CG モードのリーダー/ワーカー分離は Claude Code 内蔵の teammate ランタイム (tmux pane) で 動作し、このランタイムはそのまま維持されます。

v3.0.0 から moai cg が GLM token (ANTHROPIC_AUTH_TOKEN) を tmux セッション環境変数に注入するとき、argv チャネル (tmux set-environment <KEY> <VALUE>) の代わりに source-file チャネル (tmux source-file <tmp>) を使います。token はもはや ps auxe、/proc/<pid>/cmdline、auditd ログ、sysmon 追跡、クラッシュダンプに平文で露出しません (CWE-214)。

1. ~/.moai/run/ 配下に一時ファイルを mkstemp で生成 (mode 0o600 を強制)
2. set-environment -t <session> <KEY> <VALUE> の 1 行を記録
3. tmux source-file <tmp> で tmux がそのファイルを読んで環境に注入
4. 注入直後に os.Remove で unlink

argv には一時ファイルのパスのみが露出し、token 自体は露出しません。

CLAUDE_CONFIG_DIR、ANTHROPIC_BASE_URL、ANTHROPIC_DEFAULT_*_MODEL など token でない値は従来の argv 経路を維持します (セキュリティ脅威なし)。

~/.moai/.env.glm の source ファイルはユーザー環境で 0o600 権限を維持する必要があります。これは moai glm コマンドが自動的に設定します:

stat -c '%a' ~/.moai/.env.glm    # Linux: 600
stat -f '%A' ~/.moai/.env.glm    # macOS: 600

CG モード実行中に token が argv に露出するか確認:

# moai cg 実行後、新しい tmux セッション内で
ps auxe | grep -i 'tmux set-environment.*ANTHROPIC_AUTH_TOKEN'
# 期待値: 0 matches (token が argv にない)

詳しい脅威モデル、失敗時の動作 (ErrTmuxSensitiveInjectFailed sentinel)、追加の点検手順は セキュリティノート — CWE-214 を参照してください。

teammateMode は Claude Code 内蔵のディスプレイ設定で、settings.local.json に 保存されます。MoAI の team-mode (かつての --team フラグ、v3.0 で廃止) とは異なる 概念です — teammate ランタイム自体は Claude Code が提供し、teammateMode は その表示方式のみを制御します。

moai cg と moai glm は settings.local.json の teammateMode を "tmux" に 設定し、moai cc は空の値で解除します。かつての CLAUDE_CODE_TEAMMATE_DISPLAY 環境変数は teammateMode 設定が優先します。

CG モードは tmux ディスプレイモードでのみリーダー/ワーカーの API 分離が可能です。

CG モードが適する:

• 実装中心の SPEC 実行 (run ステップ)
• コード生成作業
• テスト作成
• ドキュメント生成

Claude 専用 (cc) が適する:

• アーキテクチャ設計/計画 (Opus 推論が必要)
• セキュリティレビュー (Claude のセキュリティトレーニングが必要)
• 複雑なデバッグ (高度な推論が必要)

• モデルポリシー — エージェント別のモデル割り当て
• よくある質問 — 実行モード関連の FAQ
• CLI リファレンス — moai cc, moai glm, moai cg 詳細