克劳德代码工作室
Claude Code CLI的浏览器界面。 与人工智能聊天、自动运行任务和管理项目——所有这些都可以在一个选项卡上完成。
英语 | 乌克兰语 | 俄语
📖 从终端到仪表板 | 远程访问革命
工作在 Windows、macOS和Linux --零平台特定设置。
______________________________________________________________________
为什么选择克劳德代码工作室?
Claude Code CLI功能强大——它编写代码、运行测试、编辑文件和发布功能。但它存在于终端中,终端有其局限性:会话之间的上下文丢失,并行工作意味着切换选项卡,并且无法对任务进行排队并退出。
Claude Code Studio修复了这个问题:
- 排队工作,然后离开 --看板+调度员。克劳德在你睡觉的时候工作。回到所做的一切。
- 随时随地控制 --电报机器人+远程访问。在健身房用手机查看成绩。
- 自主管道 --任务在执行过程中创建子任务。一个“检查问题”任务会自动生成修复任务。
- 上下文永远不会丢失 --SQLite支持的会话具有自我修复回放功能。几天后继续,就在你停止的地方。
- 真正的并行执行 --同一项目中同时运行多个任务。无需手动切换标签。
______________________________________________________________________
60秒内开始
先决条件: + 克劳德代码CLI 已安装并登录(Claude Pro或Max订阅)
Node.js 22.5+ --零本地编译。使用内置node:sqlite,不需要C++工具链。旧的Node.js版本回落到better-sqlite3(需要构建工具)。
npx github:Lexus2016/claude-code-studio打开 http://localhost:3000,设置密码,开始聊天。
Other install methods
更新:
npx github:Lexus2016/claude-code-studio@latest全局安装:
npm install -g github:Lexus2016/claude-code-studio克隆仓库:
git clone https://github.com/Lexus2016/claude-code-studio.git
cd claude-code-studio
npm install && node server.jsDocker:
git clone https://github.com/Lexus2016/claude-code-studio.git
cd claude-code-studio
cp .env.example .env
docker compose up -d --build
# Enterprise: pull base image from a private registry (Artifactory, Nexus, Harbor)
MIRROR=my-registry.company.com docker compose up -d --buildTroubleshooting: npm install from GitHub fails
一些npm版本(尤其是10.x)在安装git依赖项时失败,并出现以下错误:
npm error --prefer-online cannot be provided when using --prefer-offline这是一个已知的npm bug,在git依赖准备过程中传递了冲突的标志。
解决方法--手动安装:
git clone https://github.com/Lexus2016/claude-code-studio.git
cd claude-code-studio
npm install
npm install -g . # optional: register the `claude-code-studio` CLI command globally或者更新npm:
npm install -g npm@latest______________________________________________________________________
______________________________________________________________________
特性
💬 实时聊天
不是聊天机器人。“重构此函数并添加测试”→ Claude打开文件,编辑文件,运行测试,修复错误,实时报告。使用Ctrl+V粘贴屏幕截图。当克劳德在任务中途问问题时,你回答后,卡片会折叠成一个紧凑的药丸。击打 紧凑型&全新 通过俳句总结对话,并在新的会话中继续——所有上下文都保持不变,零令牌浪费。
侧边栏快速过滤器 --每个侧边栏部分(项目、聊天、MCP服务器、技能、命令)都有一个🔽 过滤器按钮。点击它,键入几个字母——列表会立即缩小。按Esc键清除。
Claude CLI会话导入 --从Claude Code CLI导入现有会话(~/.claude/projects/)直接进入工作室。点击↓ 在标题中单击按钮,选择项目路径,选择会话,导入。已导入的会话已被标记,因此您不会复制它们。适用于Windows(C:\...)macOS和Linux;支持 ~ 路径扩展。
延伸思维 --当克劳德使用扩展思维时,每个思维块都会显示为“思维链”徽章,显示估计的字数。单击以使用复制按钮在模式中打开完整的推理。CLI导入模式和思维模式完全本地化(EN/UA/RU)——所有标签、状态消息和日期都适应所选的界面语言。
思维障碍现在 完全持久:在第二代中期切换选项卡不再失去思路——它在完成时保存到SQLite。生活 思维徽章 当克劳德推理时,它会实时出现,这样你就可以观察到思维过程的展开。导入的CLI会话也保留了思维块,因此可以查看每个过去的推理跟踪。会话恢复也是正确的:在简历中发送回克劳德的上下文中排除了思维块,因此它永远不会将自己的内部推理视为先前的消息。按 退出 从键盘上关闭思维模式。
击打 翻译 在思维模式中,用你的界面语言呈现思维链——由克劳德·俳句提供支持,响应缓存,因此重新翻译是即时的。这 复制 按钮始终复制当前显示的任何内容(原始或翻译)。
任务中期中断 --发送澄清或新指令 *克劳德正在积极工作*,而不停止当前任务。小巧的 ⚡ Clarify Claude生成时,药丸出现在输入栏中——单击它可在两者之间切换 阐明 (注入流动流中)和 队列 (在当前任务完成后安排)。交货是 *保证* 通过a PreToolUse 钩子:Studio会拦截每个工具调用,并在Claude的下一个操作之前传递您的消息。徽章实时显示交付状态——克劳德读取徽章时显示“已交付”,如果任务在交付前完成,则显示“任务已结束”。 交付状态现在保存在SQLite中 --重新加载页面,几天后重新访问会话,历史记录中的每个中断都会正确显示它是到达克劳德还是过期。徽章状态与服务器对任务完成的权威计数相一致——在每种情况下都是正确的,包括多标签和错过的实时事件。当您切换UI语言时,药丸文本会立即更新,无需刷新页面。药丸是 SSH感知:它在远程SSH会话中保持隐藏状态(该功能不适用),并在从本地项目切换到SSH项目时立即消失——输入栏中没有过时的控件。
中断附件 --将文件、屏幕截图或SSH配置附加到任何中期任务说明中。Claude接收图像作为视觉内容(完整的多模式MCP块),文件作为可读路径,以及预先填充凭据的SSH配置。无需停止任务以共享上下文——所有内容都以相同的检查点交付方式到达。适用于web UI和Telegram。
速率限制自动等待 -当Claude的API以速率限制或过载(429)进行响应时,Studio会自动等待重置窗口并重试-无手动刷新,无丢失会话。聊天中会出现实时倒计时: *“速率受限--在4毫秒后重试”*最多可自动重试3次,最长等待30分钟,以安全的最低限度正确处理过时的重置时间戳。
会话分叉 --点击↗ 单击任何聊天旁边的按钮,创建共享相同Claude CLI会话历史的完整副本。在任何时候分散你的谈话——在不丢失原始线索的情况下探索其他方法。也适用于SSH主机。
会话导出/导入 --把你的聊天记录带到任何地方。一键将任何会话导出为可移植的JSON文件,包括完整的消息历史记录、工具调用、时间戳和附件。将其导入到任何Studio实例中,以从您停止的地方继续。导入按钮位于欢迎屏幕上,因此您可以恢复会话,而无需先创建会话。
备份之外的用例:
- 机器之间的转移 --在桌面上导出,在笔记本电脑或服务器上导入。同样的对话,不同的电脑。
- 馈送到任何AI代理 --将导出的JSON放入ChatGPT、Gemini或任何其他AI中,并说“回顾我们讨论的内容,让我们继续”。格式是人类可读且自包含的。
- 从任何AI导入 --在另一个工具上进行了富有成效的会议?要求它将对话框另存为
{ "session": { "title": "..." }, "messages": [{ "role": "user"|"assistant", "type": "text", "content": "..." }] }并将结果导入Studio。您的对话不会锁定在一个平台上。
📋 用看板图
制作一张卡片,描述你想要什么,转到“待办事项”——克劳德会自动拿起它。
排队10个任务,走开,回到所有完成的地方。卡片运行 并行 (独立任务)或 依次 (链式会话——克劳德记得上一个任务构建了什么)。 跨标签同步 立即更新每个打开的浏览器选项卡。真正的并行执行——独立任务没有人为的目录锁。
🕐 调度器——自动驾驶仪上的人工智能
创建一个任务,设定一个时间——克劳德会在需要的时候运行它。没有克戎,没有剧本,没有保姆。
- 一次: “早上6点部署到集结点”——6点整完成
- 再发生: 每小时、每天、每周、每月——可选择结束日期
- 最多5名并行工作人员 --重新启动后错过的时间会被优雅地跳过
重复任务包括 重新武装到位 --同一任务记录在每次运行后重置为下一个计划时间,而不是创建新的数据库行。任务ID在重复期间保持稳定,数据库不会无限增长,崩溃恢复正确地重新武装中断的重复任务,而不是将其标记为已完成。
A. 60秒监视器 扫描卡住的任务 in_progress 没有活动的worker——如果worker在没有清理的情况下崩溃,看门狗会自动恢复任务(重新启用循环,将一次射击重置为 todo).任务创建表单预先填写日期/时间 马上 --在安排之前,没有空白选择器需要填写。
颜色编码的议程:逾期(红色)、今天(橙色)、即将到来(蓝色)、重复(紫色)。 立即运行 按钮用于即时测试。
🤖 自主任务管理器
在任务执行过程中,Claude可以访问内置的MCP服务器进行自主任务管理,将单个任务转化为自我导向的管道。
| 工具 | 它做什么 |
|---|---|
create_task | 生成一个后续任务。发现5个bug?自动创建5个修复任务 |
create_chain | 创建顺序管道(构建→ Test → 部署)在一次通话中 |
list_tasks | 检查现有任务——避免重复,监控进度 |
get_current_task | 从父任务中读取您的任务和上下文 |
report_result | 存储下游任务的结构化结果 |
get_task_result | 读取已完成的依赖关系任务的输出 |
cancel_task | 取消冗余任务(错误已修复,重复工作) |
例子: 安排每晚的“检查GitHub问题”任务。它读取未解决的问题,为每个错误创建一个修复任务,在每个修复后链接一个验证任务,并报告摘要。没有人在循环中。
任务继承项目目录。上下文是显式传递的——孩子们确切地知道该做什么。链深度是有限的,以防止失控的递归。
📱 Telegram Bot——通过手机进行控制
30秒内配对(设置中的6位代码)。您的手机变成了一个完整的遥控器:
- 队列和监视器:
/projects,/chats,/tasks,/chat,/new - 查看结果:
/last,/full--加上任务完成或失败时的推送通知 - 管理:
/files,/cat,/diff,/log,/stop,/tunnel,/url - 忙碌时排队和中断: 在Claude工作时发送消息——它直接进入中断队列,而不是死胡同的“忙碌”回复。克劳德在下一个检查站捡到了它。也附加文件。
- 询问用户转发: 克劳德的任务中期问题显示为电报按钮——点击以回答,或发送文件/图像作为答案
- 内联停止: 🛑 每条进度消息上的按钮——点击一次即可取消
- 会话桥: 信息同时同步到手机和浏览器
- 多设备: 同时配对手机、平板电脑、笔记本电脑
- ✉ 写入按钮: 在持久键盘中快速编写快捷键——无需导航菜单即可开始打字
- 文件附件: 直接在机器人中发送照片/文件——获得尺寸确认,然后附上您的问题
论坛模式 --带有Topics的Telegram超级组合。每个项目都有自己的主题,主题之间有深度链接导航。每条消息上都有丰富的内联操作按钮——完全本地化为EN/UA/RU——继续、差异、文件、历史记录、新会话。自动按需创建项目主题。看板管理的任务主题。活动主题,带有直接URL按钮,可跳转到任何项目。
论坛模式现在由 专用独立模块 (telegram-bot-forum.js).每个项目主题都在完全隔离的每个线程状态下运行——在不同线程中的项目之间切换永远不会泄漏上下文或会话数据。坚如磐石的多项目设置,甚至跨越十几个同时进行的论坛主题。这 打开聊天 按钮总是使用回调,这样机器人就可以正确地切换会话上下文并显示实时聊天预览,而不仅仅是原始主题URL跳转。
👥 代理模式
| 单 | 多 | 调度 | |
|---|---|---|---|
| 地点 | 聊天 | 聊天 | 看板 |
| 代理 | 1 | 2–5个并行 | 2–6个作为任务卡 |
| 依赖关系 | -- | 基本 | 完整DAG |
| 自动重试 | 否 | 否 | 是(带回退) |
| 重启后仍然有效 | 否 | 否 | 是(SQLite) |
| 最适合 | 专注的工作 | 需要关注的复杂任务 | 后台批处理工作 |
多 --编排器通过实时流将其分解为2-5个子任务。规划步骤使用 --json-schema 结构化输出——即使有复杂的提示,JSON计划也能在不提取正则表达式的情况下解析。将计划发送到看板📋 按钮。 派遣 --子任务作为具有依赖图、自动重试和级联取消的持久卡进入看板。聊天中设置的工作量水平会自动流向所有已分派的任务。
⇗ 跨代理授权
直接从聊天界面向外部AI CLI(OpenAI Codex、Gemini CLI、opencode、Aider)发送任务。两种模式:
| 切换 | 同步 | |
|---|---|---|
| 工作流 | 即发即弃 | 并行协作 |
| 通信 | 单向上下文传输 | 通过DIALOG.md双向传输 |
| 监控 | 手动检查 | 每15s+fs.watch自动轮询一次 |
| 最适合 | 独立任务 | 需要来回执行的任务 |
工作原理:点击 代表 在会话栏中,选择一个代理和模式,描述任务。Studio生成 CONTEXT.md 并打开与外部代理的终端。在同步模式下,两个代理通过共享的 DIALOG.md --响应直接出现在主聊天中,并带有实时通知。
代理侧栏 --管理外部代理现在毫不费力。专注的 代理 侧边栏中的部分允许您添加、编辑和删除代理,而无需触摸 config.json.Codex、Gemini CLI和opencode即将推出 开箱即用的预配置 --第一轮自动播种。点击 测试 任何代理旁边的按钮,用于在委派之前验证连接。代理ID从标签自动生成(使用西里尔字母音译),完整的UI本地化为EN/UA/RU 视窗 代表团现在也通过 cmd.exe 适当的外壳脱落。委托通过持久状态文件在服务器重启后幸存下来。
🎛 聊天模式
自动 --完全工具访问权限(默认)。 计划 --只读分析;产生一个 执行计划 按钮切换到自动并运行。当克劳德发出完成信号时,自动计划检测会自动切换模式。 任务 --显式执行模式。
🧠 技能和汽车技能
28个内置的专家角色(前端、安全、devops、kubernetes、调试、代码审查……)。 自动模式(⚡) 对每条消息进行分类,并自动激活1-4项相关技能:
- “修复此React错误”→
frontend+debugging-master - “设置K8s部署”→
devops+kubernetes+docker
插件技能从已安装的Claude Code插件中自动发现。添加自定义 .md 文件到 skills/.
⚡ 斜杠命令
类型 / --选择一个已保存的提示。8内置:
/check | /review | /fix | /explain |
|---|---|---|---|
| 语法和错误 | 完整代码审查 | 查找并修复错误 | 用例子解释 |
/refactor | /test | /docs | /optimize |
| 清理代码 | 编写测试 | 编写文档 | 查找瓶颈 |
添加您自己的,编辑它们,删除它们。你想要多少就有多少。
⚙️ 型号和转弯
| 模型 | 上下文 | 最适合 |
|---|---|---|
| 俳句 | 标准 | 快速-简单的问题,快速检查 |
| 十四行诗 | 1M代币 | 平衡(默认)--大多数日常任务 |
| 作品 | 1M代币 | 最有能力——复杂的架构,棘手的bug |
十四行诗和Opus以 100万令牌上下文窗口 --整个大型代码库、长对话历史和大量文件集都可以放在一个会话中,而不会达到极限。
周转预算:1–200(默认值50)。自动持续3次,因此50次转弯实际上意味着最多200步。
思考努力拨号 --一个新的 Effort 聊天工具栏中的下拉菜单(以及任务/链表单)允许您调整Claude在响应前的思考难度: Auto (CLI默认), Low, Med, High, X-High,或 Max。您的选择在通过localStorage重新加载时仍然有效。工作级别会自动流向每个子任务和链——只需设置一次,即可在任何地方运行。
🌐 远程访问和SSH
安全外壳协议 --添加远程服务器,创建指向其上目录的项目。克劳德在那里工作,就像在当地一样。类型 # 在聊天中快速连接多服务器。通过SFTP自动上传截图和文件。
远程访问 --点击一下:cloudflared(无需注册)或ngrok。公共HTTPS URL(秒)。在NAT、防火墙、企业VPN之后工作。自动发送到Telegram的URL。
📊 仪表盘
活动热图(90天)、工具使用细分、模型分布、自动化指数(0-100)、高峰时段、一键导航的顶级会话。每个数字都链接到真实数据。
📱 移动就绪
在手机上打开URL——原生界面。带有实时状态指示器的移动标题、底部表格设置、滚动快照看板列、触摸优化的44px目标、iOS安全。不是“移动版”——真正的界面,为触摸而重新设计。
______________________________________________________________________
这是给谁的?
开发人员 --多个项目、任务队列、会话连续性。安排夜间测试。让克劳德上夜班。
团队 --共享实例,具有项目可见性、看板审计跟踪、重复的周一代码审查。
系统性 --通过一个选项卡进行服务器机群管理。计划健康检查、安全扫描、带Telegram警报的多服务器操作。
ML/AI工程师 --通过SSH远程GPU服务器。排队的培训工作。计划数据管道。通过Telegram进行电话监控。
______________________________________________________________________
这是什么(不是什么)
- 不是SaaS --在你的机器上运行。没有账户,没有遥测,没有供应商锁定。
- 不是IDE --管理克劳德会话。继续使用VS Code、Cursor或任何你喜欢的东西。
- 不是叉子 --包装官方CLI。人工智能更新会自动进行。
麻省理工学院许可。你的基础设施,你的数据。
______________________________________________________________________
使用OpenRouter模型
npx github:Lexus2016/claude-flow # one-time setup
npx github:Lexus2016/claude-code-studio # launch as usual______________________________________________________________________
功能参考
| 类别 | 功能 |
|---|---|
| 聊天 | 实时流媒体、截图粘贴、文件附加(@file)、对话分叉、自动继续(3x)、会话压缩、侧边栏快速过滤器、CLI会话导入、扩展思维显示、会话导出/导入(JSON)、任务中期中断(PreToolUse挂钩+附件)、会话分叉、速率限制自动等待、努力拨号、会话名称 /resume 拾取器 |
| 看板 | 任务队列、并行+顺序、跨选项卡同步、拖放选项卡、依赖关系图、每个任务/链的工作量拨号 |
| 调度器 | 一次性+定期(每小时/每天/每周/每月),5个并行工作者,立即运行,SQLite持久化,每个任务的工作量拨号,监视器自动恢复 |
| 任务管理器 | 自主子任务、链、上下文传递、结果报告、取消(MCP) |
| 电报 | Bot控制、推送通知、ask_user转发(+文件应答)、会话桥、论坛模式、内联停止、深度链接导航、丰富的操作按钮(本地化EN/UA/RU)、写入按钮、文件附件、忙碌时的中断队列 |
| 授权 | 跨代理切换/同步(Codex、Gemini、opencode)、CONTEXT.md+DIALOG.md协议、fs.watch+轮询、跨重启持久、Windows支持、侧边栏代理管理器、自动种子默认值、测试按钮 |
| 代理 | 单次、多次(聊天中2-5次,模式验证计划)、调度(看板)、自动重试、级联取消、努力传播 |
| 模式 | 自动、计划(只读+执行计划)、任务、自动模式切换 |
| 技能 | 28内置,自动分类,插件发现,自定义 .md 文件 |
| 命令 | 8个内置斜线命令、自定义命令 |
| 远程 | SSH服务器、SFTP上传、, # Cloudflake/ngrok隧道快速连接 |
| 移动 | 原生用户界面,底部页面,滚动抓取看板,iOS安全,触摸优化 |
| 仪表盘 | 活动热图、工具使用、模型分布、自动化指数、高峰时段 |
| 可靠性 | 自愈会话、崩溃保护、原子写入、即时停止、速率限制自动等待、并发安全(会话锁+busy_timeout)、孤立会话锁自动清理 |
| 安全 | bcrypt认证、AES-256-GCM SSH、Helmet.js、路径遍历保护、XSS/SQLi防护 |
| 平台 | Windows/MOSC/Linux、Docker(非root,注册表镜像)、LLM代理/网关、3种语言(EN/UA/RU)、OpenRouter支持 |
______________________________________________________________________
技术细节
建筑 --单个Node.js进程。无构建步骤。没有TypeScript。没有框架。
server.js — Express HTTP + WebSocket
auth.js — bcrypt passwords, 32-byte session tokens
claude-cli.js — spawns `claude` subprocess, parses JSON stream
telegram-bot.js — Telegram bot (Direct Mode)
telegram-bot-forum.js — Forum Mode standalone module (composition pattern)
mcp-task-manager.js — MCP server for autonomous task management
mcp-notify.js — MCP server for non-blocking notifications
public/index.html — entire frontend (HTML + CSS + JS)
config.json — MCP servers + skills catalog
data/chats.db — SQLite (WAL mode)
skills/ — .md skill files → system prompt环境:
PORT=3000
WORKDIR=./workspace
MAX_TASK_WORKERS=5
CLAUDE_TIMEOUT_MS=1800000
TRUST_PROXY=false
LOG_LEVEL=info
ANTHROPIC_BASE_URL= # LLM proxy/gateway (LiteLLM, Bifrost, OpenRouter)安全: bcrypt(12轮)、32字节令牌(30天TTL)、用于SSH密码的AES-256-GCM、Helmet.js标头、路径遍历保护、XSS过滤、参数化SQL查询、2MB缓冲区上限。
发展:
npm run dev # auto-reload (node --watch)
npm start # production______________________________________________________________________
许可证
麻省理工学院
