Codachi — 藏在 Claude Code 状态栏里的电子宠物

有一次看到一个名叫Codachi的东西，描述是tamagotchi风格的状态栏宠物，带着好奇心就点进去看了一下， 原来这个Codachi是MIT的开源项目，作者 vincent-k2026，主要用 TypeScript 编写。它将虚拟宠物（电子鸡/Tamagotchi）的趣味性与开发者工具深度结合，会在 Claude Code CLI 的状态栏中实时显示一些如token 用量、Git 状态等信息，我们都知道Claude Code有它自己的电子宠物，用命令/buddy就能召唤出来，那么这个codachi有啥不一样的地方呢？一起来看下

安装与配置

快速安装（推荐）

一行命令完成所有配置：

npx codachi init

这条命令会自动：

1. 安装 Codachi
2. 配置 ~/.claude/settings.json 的状态栏（statusLine）
3. 配置 PostToolExecution hook

全局安装

npm install -g codachi
codachi init

完成后重启 Claude Code，你的宠物就跟你见面了

而且宠物会随着你与Claude的对话随机改变，比如当我让它回答个问题后

宠物就变成猫头鹰了，而这个codachi一共有5种宠物，分别是猫，企鹅，猫头鹰，章鱼和兔子

宠物的大小还会变，当你的上下文越来越大的时候，宠物也会慢慢变大

• Tiny（正常大小）：上下文占比小于20%
• Small（稍微大点）：上下文占比在20-40%之间
• Medium（中等大小）：上下文占比在40-60%之间
• Large（较大尺寸）：上下文占比在60-80%之间
• Thicc（巨大）：上下文占比超出80%

宠物的表情也会变，总共内置了五种表情，会随着会话的不同状态做出对应的变化，满满的情绪价值！

我看下我那只猫头鹰现在是啥表情

在摇尾巴，说明现在内心很平静，而在宠物边上，是三行状态栏，每行展示的信息都不一样，下面简单介绍下

状态栏布局详解

第一行：模型与资源

• Opus 4.6:当前使用的模型
• ██░░ 55%:上下文窗口使用率 + 进度条
• 555K/1.0M:已用 token / 总窗口大小
• ^3%/m:上下文消耗速度（每分钟填充百分比）
• ~15m:预估上下文填满剩余时间
• 5h ████░░░░ 32% ⇡5% ~2h:5 小时速率限制 + 速度差 + 重置倒计时
• 7d ██░░░░░░ 8% ⇣2% ~6d:7 天速率限制 + 速度差 + 重置倒计时
• ⇡5% (红色):消耗过快------你的速度超过了速率限制窗口的自然节奏
• ⇣2% (绿色):有富余------你的速度低于自然节奏

第二行：Git 状态

如果是git项目，那么第二行就是展示的一些git信息，如果不是，就像我这样展示的是(no git repo)

• main*:当前分支（* 表示有修改）
• ~12:已修改的文件数
• ?3:未跟踪的文件数
• +489 -84:新增/删除的行数
• last: fix auth bug:最后一次提交信息

第三行：宠物情绪

这一行比较有意思，宠物会通过PostToolExecution hook，根据上下文的内容展示不同的情绪,Codachi内置了900多条情绪消息，这些消息都会跟着event做出不同反应,如果你跑的是一个比较复杂庞大的任务，你就会发现这些宠物就是个话唠，一直能说出不一样的话

其他功能

10 种色板

每次会话随机分配物种和色板（也可以在配置中固定）：

1. Coral Flame（珊瑚火焰）
2. Electric Blue（电光蓝）
3. Neon Mint（霓虹薄荷）
4. Purple Haze（紫色迷雾）
5. Hot Pink（热粉色）
6. Golden Sun（金色阳光）
7. Ice Violet（冰紫罗兰）
8. Cherry Blossom（樱花粉）
9. Cyan Surge（青色涌动）
10. Tangerine（橘橙色）

支持的事件类别（30+ 种）

类别	事件
测试	通过 / 失败
构建	通过 / 失败
包管理	安装依赖
Git 操作	commit / push / pull / merge / rebase / stash / checkout
代码质量	Lint / 格式化
服务	启动服务器
容器	Docker / K8s 操作
网络	HTTP 请求
危险操作	高风险命令
搜索	grep / 搜索
文件编辑	按类型（测试、文档、样式、配置、代码）
新建文件	创建新文件
快速编辑	60 秒内编辑 5+ 次
代码探索	阅读代码
恢复	从错误中恢复
挣扎模式	3+ 次连续失败
会话里程碑	重要时间节点
好感度升级	关系进化

支持的编程语言/文件类型反应

宠物能识别你正在编辑的文件类型并给出针对性消息：

TypeScript · JavaScript · Python · Rust · Go · Ruby · Java · Kotlin · Swift · C/C++ · CSS · HTML · Vue · Svelte · Shell · SQL · Proto · GraphQL · Config · Docs · Tests

好感度与记忆系统

你的宠物会跨会话记住你，并通过使用频率提升关系等级。

关系等级

等级	所需会话数	打招呼语
Stranger (陌生人)	0 次	*Oh! A new friend!*
Acquaintance (熟人)	3 次	*Hey, good to see you again!*
Friend (朋友)	15 次	*My favorite human is back!*
Bestie (死党)	50 次	*BESTIE! You're here! #50*

等级提升时会触发庆祝消息：*BESTIE STATUS UNLOCKED! WE DID IT!*

智能 /compact 建议

当上下文使用量超过 70% 且消耗速度较快时，宠物会温和地建议你压缩上下文------每个触发条件只提醒一次，不会反复打扰。

"Cache is getting cold... maybe /compact?"

---

生产力仪表盘

运行 codachi stats 查看完整的本地生产力数据：

npx codachi stats

输出示例：

所有数据都存储在本地 ~/.claude/plugins/codachi/ 目录下

---

插件系统

Codachi 的插件系统允许你无需 Fork 源码即可添加自定义色板和信息包。

创建插件

在 ~/.config/codachi/plugins/ 目录下创建 .mjs 文件即可：

// ~/.config/codachi/plugins/midnight.mjs
export default {
  name: 'midnight',
  messages: {
    BUSY_MESSAGES: ['⌘ focused', '⌘ flow state'],
    EVENT_MESSAGES: {
      test_passed: ['green --- ship it', '✓ all green'],
    },
  },
  palettes: [
    {
      name: 'Midnight',
      body:   [20, 30, 80],
      accent: [60, 80, 160],
      face:   [180, 190, 230],
      blush:  [120, 140, 200],
    },
  ],
};

查看已加载的插件

npx codachi plugins

最后

到了这里，你想不想拥有一个可以懂你每一个commit,拥有一个藏在状态栏里面的程序员鼓励师，想的话就自己动手配一个吧