Coding-Tool

Claude Code / Codex / Gemini CLI 增强工具

智能会话管理 | 多渠道动态切换 | 实时 Token 监控

现代化 Web 界面 - 项目管理、会话浏览、实时日志监控

npm install -g coding-tool

git clone https://github.com/CooperJiang/cc-tool.git
cd cc-tool
npm install && npm link

ct --version

ct ui

浏览器自动打开 http://localhost:9999，即可开始管理会话和渠道。

ct

启动交互式菜单，通过键盘完成会话管理和渠道切换。

• 多平台支持：统一管理 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 调用成本

1. 在 Web UI 的渠道管理中添加多个渠道
2. 点击渠道卡片上的「启用」按钮，启用需要参与负载均衡的渠道
3. 设置每个渠道的权重（1-100），权重越高获得的请求越多
4. 设置每个渠道的最大并发数，控制同时处理的请求数量
5. 启动代理后，系统自动按权重分配请求到各个启用的渠道

提示：渠道出现问题时会自动冻结，恢复后自动解冻，无需人工干预

1. 使用 ct daemon start 启动后台服务
2. 服务启动后，可以安全关闭终端窗口
3. 使用 ct daemon status 随时查看运行状态
4. 使用 ct daemon logs 查看实时日志

优势：无需保持终端窗口打开，服务持久运行

遇到问题时，首先运行 ct doctor 进行全面诊断：

ct doctor

诊断工具会自动检查：

• Node.js 版本是否兼容
• 配置文件是否正常
• 端口是否被占用
• 磁盘空间是否充足

并提供针对性的修复建议。

查看实时日志，排查问题：

# 实时跟踪所有日志
ct logs --follow

# 查看 Claude 代理日志的最后 100 行
ct logs claude --lines 100

# 清空所有日志文件
ct logs --clear

1. 在任意页面按 ⌘/Ctrl + K
2. 输入关键词搜索所有项目的会话内容
3. 点击搜索结果直接启动对话

1. 在渠道列表中点击「启用/禁用」按钮切换渠道状态
2. 启用的渠道会自动参与负载均衡
3. 可以随时调整权重和并发数，实时生效
4. 渠道健康状态异常时可点击「重置」恢复

注意：使用 ct daemon start 后台运行时，渠道变更会实时生效

1. 在会话列表中点击 Fork 按钮
2. 新会话继承原会话的所有历史消息
3. 可以基于相同上下文探索不同方向

使用 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. 添加多个渠道到系统
2. 启用需要参与负载均衡的渠道
3. 为每个渠道设置权重和最大并发数
4. 启动代理，系统自动按权重分配请求

渠道出现问题时会自动冻结，恢复后自动解冻。

1.6.0 版本后，不再需要手动切换"默认渠道"。系统会自动在所有启用的渠道间进行负载均衡。

确保至少有一个渠道处于启用状态，代理启动后会自动使用。

实时日志需要先开启「动态切换」功能，代理服务运行后才能捕获请求。

推荐使用 ct daemon start 后台运行，然后通过 ct logs --follow 查看实时日志。

直接复制以下目录即可备份所有配置和数据：

• 配置：~/.claude/cc-tool/
• 日志：~/.claude/logs/

查看完整更新日志：CHANGELOG.md

欢迎提交 Issue 和 Pull Request！

MIT License © 2025 CooperJiang