CloudCLI UI 如何用 npx 快速启动并确认现有 Claude Code 会话被自动发现

CloudCLI UI 如何用 npx 快速启动并确认现有 Claude Code 会话被自动发现【免费下载链接】claudecodeuiUse Claude Code, OpenCode, Cursor CLI, and Codex on mobile and web with CloudCLI (aka Claude Code UI). CloudCLI is a free open source webui/GUI that helps you manage your Claude Code session and projects remotely.项目地址: https://gitcode.com/GitHub_Trending/cl/claudecodeui如果你本机上已经通过 Claude Code 跑过一些会话想不动现有配置、不迁移数据直接在浏览器里看到并接管这些会话CloudCLI UI即 Cloud Code UI可以完成这件事用npx cloudcli-ai/cloudcli在本机自托管模式启动服务打开http://localhost:3001服务会自动从~/.claude目录发现你所有已存在的 Claude Code 会话并出现在侧边栏。适用前提是本机已安装Node.js v22并且 Claude Code 的转录文件位于默认的~/.claude/projects下。启动前确认两个条件自动发现依赖的是 Claude Code 原生写盘的转录文件不依赖任何 CloudCLI 特有的导出。按 Providers 模块文档 的说明Claude 会话同步的扫描根目录是~/.claude/projects/**/*.jsonl会话标题取自~/.claude/history.jsonl。因此只要你的 Claude Code 会话是正常在本机终端里运行的转录文件就会落在这个位置。如果 Claude CLI 路径不在默认位置可以用环境变量CLAUDE_CLI_PATH指定这会在cloudcli status的输出中显示默认值为claude。用 npx 启动服务在任意目录下执行npx cloudcli-ai/cloudcli这是 README Quick Start 中给出的自托管Self-Hosted / npm路径要求 Node.js v22。命令会在前台启动服务默认监听3001端口。如果 3001 端口被占用文档给出的改端口方式是--port参数或环境变量来自 CLI 帮助文本见 cli.service.tscloudcli --port 8080环境变量SERVER_PORT或旧式的PORT同样生效默认值都是 3001。确认现有会话被自动发现服务启动后打开http://localhost:3001。README 对该结果的表述是all your existing sessions are discovered automatically——所有已有会话会被自动发现无需任何导入操作。具体到验证方式可以按两条线核对界面上登录后项目/会话列表中应出现 Claude Code 在本机产生过的会话。侧边栏的会话条目是由服务端的session_upserted事件驱动的不需要手动刷新。数据源上可选使用全局安装时cloudcli status会打印一条 Claude Projects Folder 状态检查~/.claude/projects目录是否存在Claude Projects Folder: ~/.claude/projects Status: [OK] Exists输出为[OK] Exists说明发现机制能读到转录文件如果是[WARN] Not found说明这台机器上没有 Claude Code 的转录目录界面上自然不会有 Claude Code 会话可发现。注意status是全局安装npm install -g cloudcli-ai/cloudcli后使用cloudcli命令提供的子命令纯npx前台运行时以浏览器中能否看到会话为准。自动发现是怎么工作的这部分解释了为什么不需要配置也说明了新会话何时会出现在界面上。依据 会话交接架构文档服务启动并打开 UI 时会触发一次全量扫描/api/projects与/api/projects/archived共享同一次扫描把~/.claude/projects/**/*.jsonl里已有的转录全部索引进会话数据库。所以在应用外创建的会话首次进入界面就会出现在列表里。之后由sessions-watcher.service.ts用 chokidar 以轮询模式6 秒间隔持续监视各 provider 的会话目录只保留*.jsonl文件检测到变化后以 500 ms 防抖、最多等待 2 s 的时间窗口批量广播session_upserted侧边栏实时更新。在应用外新建的会话其数据库行满足session_id provider_session_id而在 CloudCLI UI 内发起的会话重新索引时会按provider_session_id匹配已有行原地更新而不是产生重复条目。打开一个旧会话直接发送消息就是一次普通恢复resume网关从数据库行里读出 provider、cwd和provider_session_id由运行时解析出原生 id 并继续对话不需要任何特殊入口。限制与边界自动发现面向本机~/.claude目录下的 Claude Code 转录文件其他 providerCodex、Cursor CLI、OpenCode各有自己的扫描目录但本文只涉及 Claude Code。自托管模式下服务随机器进程存活文档对比表中明确 Machine needs to stay on: Yes即机器必须保持开机服务才持续可用。Claude Code 工具默认全部禁用README 的 Security 部分说明这不影响会话发现但如果你发现界面上无法使用工具需要在侧边栏齿轮图标打开的 Tools Settings 里逐项开启。会话标题依赖~/.claude/history.jsonl做名称查找文档未说明该文件缺失时的降级行为若标题显示异常可先确认该文件存在。完成以上步骤后判断标准只有一条浏览器http://localhost:3001的会话列表中出现你本机已有的 Claude Code 会话且点开能正常查看、继续对话。【免费下载链接】claudecodeuiUse Claude Code, OpenCode, Cursor CLI, and Codex on mobile and web with CloudCLI (aka Claude Code UI). CloudCLI is a free open source webui/GUI that helps you manage your Claude Code session and projects remotely.项目地址: https://gitcode.com/GitHub_Trending/cl/claudecodeui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考