CcCompanion

CcCompanion
把 Claude Code 装进口袋。开源 iOS 全功能客户端 + 电脑端推送服务 (macOS / Windows WSL2 / Linux·VPS 都能跑)：聊天、掌上终端、斜杠命令面板、语音输入、收藏、多 agent 工作群、整套微信风格主题——你电脑上那个 Claude Code, 从此在你口袋里全天候跟着你。完全跑在你自己的设备上, 没有第三方服务器。

跟 Anthropic 无关。 "Claude" 跟 "Claude Code" 是 Anthropic PBC 的商标。详见 DISCLAIMER.md.

English: README.en.md

✨Find Me✨
微信&测试群：CyberSealNull，备注ccc

TestFlight定向邀请/bug反馈：将你的苹果账户邮箱发送至opia@starryfield.space

欢迎Bug反馈/PR/新功能许愿

这是什么

CcCompanion 两块:

1. ios-app/ — SwiftUI 写的 iOS app (TestFlight 定向邀请, 后续上 App Store), 给你 chat / terminal / 斜杠命令三件套, 在 iPhone 上接你电脑那边的 Claude Code session, 走 overlay 网络任何地方都能用。
2. apns-server/ — 你电脑上跑的 Python HTTP 服务 (macOS 直接跑, Windows 走 WSL2, Linux / VPS 主机也行), 把你发的 chat 转给本地 tmux 里的 claude, 抓回复, 通过 Apple Push 推回你 iPhone。

整套是 local-first — 你的消息不过我们的 server, 因为根本没"我们的 server"。家里那台电脑跟你 iPhone 走 Tailscale / ZeroTier / LAN 直连。

它能做什么

聊天, 但是完整的那种:

- Chat — iPhone 发一句, Claude Code 回的话推回来。streaming 流式输出, 完整历史, 全文搜索, 跳转到任意消息。
- 语音输入 — 按住说话, 本地语音识别转文字, 通勤路上不用打字。
- 附件 — 发图片 / 文件给 Claude Code, 截图丢过去让它看。
- 收藏夹 — 重要的回答一键收藏, 单独一页随时翻。
- 表情包 — 内置表情包面板, 跟 AI 聊天也可以有梗。
- 斜杠命令面板 — /new, /list, /switch , /stop, /compact, /clear, /help, 弹出式面板不用背命令。多 session 跟随当前 active。

你的电脑, 在你手心:

- Terminal — 内嵌你电脑那边 tmux 跑 claude 的 session, 实时看它在干什么; 底部输入框直接打命令, 键盘工具栏带方向键 / Enter / Esc / Ctrl-C 特殊键 — 跑 /model 这类交互面板跟坐在电脑前一样, 不用回去解锁电脑。
- 多 endpoint — 一个 app 配多个 server URL (Tailscale 100.x + LAN 10.x + localhost), 自动 ping 切活的。换 wifi 自动跟。

多 agent 与个性化:

- 工作群 view — 如果你的电脑上跑着多个 agent 协作 (server 的 group 端点), app 里有一个群聊界面围观它们对话, 带群内搜索跟群收藏。实验性, 设置里打开。
- 微信风格主题 — 整套微信皮肤: 聊天气泡、时间轴动态页、给你的 AI 改备注名。换个皮肤, 换种关系。
- 主题 — 浅色 / 深色 / 暖色, 可跟随系统。
- 头像与身份 — 给 AI 和自己设头像 (带裁剪), 起名字, onboarding 六步走完 (server URL + secret + 头像 + 名字 + ping 测试)。

通知与更新:

- 轮询本地通知 — 轮询拉到新 assistant 消息时, app 触发一次本地 iOS 通知。app 在前台 /…