Vibe Coding 增强工作助手 - 智能会话管理、动态渠道切换、全局搜索、实时监控
npm install @adversity/coding-tool-x
Claude Code / Codex / Gemini CLI 增强工具
智能会话管理 | 多渠道动态切换 | 实时 Token 监控






现代化 Web 界面 - 项目管理、会话浏览、实时日志监控
---
| 功能 | 描述 |
|------|------|
| 智能会话管理 | 自动识别 Claude/Codex/Gemini 历史会话,支持命名、搜索、Fork 分支 |
| 多渠道负载均衡 | 同时启用多个渠道,按权重自动分配请求,支持并发控制和健康检查 |
| 动态渠道切换 | 管理多个 API 渠道,一键切换无需重启,成本优化与稳定性兼得 |
| 模型智能重定向 | 代理模式下自动将高成本模型重定向到低成本模型(如 opus → sonnet),大幅节省 token 消耗 |
| 实时 Token 监控 | 可视化展示每次请求的 Token 消耗(输入/输出/缓存命中) |
| 全局搜索 | ⌘/Ctrl + K 跨项目搜索会话内容,快速定位历史对话 |
| 现代化 Web UI | 响应式设计,支持亮色/暗色主题,三列拖拽排序 |
---
``bash`
npm install -g coding-tool-x
`bash`
git clone https://github.com/ZeaoZhang/coding-tool.git
cd cc-tool
npm install && npm link
`bash`
ctx --version
---
`bash`
ctx ui
浏览器自动打开 http://localhost:9999,即可开始管理会话和渠道。
`bash`
ctx
启动交互式菜单,通过键盘完成会话管理和渠道切换。
---
| 命令 | 描述 |
|------|------|
| ctx | 启动交互式命令行界面 |ctx ui
| | 启动 Web UI 管理界面 |ctx update
| | 检查并更新到最新版本 |ctx --version
| | 显示版本号 |ctx --help
| | 显示帮助信息 |
| 命令 | 描述 |
|------|------|
| ctx proxy start | 启动代理服务(动态切换渠道) |ctx proxy stop
| | 停止代理服务 |ctx proxy status
| | 查看代理运行状态 |
| 命令 | 描述 |
|------|------|
| ctx daemon start | 后台启动服务(可关闭终端) |ctx daemon stop
| | 停止后台服务 |ctx daemon restart
| | 重启后台服务 |ctx daemon status
| | 查看后台服务状态 |ctx daemon logs
| | 查看 PM2 运行日志 |
| 命令 | 描述 |
|------|------|
| ctx logs | 查看所有日志 |ctx logs ui
| | 查看 Web UI 日志 |ctx logs claude
| | 查看 Claude 代理日志 |ctx logs codex
| | 查看 Codex 代理日志 |ctx logs gemini
| | 查看 Gemini 代理日志 |ctx logs --follow
| | 实时跟踪日志输出 |ctx logs --lines 100
| | 显示最后 100 行日志 |ctx logs --clear
| | 清空所有日志文件 |
| 命令 | 描述 |
|------|------|
| ctx doctor | 运行系统诊断,检查配置和环境 |ctx stats
| | 查看使用统计(会话数、Token 等) |ctx reset
| | 重置配置文件 |
---
- 多平台支持:统一管理 Claude Code、Codex CLI、Gemini CLI 的会话
- 会话别名:为会话设置易记的名称,方便识别
- Fork 会话:基于现有对话创建分支,探索不同方向
- 快速启动:一键在终端中恢复历史会话
- 多渠道负载均衡:同时启用多个渠道,系统自动按权重分配请求
- 权重配置:为每个渠道设置权重(1-100),高权重渠道获得更多流量
- 并发控制:为每个渠道设置最大并发数,精细控制负载
- 健康检查:自动检测渠道状态,问题渠道自动冻结和恢复
- 会话绑定:可选开启,确保同一会话的请求发送到同一渠道
- 可视化配置:添加、编辑、删除渠道,拖拽调整优先级
- 安全存储:API Key 脱敏显示,配置本地加密存储
- PM2 集成:基于 PM2 进程管理,稳定可靠
- 持久化运行:启动后可关闭终端,服务持续运行
- 开机自启:支持系统启动时自动启动服务
- 日志管理:统一日志存储,支持实时查看和清理
- 状态监控:随时查看后台服务运行状态
- 健康检查:ctx doctor 一键诊断系统健康状态ctx logs
- Node.js 版本兼容性检查
- 配置文件完整性验证
- 端口占用情况检测
- 磁盘空间监控
- 日志管理: 查看和管理各类日志ctx stats
- 支持按类型筛选(UI/Claude/Codex/Gemini)
- 实时跟踪模式(--follow)
- 灵活的行数控制
- 使用统计: 查看详细统计信息
- 会话数量和分布
- Token 使用情况
- API 调用统计
- WebSocket 推送:实时查看 API 请求详情
- Token 统计:输入/输出/缓存写入/缓存命中分类统计
- 成本估算:基于自定义价格计算 API 调用成本
---
多渠道负载均衡配置
1. 在 Web UI 的渠道管理中添加多个渠道
2. 点击渠道卡片上的「启用」按钮,启用需要参与负载均衡的渠道
3. 设置每个渠道的权重(1-100),权重越高获得的请求越多
4. 设置每个渠道的最大并发数,控制同时处理的请求数量
5. 启动代理后,系统自动按权重分配请求到各个启用的渠道
> 提示:渠道出现问题时会自动冻结,恢复后自动解冻,无需人工干预
模型智能重定向(节省 Token)
在代理模式下,可以将高成本模型自动重定向到低成本模型,大幅节省 token 消耗。
使用场景:
- GitHub 插件或 oh-my-claudecode skills 默认使用 opus 模型
- 修改插件配置过于复杂,希望透明地降低成本
配置步骤:
1. 启动代理:ctx proxy startclaude-sonnet-4-5
2. 在 Web UI 中编辑渠道,展开「模型重定向」部分
3. 配置重定向规则,例如:
- Opus 重定向 → (将所有 opus 请求重定向到 sonnet)
- Sonnet 重定向 → 留空(保持不变)
- Haiku 重定向 → 留空(保持不变)
4. 保存配置,重定向立即生效
成本节省示例:
- Opus → Sonnet:节省约 80% 成本($15/M → $3/M 输入,$75/M → $15/M 输出)
- 对于大量使用 opus 的场景,成本节省非常显著
验证重定向:
- 查看代理服务器控制台,会输出重定向日志:
``
[Model Redirect] claude-opus-4-20250514 → claude-sonnet-4-5 (channel: xxx)
> 注意:模型重定向仅在代理开启时生效。代理关闭时,modelConfig 用于模型映射(写入 settings.json)。
详细文档:docs/model-redirection.md
后台运行服务
1. 使用 ctx daemon start 启动后台服务ctx daemon status
2. 服务启动后,可以安全关闭终端窗口
3. 使用 随时查看运行状态ctx daemon logs
4. 使用 查看实时日志
> 优势:无需保持终端窗口打开,服务持久运行
系统诊断
遇到问题时,首先运行 ctx doctor 进行全面诊断:
`bash`
ctx doctor
诊断工具会自动检查:
- Node.js 版本是否兼容
- 配置文件是否正常
- 端口是否被占用
- 磁盘空间是否充足
并提供针对性的修复建议。
日志管理
查看实时日志,排查问题:
`bash实时跟踪所有日志
ctx logs --follow
全局搜索
1. 在任意页面按
⌘/Ctrl + K
2. 输入关键词搜索所有项目的会话内容
3. 点击搜索结果直接启动对话
渠道管理
1. 在渠道列表中点击「启用/禁用」按钮切换渠道状态
2. 启用的渠道会自动参与负载均衡
3. 可以随时调整权重和并发数,实时生效
4. 渠道健康状态异常时可点击「重置」恢复
> 注意:使用
ctx daemon start 后台运行时,渠道变更会实时生效
Fork 会话
1. 在会话列表中点击 Fork 按钮
2. 新会话继承原会话的所有历史消息
3. 可以基于相同上下文探索不同方向
---
❓ 常见问题
如何后台运行服务?
使用
ctx daemon start 启动后台服务,基于 PM2 进程管理,启动后可以安全关闭终端窗口。查看状态:
ctx daemon status
查看日志:ctx daemon logs
停止服务:ctx daemon stop
后台服务如何开机自启?
在 Web UI 的设置中,开启"开机自启"选项,或使用 API:
`bash
ctx daemon start
然后在 Web UI 设置中启用开机自启
`
如何查看运行日志?
使用
ctx logs 命令:`bash
ctx logs # 查看所有日志
ctx logs claude # 查看 Claude 代理日志
ctx logs --follow # 实时跟踪日志
ctx logs --clear # 清空日志
`日志文件存储在
~/.claude/logs/ 目录。
遇到问题如何诊断?
运行
ctx doctor 进行系统诊断,会自动检查:
- Node.js 版本
- 配置文件
- 端口占用
- 磁盘空间
- 进程状态并提供针对性的修复建议。
如何配置多渠道负载均衡?
1. 添加多个渠道到系统
2. 启用需要参与负载均衡的渠道
3. 为每个渠道设置权重和最大并发数
4. 启动代理,系统自动按权重分配请求
渠道出现问题时会自动冻结,恢复后自动解冻。
动态切换不生效?
1.6.0 版本后,不再需要手动切换"默认渠道"。系统会自动在所有启用的渠道间进行负载均衡。
确保至少有一个渠道处于启用状态,代理启动后会自动使用。
实时日志不显示?
实时日志需要先开启「动态切换」功能,代理服务运行后才能捕获请求。
推荐使用
ctx daemon start 后台运行,然后通过 ctx logs --follow 查看实时日志。
如何备份配置?
直接复制以下目录即可备份所有配置和数据:
- 配置:
~/.claude/cc-tool/
- 日志:~/.claude/logs/`---
权限模板增强
- ✨ 权限模板应用提示优化:未选择项目时提示"请选择一个项目",已选择项目时显示"已应用模板:{模板名}"
- ♻️ 移除内置/自定义模板区分:所有模板在界面上不再显示"内置"或"自定义"标签
- 🔓 允许编辑所有模板:内置模板现在可以编辑和删除,编辑后自动保存为自定义覆盖版本
- 🎨 简化模板显示:配置模板和权限模板下拉选项中不再显示"(内置)"后缀
查看完整更新日志:CHANGELOG.md
---
欢迎提交 Issue 和 Pull Request!
---
MIT License © 2026