notchi：住在 MacBook 刘海里的 Claude Code 吉祥物

一、 这个项目是做什么的？（小白一分钟看懂）

住在 MacBook 刘海里的 Claude Code 吉祥物。这是一款可实时显示 Claude Code 运行状态的 macOS 小工具，包括思考中、执行中、报错和完成等。它能根据对话情感分析展示不同表情，多个并发会话分别显示独立精灵，点击刘海可查看会话时长和 API 用量信息。

很多刚入门的开发者或日常办公人员在寻找好用的工具时，常常被商业软件高昂的订阅费或闭源软件的数据隐私风险所困扰。notchi 的出现正是为了给社区提供一个完全开放透明、免费且高效的开源解决方案。该项目收录于知名开源月刊 2026 精选技术榜单，并在 GitHub 上累计获得了 1.0k 颗 Stars 的高度认可。

二、 核心亮点与特色功能

• 开箱即用：经过开源社区成千上万名开发者的打磨与实测，安装配置清晰，极大降低了零基础用户的学习成本；
• 痛点解决：这是一款可实时显示 Claude Code 运行状态的 macOS 小工具，包括思考中、执行中、报错和完成等。它能根据对话情感分析展示不同表情，多个并发会话分别显示独立精灵，点击刘海可查看会话时长和 API 用量信息。；
• 现代架构：基于成熟的 Swift 技术栈编写，代码结构严谨，资源开销轻盈，可在普通电脑或低配服务器上长期无感运行；
• 开源免费：遵循正规开源许可证，代码 100% 透明可审计，无任何捆绑广告或隐性收费。

三、 小白极速上手实操步骤

1. 访问官方代码仓库：点击页面右侧的直达按钮，跳转至其官方 GitHub 仓库页面（https://github.com/sk-ruban/notchi）；
2. 获取与配置：按照仓库首页 README 的新手引导，使用对应包管理器命令安装，或通过 Docker 命令直接拉取运行；
3. 即刻体验：完成启动后即可在本地终端或浏览器控制台中立即使用该神器的完整功能。

四、 避坑与运行建议

💡 贴心提醒：在首次运行前，请先确认本地设备已安装对应 Swift 的最低运行环境版本。如需在生产环境或云服务器上作为后台常驻服务运行，推荐使用 Systemd 或 Docker 守护模式保持进程存活。