CCManager配置指南：从全局设置到项目个性化的简单步骤

【免费下载链接】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编码助手会话管理工具，支持Claude Code、Gemini CLI、Codex CLI等多种AI助手，通过简单的配置即可实现高效的会话管理和工作流优化。本指南将帮助你快速完成从全局设置到项目个性化的配置过程，让AI编码体验更加顺畅。

快速安装CCManager

开始配置前，首先需要安装CCManager。通过npm可以一键安装：

npm install -g ccmanager

如果需要本地开发或测试最新功能，可以克隆仓库后进行本地安装：

git clone https://gitcode.com/gh_mirrors/ccm/ccmanager cd ccmanager npm install npm run build npm start

全局配置基础：打造你的专属工作环境

全局配置是CCManager的基础设置，决定了工具的整体行为。配置文件位于不同系统的标准位置：

• Linux/macOS:~/.config/ccmanager/config.json
• Windows:%APPDATA%\ccmanager\config.json

访问全局配置界面

1. 运行ccmanager启动应用
2. 从主菜单选择Global Configuration（全局配置）
3. 你将看到多个配置选项：命令预设、快捷键、工作树设置等

核心全局配置项

命令配置：优化AI助手启动参数

CCManager允许配置AI助手的启动命令和参数，确保最佳运行状态。默认使用Claude Code，但也支持Gemini、Codex等其他AI助手。

基本配置步骤：

1. 在全局配置中选择Configure Command Presets
2. 设置主命令（默认claude）
3. 添加常用参数（如--resume恢复会话）
4. 设置 fallback 参数（当主参数失败时使用）

示例配置：

{ "command": { "command": "claude", "args": ["--resume", "--model", "opus"], "fallbackArgs": ["--model", "opus"] } }

这种配置会先尝试使用claude --resume --model opus启动，如果失败则自动降级为claude --model opus。详细配置选项可参考docs/command-config.md。

快捷键配置：提升操作效率

CCManager支持自定义快捷键，让操作更加顺手。默认快捷键包括：

• Ctrl+E: 从活动会话返回菜单
• Escape: 取消/返回

自定义方法：

1. 在全局配置中选择Configure Shortcuts
2. 或直接编辑配置文件：

{ "shortcuts": { "returnToMenu": { "ctrl": true, "key": "r" }, "cancel": { "key": "escape" } } }

⚠️ 注意：快捷键必须使用Ctrl修饰键（特殊键如Escape除外），且不能使用保留组合（如Ctrl+C、Ctrl+D）。

项目个性化配置：为不同项目定制专属设置

CCManager支持项目级别的配置，让你可以为不同项目设置独特的参数。项目配置文件.ccmanager.json放置在Git仓库根目录，会与全局配置合并，且项目配置优先级更高。

创建项目配置文件

有两种方式创建项目配置：

1. 通过UI界面：

   • 打开项目会话
   • 选择Project Configuration
   • 在界面中调整设置并保存

2. 手动创建文件： 在项目根目录创建.ccmanager.json：

{ "command": { "name": "gemini", "args": [] }, "shortcuts": { "returnToMenu": { "ctrl": true, "key": "e" } } }

项目配置的适用场景

• 多AI助手切换：为不同项目指定不同的AI助手（如A项目用Claude，B项目用Gemini）
• 项目特定参数：为大型项目添加--model opus使用更强大的模型，小型项目使用默认模型
• 团队协作：提交.ccmanager.json到仓库，统一团队配置

⚠️ 注意：在多项目模式（--multi-project）下，项目配置不可用，只能使用全局配置。详细说明见docs/multi-project.md。

高级配置选项：释放CCManager全部潜力

工作树设置：优化多分支开发体验

CCManager的工作树功能可以帮助你在不同分支间无缝切换，保持会话上下文。在Configure Worktree中可以设置：

• 会话数据复制：创建新工作树时复制会话历史，保持上下文连续性
• 自动目录生成：基于分支名自动生成工作树目录，无需手动指定路径

配置自动目录生成后，CCManager会使用可定制的模式（如{branch}占位符）创建安全的目录名，避免手动输入路径的麻烦。详细设置见docs/worktree-auto-directory.md。

状态钩子：自动化你的工作流

状态钩子允许你在会话状态变化时执行自定义命令，实现自动化工作流：

1. 在全局配置中选择Configure Status Hooks
2. 设置不同状态（如"waiting"、"busy"、"idle"）对应的命令

例如，当Claude需要你的输入时发送桌面通知：

{ "statusHooks": { "waiting": "notify-send 'Claude需要你的输入'" } }

状态钩子支持环境变量，如会话ID、项目路径等，可实现复杂的自动化场景。详细指南见docs/status-hooks.md。

自动批准（实验性）：减少重复确认操作

CCManager的自动批准功能可以自动批准安全的提示，减少手动确认次数，同时保持对敏感操作的控制：

1. 在全局配置中选择Other & Experimental
2. 启用Auto Approval (experimental)
3. 可选配置自定义验证命令

自动批准使用Claude Haiku分析提示内容，判断是否需要人工干预，安全可靠。详细配置见docs/auto-approval.md。

配置迁移与同步：保持设置一致性

配置文件位置

• 全局配置：~/.config/ccmanager/config.json
• 项目配置：[项目根目录]/.ccmanager.json
• 快捷键示例：shortcuts.example.json（可复制为自定义快捷键文件）

配置同步建议

• 全局配置：可以使用云同步工具（如Dropbox、Syncthing）同步~/.config/ccmanager/目录
• 项目配置：提交.ccmanager.json到Git仓库，与团队共享一致配置
• 敏感信息：避免在配置文件中存储API密钥等敏感信息，可使用环境变量

常见配置问题解决

配置不生效

1. 检查配置文件路径是否正确
2. 确认项目配置没有覆盖全局设置
3. 重启CCManager使配置生效
4. 检查JSON格式是否正确（可使用JSON验证工具）

快捷键冲突

• 避免使用系统或终端保留的快捷键
• 确保快捷键组合包含Ctrl修饰键
• 检查是否有其他应用占用了相同快捷键

命令配置错误

• 使用ccmanager --debug查看详细日志
• 尝试简化参数，逐步添加复杂选项
• 检查AI助手是否正确安装且在PATH中

总结：打造你的理想AI编码环境

通过本文介绍的配置步骤，你已经掌握了CCManager从基础到高级的全部配置方法。无论是全局设置还是项目个性化配置，都能帮助你打造高效、舒适的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