v1.0.0 · 稳定运行中

Claude Code Claude Code Claude Code
Web UI

在浏览器中体验 Claude Code 的强大能力。
零控制台窗口,纯静默启动,无缝集成。

⚡ 快速开始 查看源码
3001
默认端口
4
启动链路层级
0ms
无窗口延迟
SCROLL

Claude Code
带入浏览器

基于 @cloudcli-ai/cloudcli 的 Windows 封装。提供浏览器端的 Claude Code 交互体验,完全无控制台窗口,可通过 VBS 静默启动。

VBS
启动脚本
EXE
launcher.exe
DLL
CreateProcess
DETACHED
NODE
看门狗
CLI
CloudCLI
Server

不止是 Web 界面

静默启动

VBS + launcher.exe 组合实现完全无窗口启动,系统托盘中无感运行。

P/Invoke
🛡️

DETACHED_PROCESS

使用 Windows CreateProcess + DETACHED_PROCESS 标志,彻底消灭 conhost.exe 泄漏。

Win32 API
🔄

自动重启看门狗

服务器崩溃或升级后自动重启,带日志轮转和双日志文件(看门狗 + 服务器),永不丢日志。

Watchdog
🌐

局域网访问

一键脚本添加防火墙规则,同一局域网内的设备(Windows / Mac / 手机)均可访问。

Firewall
📦

一键更新

Web UI 设置页点击更新,或命令行 npm install @cloudcli-ai/cloudcli@latest 即可。

NPM
🔐

安全认证

默认 admin / admin123 账号,支持 Web Push 通知和数据库持久化。

Auth

60 秒跑起来

只需两步,即可启动 Claude Code Web UI 服务。

terminal
$ cd claudecli2ui
$ npm install
✔ dependencies installed
$ npm start
═══════════════════════════════════
CloudCLI Server - Ready
Server URL: http://localhost:3001
$
01

安装依赖

项目根目录执行 npm install 安装 @cloudcli-ai/cloudcli 及依赖。

02

启动服务

双击 start-claudecodeui.vbs 静默启动,或 npm start 前台启动。

03

打开浏览器

访问 http://localhost:3001,默认账号 admin / admin123

04

重启 / 更新

双击 restart-claudecodeui.vbs 静默重启。
升级 CloudCLI:npm install @cloudcli-ai/cloudcli@latest

启动链路 详解

📜
VBS
start-claudecodeui.vbs
⚙️
launcher.exe
Windows GUI 应用
🔗
CreateProcess
DETACHED_PROCESS
🟢
node.exe
watch-restart.js
🌐
CloudCLI Server
localhost:3001
看门狗
watch-restart.js
听不到控制台,日志写文件。 崩了就重启,永远不掉线。
进程隔离
P/Invoke CreateProcess
启动时不继承控制台。 CREATE_NO_WINDOW 无窗口标志。
日志系统
server.log + watch-restart.log
自动轮转,超过 50MB / 5MB 自动重命名。不丢日志历史。
🔧 优化说明: 最新版本修复了启动竞态问题 —— 增加了 启动锁 防止并发 startServer() 调用, 端口等待 机制确保旧进程释放端口后才启动新进程, 以及 日志轮转 防止日志文件无限增长。

项目 一览

文件名说明类型
start-claudecodeui.vbs静默启动脚本,无窗口后台运行启动
restart-claudecodeui.vbs静默重启脚本,一键杀掉旧进程并重启启动
launcher.cs / launcher.exeC# P/Invoke 启动器,CreateProcess + DETACHED_PROCESS核心
watch-restart.js看门狗进程,监控崩溃和包更新,自动重启守护
start.bat / restart.bat批处理快捷启动 / 重启启动
enable-lan-access.bat添加防火墙规则,开启局域网访问网络
package.json项目配置,依赖 @cloudcli-ai/cloudcli核心
server.log / watch-restart.log服务器日志 / 看门狗日志,自动轮转日志