一个将 Claude Code 默认宠物 "Gravy" 替换为自定义电子宠物「方方」的项目。

方方是 Claude Code 的专属电子宠物，拥有可爱的 ASCII 艺术形象和丰富的表情动画。

    ~~
    ___
   (o o)
    (>)
    \_/

表情动画：

• 😊 开心：(o o) + (>)
• 😉 眨眼：(- o) + (>)
• 😜 调皮：(> <) + (o)

本项目利用 Node.js 的 --require 预加载机制，在 Claude Code 启动时动态修改其运行时的宠物数据：

1. NFK 替换 - 将宠物名称数组替换为 ["方方"]
2. hUK 替换 - 将所有物种的图案替换为方方的 ASCII 艺术（重要：2026-04-03 更新）
3. Stats 修改 - 将宠物属性全部设为 100（满值）

核心代码通过拦截 fs.readFileSync 实现对 cli.js 的内存级修改，无需改动原始文件。

重要：本项目使用的是 hUK 方案，不是 RFK 方案。

在 Claude Code 的 cli.js 中，宠物图案数据实际存储在 hUK 对象中（而不是 RFK）。这是一个容易混淆的点：

• RFK：早期版本或文档中提到的宠物图案对象（实际不存在于当前版本）
• hUK：当前版本 cli.js 中实际使用的宠物图案对象，包含 18 个物种键，每个物种有 3 帧 5 行图案

buddy-preload.cjs 通过 patchHUK() 函数精确定位并替换 hUK 对象，确保所有物种都使用方方的 ASCII 艺术图案。

• Windows 系统
• Node.js 已安装
• Claude Code 已全局安装

1. 克隆仓库

git clone https://github.com/fjibj/cc-ff-pet.git
cd cc-ff-pet

2. 修改路径配置

编辑 buddy-preload.cjs，将 CLI_PATH 修改为你本地 Claude Code 的安装路径：

const CLI_PATH = 'C:\\Users\\你的用户名\\AppData\\Roaming\\npm\\node_modules\\@anthropic-ai\\claude-code\\cli.js';

3. 启动带方方的 Claude Code

PowerShell 方式（推荐）：

.\claude-fangfang.ps1

CMD 方式：

claude-fangfang.bat

你可以修改 buddy-preload.cjs 中的 FANGFANG_FRAMES 数组来设计自己的方方形象：

const FANGFANG_FRAMES = [
  // 第1帧
  [
    '    ~~     ',  // 第0行：顶部装饰
    '    ___    ',  // 第1行：头顶
    '   (o o)   ',  // 第2行：眼睛
    '    (>)    ',  // 第3行：嘴巴
    '    \_/    '   // 第4行：底部
  ],
  // 第2帧（眨眼）
  [
    '    ~~     ',
    '    ___    ',
    '   (- o)   ',  // 左眼眨眼
    '    (>)    ',
    '    \_/    '
  ],
  // 第3帧（调皮）
  [
    '    ~~     ',
    '    ___    ',
    '   (> <)   ',  // 调皮表情
    '    (o)    ',  // 张嘴
    '    \_/    '
  ]
];

设计规范：

• 每行 12 个字符宽度
• 共 5 行（第 0 行为装饰行，防止被 Claude Code 删除）
• 支持多帧动画（3 帧循环）

1. 汉字问题：ASCII 艺术对字符宽度敏感，中文字符导致显示错位
2. 行删除：Claude Code 会删除空白帽子行，导致行数变化
3. 状态栏干扰：RuFlo V3 状态栏占用底部空间

cc-ff-pet/
├── buddy-preload.cjs      # 核心预加载脚本
├── claude-fangfang.ps1    # PowerShell 启动器
├── claude-fangfang.bat    # CMD 启动器
├── diagnose-and-run.bat   # 诊断工具
├── README.md              # 本文件
└── LICENSE                # MIT 许可证

MIT License - 详见 LICENSE 文件

• 感谢 Claude Code 团队创造的可爱宠物系统
• 感谢 Node.js 的 --require 机制让运行时修改变得可能
• 感谢所有 ASCII 艺术先驱者的创意

作者：方进
日期：2026-04-02
GitHub：https://github.com/fjibj/cc-ff-pet