Notchi – Claude Code 与 Codex 的 macOS「凹槽」伴侣

是什么 – 一个小型 macOS 应用程序，驻留在 MacBook Pro 的屏幕凹槽中，实时响应来自 Anthropic 的 Claude Code 和 OpenAI 的 Codex 的事件，并展示动画角色。它还可选择性地分析您发送给这些模型的提示的情感，并显示相应的情绪反应。

---

核心功能（如 README 所述）

功能	你将获得
实时事件响应	应用会注册 Claude Code 或 Codex 的 shell 脚本钩子。当模型发出事件（思考、工具使用、权限请求、错误、完成等）时，钩子会通过 Unix 套接字发送 JSON 负载。Notchi 解析负载并相应地动画化角色。
情感驱动的情绪	如果你在设置中粘贴 Anthropic 或 OpenAI 的 API 密钥，Notchi 会调用相应 API 分析每个提示的情感，并显示角色为开心、悲伤、狂喜、中立或“哭泣”状态。
使用量追踪	底部的条形图显示过去 30 天的每日 token 使用量和估算成本，按提供方或合并显示。点击它可展开包含会话时间、配额条和成本图表的仪表板。
多并发会话	每个活跃的 Claude 或 Codex 会话都会在点击凹槽时出现的小“草地岛”上拥有自己的角色（从 Claude/Codex 角色家族中选择）。
自定义音效	内置每种事件的音效；你也可以导入自己的音效。当终端窗口获得焦点时，音效会自动静音。
本地化	UI 随系统语言变化，支持英文、日文、简体中文、繁体中文、韩文和越南文。
自动更新	使用 Sparkle 框架提供签名且经过公证的更新。
跨平台社区端口	提供社区维护的 Windows 端口链接（notchi‑for‑windows, pixel‑companion）。

---

安装步骤（来自 README）

1. 从发布页面下载最新 DMG（例如 Notchi‑1.2.7.dmg）。
2. 打开 DMG 并将 Notchi 拖入 应用程序 文件夹。
3. 启动应用——首次运行时会自动安装 Claude Code 和/或 Codex 钩子。
4. 如果 macOS 要求访问钥匙串（用于存储 API 使用统计），点击 始终允许。
5. （可选）打开设置 → 粘贴你的 Anthropic 或 OpenAI API 密钥以启用情感分析。
6. 像平常一样使用 Claude Code 或 Codex；角色将开始响应。
7. 点击使用量条查看成本/使用量仪表板。

---

内部工作原理（高阶流程，来自 README）

Claude Code / Codex  →  钩子脚本（shell）  →  Unix 套接字  →
事件解析器  →  状态机  →  动画角色

• 钩子脚本由 Notchi 安装，监听 AI 代理发出的 JSON 事件。
• 事件通过本地 Unix 套接字传输到 Notchi 进程。
• 应用解析 JSON，更新一个有限状态机，将事件映射到动画状态（空闲、工作、睡眠、压缩、等待等）。
• 如果存在 API 密钥，提示文本将发送至 Anthropic 或 OpenAI 进行情感分析；结果会影响角色的面部表情。
• UI 在凹槽区域绘制适当的角色，并更新使用量面板。

---

要求与兼容性

• macOS 15.0+（Sequoia） – 该应用依赖于此版本引入的凹槽 UI。
• 带有物理凹槽的 MacBook – 角色就生活在这个空间中。
• 必须在机器上安装 Claude Code 和/或 OpenAI Codex，以便钩子可以附加。

---

贡献与支持

• 欢迎通过拉取请求贡献；请参阅 CONTRIBUTING.md 了解指南。
• 该项目仅限 GPL‑3.0 许可。
• 可通过 GitHub Sponsors 赞助开发（覆盖签名构建所需的 Apple Developer 账户费用）。

---

快速总结

Notchi 是一个虽小众但功能完整的 macOS 伴侣，以有趣的方式可视化 Claude Code 和 Codex 的内部运作，同时为开发者提供实时的 token 使用量视图和可选的情感反馈。它是一个真正专注于 AI 代理交互的软件项目，而非仅是教程或列表。