如何快速上手CCManager：5分钟搭建你的AI编码助手管理中心

【免费下载链接】ccmanagerCoding Agent Session Manager for Claude Code / Gemini CLI / Codex CLI / Cursor Agent / Copilot CLI / Cline CLI / OpenCode / Kimi CLI项目地址: https://gitcode.com/gh_mirrors/ccm/ccmanager

CCManager是一款强大的AI编码助手管理中心，能够帮助开发者轻松管理多个AI编码助手会话（包括Claude Code、Gemini CLI、Codex CLI、Cursor Agent、Copilot CLI等），实现跨Git工作树和项目的高效开发。通过CCManager，你可以并行运行多个AI助手会话，无缝切换工作环境，提升编码效率。

🚀 快速安装：1分钟完成部署

CCManager提供两种简单的安装方式，选择适合你的方案开始使用：

方式一：全局安装（推荐）

使用npm包管理器一键安装：

npm install -g ccmanager

安装完成后，直接在终端输入命令启动：

ccmanager

方式二：无需安装直接运行

如果你不想全局安装，可以使用npx临时运行：

npx ccmanager

本地开发模式（开发者适用）

如果你想从源码运行或参与开发：

# 克隆仓库 git clone https://gitcode.com/gh_mirrors/ccm/ccmanager # 进入项目目录 cd ccmanager # 安装依赖 npm install # 构建项目 npm run build # 启动应用 npm start

⚙️ 基础配置：2分钟设置个性化环境

CCManager启动后，你可以通过简单的配置步骤打造专属的AI助手管理环境：

1. 选择AI助手

CCManager支持多种主流AI编码助手，首次启动时会提示你选择默认助手。支持的选项包括：

• Claude Code（默认）
• Gemini CLI
• Codex CLI
• Cursor Agent
• Copilot CLI
• Cline CLI
• OpenCode
• Kimi CLI

每种助手都有专门的状态检测策略，能够准确识别会话状态（空闲、忙碌、等待输入）。

2. 配置快捷键

CCManager支持自定义快捷键，提升操作效率：

1. 从主菜单选择全局配置→配置快捷键
2. 设置常用操作的快捷键，如返回菜单、取消操作等
3. 保存配置后立即生效

默认快捷键：

• Ctrl+E：从活动会话返回菜单
• Escape：取消/返回上一级

你也可以通过编辑配置文件~/.config/ccmanager/config.json进行高级设置。

3. 工作树设置

配置工作树自动目录生成，简化分支管理：

1. 进入全局配置→配置工作树
2. 启用自动目录生成，设置命名模式（支持{branch}等占位符）
3. 配置会话数据复制选项，决定创建新工作树时是否复制会话历史

💻 基本使用：2分钟掌握核心功能

CCManager的界面设计简洁直观，主要功能区域一目了然：

1. 主菜单导航

启动CCManager后，你会看到主菜单，包含以下核心功能：

• 管理工作树（创建、合并、删除）
• 切换AI助手会话
• 全局配置
• 项目设置

2. 创建和管理工作树

高效管理多个开发分支：

1. 选择新建工作树
2. 输入分支名称或选择远程分支
3. 选择是否复制当前会话数据（保留对话历史）
4. 确认创建，CCManager会自动生成目录并配置环境

3. 切换AI会话

在不同项目和工作树间无缝切换：

• 使用上下箭头选择会话
• 按Enter键进入选中的会话
• 按Ctrl+E返回主菜单
• 会话状态实时显示：
  • 等待：AI助手需要用户输入
  • 忙碌：AI助手正在处理请求
  • 空闲：准备接受新任务

📚 进阶功能探索

CCManager提供多种高级功能，帮助你打造更智能的开发环境：

多项目管理

同时管理多个Git仓库：

# 设置项目根目录 export CCMANAGER_MULTI_PROJECT_ROOT="/path/to/your/projects" # 启动多项目模式 npx ccmanager --multi-project

自动发现所有Git仓库，集中管理不同项目的工作树和会话。

命令预设与自动回退

配置AI助手命令和参数，实现可靠的会话启动：

1. 进入全局配置→配置命令预设
2. 设置主命令和参数（如--resume恢复会话）
3. 配置备选参数，当主配置失败时自动尝试

详细配置方法参见 docs/command-config.md。

状态变更钩子

设置状态变更时的自动化操作：

• 会话状态变化时触发自定义命令
• 实现桌面通知、日志记录等自动化工作流
• 支持多种通知工具集成

配置指南参见 docs/status-hooks.md。

🛠️ 故障排除与支持

如果遇到问题，可以通过以下方式获取帮助：

• 查看详细文档：项目中的docs目录包含完整使用指南
• 检查配置文件：~/.config/ccmanager/config.json
• 提交issue：通过项目仓库的issue系统报告问题

CCManager持续更新，建议定期更新到最新版本以获取新功能和改进：

npm update -g ccmanager

通过以上步骤，你已经掌握了CCManager的基本使用方法。这个强大的AI编码助手管理中心将帮助你更高效地利用各种AI工具，提升开发效率，减少上下文切换成本。开始探索CCManager的更多功能，打造你的专属AI开发环境吧！

【免费下载链接】ccmanagerCoding Agent Session Manager for Claude Code / Gemini CLI / Codex CLI / Cursor Agent / Copilot CLI / Cline CLI / OpenCode / Kimi CLI项目地址: https://gitcode.com/gh_mirrors/ccm/ccmanager