CC-Viewer SDK 模式全解:无头运行 Claude Code,在浏览器里直接对话、审批与切换模型 【免费下载链接】cc-viewerA request monitoring system for Claude Code that captures and visualizes all API requests and responses in real time. Helps developers monitor their Context for reviewing and debugging during Vibe Coding.项目地址https://gitcode.com/gh_mirrors/cc/cc-viewer点击查看免费下载CC-Viewer SDK 模式让你无头运行 Claude Code一条ccv --sdk命令启动 headless 会话之后所有对话、工具审批和模型切换都直接在浏览器里完成。CC-Viewer 本身是一个面向 Claude Code 的请求监控系统能实时捕获并可视化所有 API 请求与响应而 SDK 模式正是它最去终端化的玩法——告别黑框终端打开网页就能编程。什么是 CC-Viewer SDK 模式30 秒看懂普通的ccv命令是claude的直接替身它在终端里启动一个交互式 PTY伪终端旁边挂一个 Web Viewer。而SDK 模式ccv --sdk走的是另一条路会话通过Agent SDKanthropic-ai/claude-agent-sdk随 cc-viewer 一起打包运行而不是交互式终端没有主 PTY所有消息从 Web UI 直接发出其余体验不变会话日志、流式打字机效果、Token 用量统计都与终端模式完全一致顶部仍保留「终端」按钮但它打开的是独立的 scratch 多标签 shell与 SDK 会话无关而不是项目 PTY。两种模式对比一览维度终端模式默认ccvSDK 模式ccv --sdk会话载体交互式 PTY 子进程Agent SDK 常驻 streaming 会话消息输入终端键盘浏览器聊天框工具审批终端提示浏览器弹窗允许/拒绝/会话内允许日志与统计实时捕获完全相同wire-format v2 SSE 流式适用场景习惯终端的用户无头服务器、远程/移动端、纯浏览器工作流一句话概括SDK 模式 浏览器即终端服务器可以无界面。一键启动3 条最常用的ccv --sdk命令前提已安装 Node.js 20 和 Claude Code。安装 cc-viewer 后直接启动ccv --sdk # 无界面会话在浏览器里聊天 ccv --sdk -c # 继续最近一次会话 ccv --sdk --model sonnet # 指定模型启动三条命令覆盖 90% 的日常场景ccv --sdk全新无头会话。启动后浏览器自动打开开始对话即可ccv --sdk -c等价于--continue从最近的会话继续适合接着昨天写ccv --sdk --model sonnet启动时直接选定模型也支持--modelxxx写法模型名会被透传给底层 Claude Code。除此之外--resume id恢复指定会话、--fork-session分叉当前会话等原生参数也都支持解析逻辑集中在 packages/app/server/lib/launch-config.js 的splitSdkLaunchArgs()中其余未识别参数原样透传给 claude。浏览器聊天无终端但能力不减SDK 模式下的会话是一个常驻 streaming-input 进程进程一次构造、长期存活每个回合只是向输入流推一条消息而不是每回合重建子进程。这带来几个实在的好处中断更优雅点「停止」执行的是真正的interrupt()会话与进程都保留随时可继续排队消息有界面Claude 正在执行时按 Enter消息会进入服务端队列以浮动气泡叠在输入框上方每条带Send now立即打断当前执行并发送和 ×移除按钮多工作区并行SDK 模式按工作区cwd维护独立常驻会话切走某个 tab 不会杀掉后台工作区切回时自动 resume 其会话回合状态真实loading 指示按回合级信号亮灭工具执行间隙 spinner 不再误熄多工作区互不串扰。前端发送链路最终汇入 packages/app/server/lib/sdk-manager.js 的sendUserMessage由 packages/app/cli.js 在启动阶段完成与 Web 服务端的接线。工具审批中心允许 / 拒绝 / 本次会话允许全部在浏览器里这是 SDK 模式最爽的部分。Claude Code 执行 Bash、Edit、Write、NotebookEdit、WebFetch、WebSearch 等敏感操作时审批请求通过 SDK 的canUseTool钩子推到浏览器弹出允许 / 拒绝 / 本次会话允许三选项AskUserQuestionAI 主动提问与计划确认ExitPlanMode同样以模态框呈现安全底线不放松npm publish始终要求显式审批——即使你带了--dangerously-skip-permissions--d也不例外审批超时会自动关闭弹窗并广播 dismiss 事件不会留下永远卡住的弹窗。这套审批策略由 packages/app/server/lib/approval-policy.js 统一实现终端模式与 SDK 模式共享同一套策略行为完全一致。切换模型启动时--model指定历史会话可随时切换SDK 模式下与模型相关的操作有两条路径① 启动时指定模型ccv --sdk --model opus # 用 Opus 系列启动 ccv --sdk --modelsonnet # 等价的 --model 写法当前启动的模型会展示在页面顶部当代理热切换 chip 不渲染时作为回退展示只读不可点击。② 运行中切换历史会话POST /api/resume-session在 SDK 模式下不再依赖存活的 PTY它经sdk-manager.switchToSession拆除旧的常驻 query、切换目标 sessionId下一条消息以options.resume目标会话惰性重建。也就是说你可以在浏览器里自由往返于多个历史会话回合执行中会返回 busy 状态提示不会误操作。进阶Context 用量与 MCP 状态两大面板SDK 模式接入了 Agent SDK 的控制请求提供两个终端模式下没有的专属面板Context 用量回合结束及 compact 后自动拉取并广播按类别构成条含 auto-compact 阈值刻度、上下文网格、记忆文件、MCP 工具、系统提示、子代理、技能、消息明细全字段渲染——监控你的 Context 消耗正是 CC-Viewer 的主场MCP 状态按 server 列出连接状态徽标、版本、工具数量与失败错误文本按需拉取、重连回放断线不丢快照。对应的接口分别为GET /api/sdk-context-usage与GET /api/sdk-mcp-server-status适合排查上下文为什么越用越大这类经典问题。Agent SDK 不可用怎么办自动回退到终端模式SDK 模式依赖anthropic-ai/claude-agent-sdk包。正常情况下该包随 cc-viewer 一起打包开箱即用但如果环境中 SDK 不可用例如导入失败、query函数缺失CC-Viewer不会报错罢工而是自动回退到终端模式继续工作。你只会在极少数情况下感知到咦怎么多了一个终端。另外两个实用细节SDK 模式启动时会解析你指定的 Claude 可执行文件路径claudeExecutablePath解析结果会打印到控制台便于排查到底用了哪个 claude无界面环境服务器/容器建议开启ccv --usePassword密码登录再通过 LAN 地址从任意设备浏览器访问。延伸阅读核心源码与文档路径想深入 SDK 模式实现从这几个入口开始docs/README.zh.md中文 READMESDK 模式一节有完整行为说明packages/app/cli.jsCLI 入口SDK 分支在这里接线 sdk-manager 与 Web 服务端packages/app/server/lib/sdk-manager.jsSDK 会话核心——常驻 query、审批、队列、中断、多工作区注册表packages/app/server/lib/sdk-adapter.jsAgent SDK 适配层packages/app/server/lib/launch-config.js--model/-c/-r/--fork-session启动参数解析packages/app/CHANGELOG.mdSDK 模式的历次能力演进记录会话常驻化、审批超时、Context 面板等。小结想做的事SDK 模式怎么做无头启动 Claude Codeccv --sdk浏览器自动打开继续昨天的对话ccv --sdk -c指定模型ccv --sdk --model sonnet审批危险操作浏览器弹窗允许/拒绝/会话内允许打断当前执行点停止按钮或队列气泡 Send now看 Context 消耗请求详情里的「Context 用量」标签页CC-Viewer SDK 模式把 Claude Code 从终端绑定中解放出来服务器无头跑、人在任何设备的浏览器里干活审批、对话、模型切换一个页面全搞定。如果你已经在用 CC-Viewer 看请求日志ccv --sdk值得今天就试一次。赞分享【免费下载链接】cc-viewerA request monitoring system for Claude Code that captures and visualizes all API requests and responses in real time. Helps developers monitor their Context for reviewing and debugging during Vibe Coding.项目地址https://gitcode.com/gh_mirrors/cc/cc-viewer点击查看免费下载相关推荐web-ai在浏览器中直接运行深度学习模型web ai在浏览器中直接运行深度学习模型 在现代网络应用中人工智能技术的融入已成为提升用户体验、优化业务流程的重要手段。今天我要为大家推荐一个开源项目—obscura MCP 服务器完全指南把无头浏览器接入 Claude Desktop / Claude Codeobscura MCP 服务器完全指南把无头浏览器接入 Claude Desktop / Claude Code obscura 是一个面向 AI Agent网页爬虫后端MCP 服务浏览器控制Transformers.js在浏览器中直接运行AI模型的革命性突破想象一下在浏览器中直接运行强大的AI模型无需服务器支持这就是Transformers.js带来的技术革新这个JavaScript库让前端开发者能够轻松集人工智能大模型本地部署创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考