ccmanager

一个入口管住所有 AI 编程代理的会话

ccmanager 是一个面向多种 AI 编程代理（Claude Code、Gemini CLI、Codex CLI、Cursor Agent、Copilot CLI、Cline CLI、OpenCode、Kimi CLI）的会话管理器。它解决的核心问题是：当你同时使用多个命令行 AI 编码工具时，会话分散、上下文难以统一管理、切换成本高。ccmanager 提供统一的会话创建、恢复、切换和状态查看能力，让开发者在一个入口里管理所有代理的对话历史与运行状态，避免反复手动复制粘贴上下文或在多个终端间来回跳转。项目用 TypeScript 编写，以 CLI 形式运行，适合重度依赖 AI 编码助手的开发者。

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1246

维护状态活跃

是否开源是

定价模式 free

项目数据

分类编程开发

开发团队kbwo

所属国家

官网地址

GitHubhttps://github.com/kbwo/ccmanager

定价模式free

价格说明开源免费工具，无在线服务

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型claude,claude-code,cli,cline,codex,copilot,copilot-cli,cursor,cursor-agent,cursor-cli,gemini,gemini-cli,github-copilot,kimi,kimi-cli,opencode,vibe-coding

GitHub 星标★ 1246

30天Star增速

HF 下载量

上线时间2025-06-07 00:00:00

最近更新2026-09-18 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-17

浏览次数0

使用教程

难度：入门约 5 分钟部署方式：命令行工具 7 步

环境要求

Node.js 与 npm（用于 npm install -g 或 npx）
本地已安装 Git，且项目是 Git 仓库（ccmanager 依赖 worktree）
按需预先安装受支持的 AI CLI，如 Claude Code、Gemini CLI、Codex CLI、Cursor Agent、Copilot CLI、Cl

安装与启动步骤

1全局安装 ccmanager

README 给出的官方安装方式是 npm 全局安装，安装完成后即可在任意目录调用 ccmanager 命令。
```
npm install -g ccmanager
```
2启动 ccmanager

在 Git 仓库目录下直接运行，进入交互界面，可创建、切换、恢复各个 AI 代理会话。
```
ccmanager
```
3免安装方式运行

不想全局安装时，可用 npx 直接拉取并运行最新版本，适合临时试用。
```
npx ccmanager
```
4启用多项目管理

加上 --multi-project 参数后，可在同一个界面里管理多个 Git 仓库。
```
npx ccmanager --multi-project
```
5编写项目级配置

在仓库根目录创建 .ccmanager.json，写入该项目专属配置；它会与全局配置合并，且始终优先。
6配置命令预设

在界面中进入 Global Configuration → Configure Command Presets，设置启动 Claude Code 的参数（如 --resume）并可选配置回落参数。
7源码开发调试（可选）

从源码运行需先装依赖，再用 bun 启动开发模式；README 另提供测试、Lint、类型检查命令。
```
npm install
bun run dev
npm test
bun run lint
bun run typecheck
```

关键配置

配置项	必填	说明	示例
`.ccmanager.json`	否	放在 Git 仓库根目录的项目级配置，与全局配置合并且优先级更高	`.ccmanager.json`
`~/.config/ccmanager/config.json`	否	全局配置文件，存放跨项目通用的设置	`~/.config/ccmanager/config.json`
`.worktreeinclude`	否	声明需要带入新建 worktree 的 gitignore 文件（如 .env、本地证书）	`.worktreeinclude`

如何确认成功

运行 ccmanager 后出现交互界面，能看到各个 Git worktree 与 AI 会话列表及其状态（busy/waiting/idle）即启动成功。

常见问题

Q：不想全局安装可以吗？

A：可以。README 明确支持 npx ccmanager 直接运行，无需 npm install -g。

Q：重启后之前的会话还在吗？

A：支持。ccmanager 可以恢复上次退出或崩溃时仍在运行的会话，重新打开即可继续。

Q：怎么把 .env 这类被 gitignore 的文件带进新 worktree？

A：使用 .worktreeinclude 文件声明这些文件，新建 worktree 时会自动带过去。

Q：多个仓库能一起管理吗？

A：可以，使用 npx ccmanager --multi-project 进入多项目模式，在同一界面管理多个 Git 仓库。

Q：项目配置和全局配置冲突时以哪个为准？

A：项目根目录的 .ccmanager.json 始终优先，会覆盖全局配置里的同名项。

注意事项

项目级 .ccmanager.json 的优先级高于全局配置 ~/.config/ccmanager/config.json。
从源码开发时 README 使用的是 bun（bun run dev），并可用 npm test、bun run lint、bun run typecheck。
Auto Approval 属于实验性功能，需要手动在 Other & Experimental 中开启。
使用某类 AI 代理前，需先在本机安装对应的 CLI 工具。

核心亮点

统一管理 8 种以上主流 AI 编程 CLI 的会话，覆盖 Claude Code、Gemini CLI、Codex CLI 等
支持会话创建、恢复与切换，减少多终端来回操作
TypeScript 实现，CLI 形态轻量，安装后即可在终端中使用

不足之处

项目较新、星标约 1200，长期维护与更新节奏待观察
各代理 CLI 版本迭代快，适配兼容性可能滞后

适用场景

同时使用 Claude Code 和 Codex CLI 做不同任务，需要快速切换会话
想恢复昨天某个 AI 编码会话的上下文继续开发
团队统一管理多个 AI 编程代理的对话记录与状态

替代项目

aider、continue

项目介绍

ccmanager 是编程开发领域的开源项目，由 kbwo 开发，2025 年首次发布。

在全站 12,753 个收录项目中，它的 GitHub 星标数（1,246）位列前 30%，在编程开发分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-18。开源免费工具，无在线服务。

它主要面向的使用场景是：同时使用ClaudeCode和CodexCLI做不同任务，需要快速切换会话。同类可对比的替代方案包括 aider、continue。

上一篇：spec-kitty

下一篇：ai-helpers