H CLIer 使用教程

本文档详细介绍 H CLIer 的各项功能和使用方法。

界面概览

┌─────────────────────────────────────────────────────────────┐
│  H CLIer - Claude Code 管理工具                              │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────┐  ┌──────────────────────────────────────────┐ │
│  │ 侧边栏  │  │  终端面板                                │ │
│  │         │  │  > claude --session-id xxx               │ │
│  │ 会话 1  │  │  > 帮我优化这段代码...                    │ │
│  │ 会话 2  │  │  > ✅ 已完成优化                          │ │
│  │ 会话 3  │  │                                          │ │
│  │         │  │  [Token: 1,234 | 费用: $0.05]            │ │
│  └─────────┘  └──────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

快速开始

1. 创建会话

点击左侧边栏的 "+" 按钮
选择"新建 Claude 会话"
输入会话标题
选择项目目录
点击"创建"

2. 使用终端

创建会话后，会自动打开终端面板：

输入问题或指令，Claude 会自动回答
使用 Ctrl+C 复制选中内容或中断操作
终端支持 256 色和 Unicode

3. 切换会话

使用 Ctrl+K 打开命令面板
输入会话名称搜索
按回车切换到选中的会话

核心功能

1. 多会话管理

创建会话

点击侧边栏 "+" 按钮
选择会话类型（Claude 会话 / 终端会话）
输入标题和项目目录

管理会话

拖拽排序：拖拽会话调整顺序
收藏标记：右键会话 → 收藏
颜色标签：右键会话 → 更改颜色
重命名：右键会话 → 重命名
删除：右键会话 → 删除（移入回收站）

工作区

右键侧边栏空白处 → 新建工作区
将会话拖拽到工作区中
工作区可以折叠/展开

回收站

点击侧边栏底部的回收站图标
可以恢复或永久删除会话

2. 终端仿真

基本操作

输入：直接在终端中输入
复制：选中文本后 Ctrl+C
粘贴：Ctrl+V
中断：未选中文本时 Ctrl+C 发送中断信号

终端历史

关闭会话后，终端输出会保存到日志
重新打开会话时，会自动恢复历史输出
历史记录存储在 %APPDATA%/com.hcl-ier.dev/terminal_logs/

多终端

可以同时打开多个终端会话
每个会话独立的 PTY 实例
互不干扰

3. Token 用量追踪

查看统计

点击顶部工具栏的 "📊" 图标
选择时间范围（今日/本周/本月）
查看按模型分类的 Token 消耗

功能特点

按模型计费：Opus、Sonnet、Haiku 分别统计
趋势图：7 天 Token 消耗趋势
热力图：6 个月活跃度热力图
费用估算：根据 Token 数量估算费用

数据来源

Token 统计基于 Claude 的 JSONL 会话文件解析：

文件位置：~/.claude/projects/ 目录下
增量扫描：只扫描新增的内容
实时更新：会话结束后自动更新统计

4. 项目检查点

创建检查点

点击顶部工具栏的 "📸" 图标
输入检查点描述
点击"创建"

查看检查点

点击 "📸" 图标打开检查点列表
查看每个检查点的创建时间和描述
查看变更的文件数量

Diff 对比

选择一个检查点
点击"查看 Diff"
查看文件变更详情
支持逐行对比

回滚

选择一个检查点
点击"回滚"
确认回滚操作
项目恢复到该检查点的状态

智能跳过

创建检查点时，以下目录会自动跳过：

.git/
node_modules/
target/
__pycache__/
dist/
build/

5. 聊天记录查看

打开聊天记录

点击会话标题旁的 "💬" 图标
查看该会话的完整聊天记录

功能特点

Markdown 渲染：支持代码块、表格、列表等
内容块识别：text、thinking、tool_use、tool_result
搜索过滤：支持关键词搜索
可折叠详情：tool_use 和 tool_result 可以折叠

快捷键

全局快捷键

快捷键	功能
`Ctrl+K`	打开命令面板
`Ctrl+Shift+T`	新建终端会话
`Ctrl+Shift+S`	创建检查点
`Ctrl+Shift+M`	查看聊天记录
`Ctrl+Shift+P`	打开设置
`Ctrl+Tab`	切换到下一个会话
`Ctrl+Shift+Tab`	切换到上一个会话
`Ctrl+W`	关闭当前会话

终端快捷键

快捷键	功能
`Ctrl+C`	复制选中 / 中断
`Ctrl+V`	粘贴
`Ctrl+A`	全选
`Ctrl+L`	清屏
`Ctrl+R`	搜索历史

命令面板快捷键

快捷键	功能
`↑` / `↓`	选择命令
`Enter`	执行命令
`Esc`	关闭面板

设置

打开设置

点击顶部工具栏的 "⚙️" 图标
或使用快捷键 Ctrl+Shift+P

设置选项

外观

主题：亮色 / 暗色 / 跟随系统
字体大小：终端字体大小
语言：界面语言（暂仅支持中文）

终端

编码：终端编码（默认 UTF-8）
滚动缓冲：终端历史行数
光标样式：块状 / 下划线 / 竖线

Claude CLI

自动检测：自动检测 Claude CLI 路径
自定义路径：手动指定 Claude CLI 路径

网络

代理设置：HTTP/SOCKS5 代理
超时时间：请求超时时间

高级

日志级别：调试 / 信息 / 警告 / 错误
数据目录：数据存储位置

常见问题

Q1：Claude CLI 未检测到

解决方法：

确保已安装 Claude Code CLI
检查 PATH 环境变量
在设置中手动指定路径

Q2：终端显示乱码

解决方法：

打开设置
选择"终端"选项卡
将编码设置为 "UTF-8"

Q3：Token 统计不准确

可能原因：

Claude 还在写入 JSONL 文件
文件路径配置错误
需要手动刷新

Q4：检查点创建失败

可能原因：

磁盘空间不足
文件被占用
权限不足

Q5：应用启动缓慢

优化方法：

减少开机自启项
使用 SSD 硬盘
保持软件更新

数据存储位置

应用数据存储在 %APPDATA%/com.hcl-ier.dev/：

%APPDATA%/com.hcl-ier.dev/
├── sessions.db              # 会话数据库
├── config/                  # 配置文件
│   └── config.json
├── terminal_logs/           # 终端历史日志
│   └── {session_id}_history.log
├── checkpoints/             # 检查点快照
│   └── {session_id}/
│       └── {checkpoint_id}/
└── web_access_token         # Web 访问令牌

获取帮助

GitHub Issues：https://github.com/Fancyhe1/H-CLIer/issues
文档：docs/
更新日志：CHANGELOG.md

最后更新：2026-07-12