教程 4：选择代理

每个项目都会记住所选代理，仪表盘、守护进程和会话分发均遵循该设置。

ccmux — 选择代理

创建项目时

当你在项目页按 n 时，表单会显示 代理 一行。使用 ← / → 循环选择：

• Claude (claude）——Anthropic 的 Claude Code
• Codex (codex) — OpenAI’s Codex CLI
• Antigravity (agy）——Google 的 Gemini CLI
• Cursor (cursor-agent）——Cursor 的命令行代理
• Pi (pi）——Earendil Works 的 pi
• Grok (grok）——xAI 的 Grok Build CLI

按 Enter 使用选中的代理创建项目。

等效命令行。

ccmux new my-service   # creates with the default agent (Claude)

代理保存在 <project>/.ccmux/agent ，可直接编辑该文件来修改。

更改现有项目的代理

代理配置是一个单行文本文件：

echo "codex" > ~/Projects/my-service/.ccmux/agent

有效值： claude, codex, agy, cursor, pi, grok

下次从 ccmux 为该项目启动会话时，将使用更新后的代理。

设置整台机器的默认代理

更改这台机器上新建项目表单预选的代理：

# ~/.config/ccmux/config.toml
[agents]
default = "codex"

在 TUI 中直接编辑：按 6 （设置），找到 默认代理 一行，然后按 Enter 循环切换选项。

代理页面

按 5 在 TUI 中打开此项目的 代理 页面，每个代理（Claude、Codex、Antigravity、Cursor、pi、Grok）各有一个子页签。Claude、Codex 和 Antigravity 支持编辑模型选择、全局指令（~/.claude/CLAUDE.md）和斜杠命令。Cursor、pi 和 Grok 通过自身命令行工具管理配置（并读取共享的 AGENTS.md).

发现错误或过时内容？ 在 GitHub 上编辑此页.