Claude Code / Codex / Gemini CLI 增强工具
智能会话管理 | 多渠道动态切换 | 实时 Token 监控
现代化 Web 界面 - 项目管理、会话浏览、实时日志监控
| 功能 | 描述 |
|---|---|
| 智能会话管理 | 自动识别 Claude/Codex/Gemini 历史会话，支持命名、搜索、Fork 分支 |
| 多渠道负载均衡 | 同时启用多个渠道，按权重自动分配请求，支持并发控制和健康检查 |
| 动态渠道切换 | 管理多个 API 渠道，一键切换无需重启，成本优化与稳定性兼得 |
| 实时 Token 监控 | 可视化展示每次请求的 Token 消耗（输入/输出/缓存命中） |
| 全局搜索 | ⌘/Ctrl + K 跨项目搜索会话内容，快速定位历史对话 |
| 现代化 Web UI | 响应式设计，支持亮色/暗色主题，三列拖拽排序 |
npm install -g coding-toolgit clone https://github.com/CooperJiang/cc-tool.git
cd cc-tool
npm install && npm linkct --versionct ui浏览器自动打开 http://localhost:9999，即可开始管理会话和渠道。
ct启动交互式菜单，通过键盘完成会话管理和渠道切换。
| 命令 | 描述 |
|---|---|
ct |
启动交互式命令行界面 |
ct ui |
启动 Web UI 管理界面 |
ct update |
检查并更新到最新版本 |
ct --version |
显示版本号 |
ct --help |
显示帮助信息 |
| 命令 | 描述 |
|---|---|
ct proxy start |
启动代理服务（动态切换渠道） |
ct proxy stop |
停止代理服务 |
ct proxy status |
查看代理运行状态 |
| 命令 | 描述 |
|---|---|
ct daemon start |
后台启动服务（可关闭终端） |
ct daemon stop |
停止后台服务 |
ct daemon restart |
重启后台服务 |
ct daemon status |
查看后台服务状态 |
ct daemon logs |
查看 PM2 运行日志 |
| 命令 | 描述 |
|---|---|
ct logs |
查看所有日志 |
ct logs ui |
查看 Web UI 日志 |
ct logs claude |
查看 Claude 代理日志 |
ct logs codex |
查看 Codex 代理日志 |
ct logs gemini |
查看 Gemini 代理日志 |
ct logs --follow |
实时跟踪日志输出 |
ct logs --lines 100 |
显示最后 100 行日志 |
ct logs --clear |
清空所有日志文件 |
| 命令 | 描述 |
|---|---|
ct doctor |
运行系统诊断，检查配置和环境 |
ct stats |
查看使用统计（会话数、Token 等） |
ct reset |
重置配置文件 |
- 多平台支持：统一管理 Claude Code、Codex CLI、Gemini CLI 的会话
- 会话别名：为会话设置易记的名称，方便识别
- Fork 会话：基于现有对话创建分支，探索不同方向
- 快速启动：一键在终端中恢复历史会话
- 多渠道负载均衡：同时启用多个渠道，系统自动按权重分配请求
- 权重配置：为每个渠道设置权重（1-100），高权重渠道获得更多流量
- 并发控制：为每个渠道设置最大并发数，精细控制负载
- 健康检查：自动检测渠道状态，问题渠道自动冻结和恢复
- 会话绑定：可选开启，确保同一会话的请求发送到同一渠道
- 可视化配置：添加、编辑、删除渠道，拖拽调整优先级
- 安全存储：API Key 脱敏显示，配置本地加密存储
- PM2 集成：基于 PM2 进程管理，稳定可靠
- 持久化运行：启动后可关闭终端，服务持续运行
- 开机自启：支持系统启动时自动启动服务
- 日志管理：统一日志存储，支持实时查看和清理
- 状态监控：随时查看后台服务运行状态
- 健康检查：
ct doctor一键诊断系统健康状态- Node.js 版本兼容性检查
- 配置文件完整性验证
- 端口占用情况检测
- 磁盘空间监控
- 日志管理：
ct logs查看和管理各类日志- 支持按类型筛选（UI/Claude/Codex/Gemini）
- 实时跟踪模式（--follow）
- 灵活的行数控制
- 使用统计：
ct stats查看详细统计信息- 会话数量和分布
- Token 使用情况
- API 调用统计
- WebSocket 推送：实时查看 API 请求详情
- Token 统计：输入/输出/缓存写入/缓存命中分类统计
- 成本估算：基于自定义价格计算 API 调用成本
多渠道负载均衡配置
- 在 Web UI 的渠道管理中添加多个渠道
- 点击渠道卡片上的「启用」按钮，启用需要参与负载均衡的渠道
- 设置每个渠道的权重（1-100），权重越高获得的请求越多
- 设置每个渠道的最大并发数，控制同时处理的请求数量
- 启动代理后，系统自动按权重分配请求到各个启用的渠道
提示：渠道出现问题时会自动冻结，恢复后自动解冻，无需人工干预
后台运行服务
- 使用
ct daemon start启动后台服务 - 服务启动后，可以安全关闭终端窗口
- 使用
ct daemon status随时查看运行状态 - 使用
ct daemon logs查看实时日志
优势：无需保持终端窗口打开，服务持久运行
系统诊断
遇到问题时，首先运行 ct doctor 进行全面诊断：
ct doctor诊断工具会自动检查：
- Node.js 版本是否兼容
- 配置文件是否正常
- 端口是否被占用
- 磁盘空间是否充足
并提供针对性的修复建议。
日志管理
查看实时日志，排查问题：
# 实时跟踪所有日志
ct logs --follow
# 查看 Claude 代理日志的最后 100 行
ct logs claude --lines 100
# 清空所有日志文件
ct logs --clear全局搜索
- 在任意页面按
⌘/Ctrl + K - 输入关键词搜索所有项目的会话内容
- 点击搜索结果直接启动对话
渠道管理
- 在渠道列表中点击「启用/禁用」按钮切换渠道状态
- 启用的渠道会自动参与负载均衡
- 可以随时调整权重和并发数，实时生效
- 渠道健康状态异常时可点击「重置」恢复
注意：使用
ct daemon start后台运行时，渠道变更会实时生效
Fork 会话
- 在会话列表中点击 Fork 按钮
- 新会话继承原会话的所有历史消息
- 可以基于相同上下文探索不同方向
如何后台运行服务？
使用 ct daemon start 启动后台服务，基于 PM2 进程管理，启动后可以安全关闭终端窗口。
查看状态：ct daemon status
查看日志：ct daemon logs
停止服务：ct daemon stop
后台服务如何开机自启？
在 Web UI 的设置中，开启"开机自启"选项，或使用 API：
ct daemon start
# 然后在 Web UI 设置中启用开机自启如何查看运行日志？
使用 ct logs 命令：
ct logs # 查看所有日志
ct logs claude # 查看 Claude 代理日志
ct logs --follow # 实时跟踪日志
ct logs --clear # 清空日志日志文件存储在 ~/.claude/logs/ 目录。
遇到问题如何诊断？
运行 ct doctor 进行系统诊断，会自动检查：
- Node.js 版本
- 配置文件
- 端口占用
- 磁盘空间
- 进程状态
并提供针对性的修复建议。
如何配置多渠道负载均衡？
- 添加多个渠道到系统
- 启用需要参与负载均衡的渠道
- 为每个渠道设置权重和最大并发数
- 启动代理，系统自动按权重分配请求
渠道出现问题时会自动冻结，恢复后自动解冻。
动态切换不生效？
1.6.0 版本后，不再需要手动切换"默认渠道"。系统会自动在所有启用的渠道间进行负载均衡。
确保至少有一个渠道处于启用状态，代理启动后会自动使用。
实时日志不显示？
实时日志需要先开启「动态切换」功能，代理服务运行后才能捕获请求。
推荐使用 ct daemon start 后台运行，然后通过 ct logs --follow 查看实时日志。
如何备份配置？
直接复制以下目录即可备份所有配置和数据：
- 配置：
~/.claude/cc-tool/ - 日志：
~/.claude/logs/
查看完整更新日志：CHANGELOG.md
欢迎提交 Issue 和 Pull Request！
MIT License © 2025 CooperJiang
如果这个项目对你有帮助，请给它一个 Star ⭐
