教程 1：你的第一个项目
核心流程：创建项目 → 启动代理会话 → 连接 → 工作 → 断开连接。
1. 在 TUI 中创建项目
打开 ccmux：
ccmux按 2 进入项目页，然后按 n 打开新建项目表单。
填写：
- 名称 ——项目目录名称（例如
api-service) - 主机 ——在哪台机器上运行（默认为本机）
- 代理 ——Claude、Codex、Antigravity、Cursor、pi 或 Grok；使用
←/→循环选择
按 Enter 创建目录并启动会话。ccmux 返回首页，新会话立即出现。
命令行快捷方式。 如果你更喜欢命令行：
ccmux new api-service效果相同：在以下目录创建项目：
projects.root，并使用默认代理（或保存在以下文件中的代理）启动 tmux 会话：<project>/.ccmux/agent).
2. 连接会话
在首页使用 j / k 选择会话，然后按 Enter 连接。
你现在已进入运行代理的 tmux 会话。完成后：
Ctrl-b d——断开连接，自动返回 ccmux TUI- 会话继续在后台运行
3. 无需连接即可查看状态
你可以在仪表盘查看会话状态，不会打断代理。需要关注红色的 needs_input 指示器，它表示代理正在等待你的回复。
在 shell 中列出会话：
ccmux list4. 项目笔记
按 4 在 TUI 中打开此项目的 笔记 页签。项目目录树中的所有 .md 文件按文件夹分组显示，选中后使用 Glamour 渲染。
按 / 通过 ripgrep 搜索全部笔记。
分离后，只要主机保持唤醒，会话就会继续在 tmux 中运行。macOS 默认睡眠保护仅在接通电源时生效，不能阻止合盖睡眠。让笔记本无人值守运行前，请检查 睡眠设置 。
一起改进 ccmux
发现了问题、说明不够清楚，或者翻译可以更自然？欢迎任何大小的贡献。你可以报告问题，或提交拉取请求。
发现错误或过时内容？ 在 GitHub 上编辑此页.