@@ -4,8 +4,10 @@ Claude Code 请求监控系统,实时捕获并可视化展示 Claude Code 的
44最新版本的 CC-Viewer 还提供了服务器部署web编程的方案,以及移动端编程的工具。欢迎大家在自己的项目中应用,未来也将开放更多插件功能,支持云端部署。
55
66先看有趣的部分,你可以在移动端上看到:
7+
78<img width =" 1700 " height =" 790 " alt =" image " src =" https://github.com/user-attachments/assets/da3e519f-ff66-4cd2-81d1-f4e131215f6c " />
8- (当前版本IOS兼容不是很好,2026.04.01 会针对IOS做优化)
9+
10+ <font color =" #999 " >(当前版本IOS兼容不是很好,2026.04.01 会针对IOS做优化)</font >
911
1012[ English] ( ../README.md ) | [ 繁體中文] ( ./README.zh-TW.md ) | [ 한국어] ( ./README.ko.md ) | [ 日本語] ( ./README.ja.md ) | [ Deutsch] ( ./README.de.md ) | [ Español] ( ./README.es.md ) | [ Français] ( ./README.fr.md ) | [ Italiano] ( ./README.it.md ) | [ Dansk] ( ./README.da.md ) | [ Polski] ( ./README.pl.md ) | [ Русский] ( ./README.ru.md ) | [ العربية] ( ./README.ar.md ) | [ Norsk] ( ./README.no.md ) | [ Português (Brasil)] ( ./README.pt-BR.md ) | [ ไทย] ( ./README.th.md ) | [ Türkçe] ( ./README.tr.md ) | [ Українська] ( ./README.uk.md )
1113
@@ -17,12 +19,6 @@ Claude Code 请求监控系统,实时捕获并可视化展示 Claude Code 的
1719npm install -g cc-viewer --registry=https://registry.npmjs.org
1820```
1921
20- ### 监控模式(这个模式下面启动claude 或者 claude --dangerously-skip-permissions 会自动启动一个日志进程帮忙记录请求报文)
21-
22- ``` bash
23- ccv
24- ```
25-
2622### 编程模式
2723
2824== claude
@@ -43,6 +39,18 @@ ccv -d
4339
4440以及看上去更性感的,你甚至可以用移动端编程!
4541
42+
43+ ### 日志模式
44+
45+ ⚠️如果你仍然习惯使用claude 原生工具,或者VS code插件,请使用该模式
46+ 这个模式下面启动claude 或者 claude --dangerously-skip-permissions 会自动启动一个日志进程帮忙记录请求报文
47+
48+ ``` bash
49+ ccv
50+ ```
51+
52+ 在控制台无法打印具体端口的时候,默认第一个启动端口是127.0.0.1:7008。同时存在多个末尾顺延,如7009、7010
53+
4654该命令会自动检测本地 Claude Code 的安装方式(NPM 或 Native Install)并进行适配。
4755
4856- ** NPM 安装** :自动向 Claude Code 的 ` cli.js ` 中注入拦截脚本。
@@ -61,16 +69,17 @@ ccv -d
6169
6270以上指令完成后,会更新findcc.js。如果你的项目工程经常需要本地部署。或者fork出去的代码要经常解决安装问题,保留这个文件就可以。下次直接copy 文件。现阶段很多项目和公司用claude code都不是mac部署,而是服务端托管部署,所以作者剥离了findcc.js 这个文件,方便后续跟踪cc-viewer的源代码更新。
6371
64- ### 卸载
72+ ### 日志模式的卸载
6573
6674``` bash
6775ccv --uninstall
6876```
6977
70- ### 检查版本
78+ ### 其他辅助指令
7179
80+ 查阅
7281``` bash
73- ccv -v
82+ ccv -h
7483```
7584
7685### 配置覆盖 (Configuration Override)
@@ -86,7 +95,29 @@ ccv -v
8695
8796## 功能
8897
89- ### 请求监控(原文模式)
98+
99+ ### 编程模式
100+
101+ 在使用 ccv -c 或者 ccv -d 启动以后可以看见:
102+
103+ <img width =" 1500 " height =" 725 " alt =" image " src =" https://github.com/user-attachments/assets/a64a381e-5a68-430c-b594-6d57dc01f4d3 " />
104+
105+ 你可以直接在在编辑完成以后直接查看代码diff:
106+
107+ <img width =" 1500 " height =" 728 " alt =" image " src =" https://github.com/user-attachments/assets/2a4acdaa-fc5f-4dc0-9e5f-f3273f0849b2 " />
108+
109+ 虽然你可以打开文件手动编程,但是并不推荐使用手动编程,那是古法编程!
110+
111+ ### 移动端编程
112+
113+ 你甚至可以扫码,实现在移动端设备上编程:
114+
115+ <img width =" 3018 " height =" 1460 " alt =" image " src =" https://github.com/user-attachments/assets/8debf48e-daec-420c-b37a-609f8b81cd20 " />
116+
117+ 满足你对移动端编程的想象,另外还有插件机制,如果你需要针对自己的编程习惯定制,后续可以跟进插件的hooks更新。
118+
119+ ### 日志模式(查看claude code 完整会话)
120+
90121<img width =" 1500 " height =" 720 " alt =" image " src =" https://github.com/user-attachments/assets/519dd496-68bd-4e76-84d7-2a3d14ae3f61 " />
91122
92123- 实时捕获 Claude Code 发出的所有 API 请求,确保是原文,而不是被阉割之后的日志(这很重要!!!)
@@ -98,6 +129,7 @@ ccv -v
98129### 对话模式
99130
100131点击右上角「对话模式」按钮,将 Main Agent 的完整对话历史解析为聊天界面:
132+
101133<img width =" 1500 " height =" 730 " alt =" image " src =" https://github.com/user-attachments/assets/c973f142-748b-403f-b2b7-31a5d81e33e6 " />
102134
103135- 暂不支持Agent Team的展示
@@ -108,27 +140,10 @@ ccv -v
108140- 设置面板:可切换工具结果和思考块的默认折叠状态
109141- 手机端对话浏览:在手机端 CLI 模式下,点击顶部栏的「对话浏览」按钮,即可滑出只读对话视图,在手机上浏览完整对话历史
110142
111- ### 编程模式
112-
113- 在使用 ccv -c 或者 ccv -d 启动以后可以看见:
114- <img width =" 1500 " height =" 725 " alt =" image " src =" https://github.com/user-attachments/assets/a64a381e-5a68-430c-b594-6d57dc01f4d3 " />
115-
116- 你可以直接在在编辑完成以后直接查看代码diff:
117- <img width =" 1500 " height =" 728 " alt =" image " src =" https://github.com/user-attachments/assets/2a4acdaa-fc5f-4dc0-9e5f-f3273f0849b2 " />
118-
119- 虽然你可以打开文件手动编程,但是并不推荐使用手动编程,那是古法编程!
120-
121- ### 移动端编程
122-
123- 你甚至可以扫码,实现在移动端设备上编程:
124- <img width =" 3018 " height =" 1460 " alt =" image " src =" https://github.com/user-attachments/assets/8debf48e-daec-420c-b37a-609f8b81cd20 " />
125-
126- 满足你对移动端编程的想象,另外还有插件机制,如果你需要针对自己的编程习惯定制,后续可以跟进插件的hooks更新。
127-
128-
129143### 统计工具
130144
131145Header 区域的「数据统计」悬浮面板:
146+
132147<img width =" 1500 " height =" 729 " alt =" image " src =" https://github.com/user-attachments/assets/b23f9a81-fc3d-4937-9700-e70d84e4e5ce " />
133148
134149- 显示 cache creation/read 数量及缓存命中率
@@ -140,6 +155,7 @@ Header 区域的「数据统计」悬浮面板:
140155### 日志管理
141156
142157通过左上角 CC-Viewer 下拉菜单:
158+
143159<img width =" 1200 " height =" 672 " alt =" image " src =" https://github.com/user-attachments/assets/8cf24f5b-9450-4790-b781-0cd074cd3b39 " />
144160
145161- 导入本地日志:浏览历史日志文件,按项目分组,在新窗口打开
@@ -149,18 +165,18 @@ Header 区域的「数据统计」悬浮面板:
149165- 查看用户 Prompt:提取并展示所有用户输入,支持三种查看模式 — 原文模式(原始内容)、上下文模式(系统标签可折叠)、Text 模式(纯文本);斜杠命令(` /model ` 、` /context ` 等)作为独立条目展示;命令相关标签自动从 Prompt 内容中隐藏
150166- 导出 Prompt 为 TXT:将用户 Prompt(纯文本,不含系统标签)导出为本地 ` .txt ` 文件
151167
152- ### 多语言支持
153-
154- CC-Viewer 支持 18 种语言,根据系统语言环境自动切换:
155-
156- 简体中文 | English | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська
157-
158168### 自动更新
159169
160170CC-Viewer 启动时自动检查更新(每 4 小时最多一次)。同一大版本内(如 1.x.x → 1.y.z)自动更新,下次启动生效。跨大版本仅显示通知提示。
161171
162172自动更新跟随 Claude Code 全局配置 ` ~/.claude/settings.json ` 。如果 Claude Code 禁用了自动更新(` autoUpdates: false ` ),CC-Viewer 也会跳过自动更新。
163173
174+ ### 多语言支持
175+
176+ CC-Viewer 支持 18 种语言,根据系统语言环境自动切换:
177+
178+ 简体中文 | English | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська
179+
164180## License
165181
166182MIT
0 commit comments