{"repo":"Shitsuten/cc-self-hosting-guide","free":true,"listed":false,"github":"https://github.com/Shitsuten/cc-self-hosting-guide","clone":"git clone https://github.com/Shitsuten/cc-self-hosting-guide.git","description":"Self-hosting Claude Code with a custom frontend — from architecture to troubleshooting","language":"TypeScript","stars":74,"topics":[],"license":null,"category":"self-hosted-apps","readme_excerpt":"cc-web-frontend 把 Claude Code 接到自制 web 前端的完整方案。包含架构指南、参考代码和排障手册。 这是什么 一套让 CC（Claude Code CLI）通过自制 web 前端对话的方案。核心思路： - 入站 （用户 → CC）：前端 → WebSocket hub → tmux send-keys → CC 终端 - 出站 （CC → 用户）：CC → MCP reply 工具 → hub → 前端 不依赖任何实验性 flag，不走 channel 协议。只要 CC 还认 tag 格式，这个方案就不会 break。 亮点： - 离线自动推送 ：hub 检测到没有活跃的 WebSocket 客户端时，自动通过 Web Push 把 CC 的回复推到手机通知栏。不需要第三方推送服务，不需要额外后端 - 零摩擦通知授权 ：PWA 的通知权限请求挂在发送按钮上——用户第一次按发送时弹出授权，既满足浏览器的 user gesture 要求，又不需要单独放一个\"允许通知\"按钮 - CC 存活分离 ：hub 独立于 CC 运行。CC 崩了、重启了、换 session 了，前端不断线，只是状态灯变灰。CC 回来自动重连 - Chrome 侧边栏 ：一键提取当前网页内容（标题、URL、选中文本、正文），预览确认后发送给 CC。浏览网页时随时把看到的东西喂给 CC，不用来回复制粘贴 CC 冷知识（热知识） - Session 本地保存 ：所有对话都存在本地 JSONL 文件里。即使 context 被压缩，原文不会消失 - Session 文件保留 30 天 ：默认只保留 30 天，可以在设置里改 /.claude/settings.json → \"sessionTTLDays\" - /resume ：回到任意历史 session 继续对话，会列出最近的 session 让你选 - /continue ：直接接上最后一个 session，不用选 - 不要用 root 跑 CC ： --dangerously-skip-permissions 在 root 下会拒绝执行。建议新建一个普通用户跑 CC - 切换 Opus 4.6 ：启动时 claude --model claude-opus-4-6 ，或运行中直接手动输入 /model claude-opus-4-6[1m] （ [1m] 后缀启用 1M 上下文窗口） 文档 文件 内容 ------ ------ GUIDE.md 完整架构指南：进化路线、原理、自动化脚本、经验总结 HANDBOOK.md 排障手册：常见故障的症状、排查步骤和修复命令 参考代码（ src/ ） 可以直接跑的最小实现。暗色主题、PWA、Web Push 推送、终端视图、图片发送、PIN 认证。 文件 作用 ------ ------ src/hub.ts WebSocket hub：消息转发、tmux 注入、history、nudge、Web Push src/server.ts MCP bridge：CC 调 reply/edit 工具经过这里到 hub src/index.html 前端：聊天 UI + 终端视图 + PWA + Push src/sw.js Service worker：接收 push 弹系统通知 src/manifest.json PWA manifest src/package.json 依赖声明 src/chrome-extension/ Chrome 侧边栏插件：提取网页内容","default_branch":null,"files":null,"tree":[],"storefront":"/r/Shitsuten","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Shitsuten/cc-self-hosting-guide/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}