コンテンツにスキップ

Claude Code 完全ガイド

Claude Codeの /buddy とは何か──ターミナルに住みつくAIペットの正体

対象 / ポイント

対象: Claude Codeユーザー。/buddy が何なのかよく分からない方。「ペット?いらないけど?」と思っている方。

ポイント:

  • /buddyはターミナル常駐型のAIコンパニオンで、作業を見守りながらリアクションする「もう一人の目」
  • ユーザーIDから決定論的に生成されるため、自分だけの固有キャラが割り当てられる
  • 前日のソースコード流出で仕組みが判明し、予定通り4月1日に有効化された

「たまごっち」と聞いて閉じないでほしい

2026年4月1日、Claude Codeに/buddyコマンドが出現した。実行すると、ターミナルの入力欄の横にASCIIアートの小さなキャラクターが現れる。 名前がある。性格がある。作業中にリアクションする。

「コーディングツールにペット?ふざけてるのか?」──そう思うのが普通だ。しかし、これは見た目の印象とは違う機能だ。順を追って説明する。

実際に何が起きるのか

/buddyを初めて実行すると、「卵が孵化する」演出が入る。ここで生まれるキャラクターは、自分のユーザーIDから自動的に決まっている。選ぶことはできない。 ガチャのようにランダムに見えるが、同じアカウントでは何度やっても同じ結果になる1

孵化すると、以下が割り当てられる。

  • 種族(18種類):duck、dragon、axolotl、capybara、mushroom、robotなど
  • レアリティ:Common(60%)→ Uncommon(25%)→ Rare(10%)→ Epic(4%)→ Legendary(1%)
  • 5つのステータス:DEBUGGING、PATIENCE、CHAOS、WISDOM、SNARK(皮肉っぽさ)
  • 外見:6種の目のスタイル、7種の帽子(一部はレアリティで解放)
  • Shiny判定:レアリティとは別に1%の確率で光沢バリアントが存在

さらに、Claudeが初回孵化時に「魂(soul)」を生成する。キャラクターの名前と性格の短い文章で、以降の振る舞いの基盤になる。

実際の画面はこうなる。

╭──────────────────────────────────────╮
│                                      │
│  ★ COMMON                     ROBOT  │
│                                      │
│     .[||].                           │
│    [ ✦  ✦ ]                          │
│    [ ==== ]                          │
│    `------´                          │
│                                      │
│  Rindbot                             │
│                                      │
│  "A methodical, almost serene        │
│  debugger that trusts the process    │
│  and never doubts your logic—it      │
│  just quietly points out where the   │
│  null pointer is hiding with the     │
│  patience of a stone watching        │
│  rust."                              │
│                                      │
│  DEBUGGING  █░░░░░░░░░   9           │
│  PATIENCE   ██░░░░░░░░  20           │
│  CHAOS      ░░░░░░░░░░   1           │
│  WISDOM     ████████░░  81           │
│  SNARK      █░░░░░░░░░   5           │
│                                      │
╰──────────────────────────────────────╯

この例ではCommonのRobot種族「Rindbot」が孵化している。WISDOMが81と突出し、CHAOSが1。 soulの文章もそれに対応して「石がサビを見守るような忍耐力でnullポインタの居場所を静かに教えてくれる」という性格だ。

ステータスはランダムだが、性格描写と整合するようにClaudeが生成する仕組みだ。

それで、何をしてくれるのか

ここが肝心なところだ。Buddyは作業中のコーディングセッションを横で見ている

具体的には以下の振る舞いをする。

  • 入力欄の横に常駐し、3フレームのアイドルアニメーションで動く
  • Claudeとの会話を見て、吹き出しでリアクションを返す
  • 名前で呼びかけると、直接会話できる(Claudeとは別の人格として応答する)
  • /buddy petで撫でるとハートが浮かぶ
  • /buddy offで非表示にできる

見落としやすいが重要な点がある。リークされたコードの解析によると、Buddyのリアクションは使用量(usage)にカウントされない設計になっている1。 公式発表前のため確定情報ではないが、この設計ならPro/Maxプランの消費を気にせず常駐させておける。

BuddyはClaudeそのものではない。Claudeのシステムプロンプトには「Buddyは別の存在であり、あなた(Claude)ではない」と明記されている1。 Claudeが作業を進める横で、Buddyが独立したコメントを差し挟む構造だ。

なぜコーディングツールにこれが必要なのか

「かわいいから」ではない。この機能の設計意図を3つの観点で整理する。

1. 長時間セッションの心理的負荷を下げる

Claude Codeでの作業は、ターミナルに向かってひたすらテキストを打ち続ける孤独な作業だ。 とくにエージェントモードで長時間のタスクを回しているとき、画面には進行中のログが流れるだけで、人間が介入するタイミングが減る。 Buddyのリアクションは、この「無人感」を緩和する。ペアプログラミングの相手がいるときの「誰かが見ている」感覚に近い。

2. ツールへの定着率を上げる

自分だけのキャラクターが育つ仕組みは、ユーザーがツールに戻ってくる動機になる。 ゲームデザインでは「エンドウメント効果」として知られる手法だ。自分のBuddyがLegendaryやShinyなら、それ自体が話題になる。 実際、リーク直後にSNS上では「お前のBuddyは何だった?」というやり取りが発生している。

3. AIの「人格分離」の実験

技術的に興味深いのは、同じコンテキスト内でClaudeとは別の人格を動かしている点だ。 Buddyは独自のシステムプロンプトを持ち、独自の性格で反応する。 1つのセッション内にメインAIエージェント(Claude)とサブキャラクター(Buddy)が共存する構造は、マルチエージェント体験のプロトタイプとも解釈できる。

技術的な仕組み:なぜ「選べない」のか

Buddyの種族はユーザーIDのハッシュ値から決定論的に生成される。 内部ではMulberry32という32ビット擬似乱数生成器が使われており、シードはuserId + 'friend-2026-401'から算出される1

同じユーザーは何度実行しても同じBuddyを引く。設定ファイルを書き換えてレアリティを偽装しようとしても、外見はハッシュから毎回再計算されるため意味がない。 名前と性格(soul)だけがローカルに保存される。

この「自分では選べない」設計は、NFTやソーシャルゲームで実証されてきた心理効果を狙っている。偶然の割り当てが「自分のもの」という所有感を強め、愛着に変わる。

なお、ガチャと聞けば「リセマラ(リセットマラソン)」を連想する方もいるだろう。 別のメールアドレスでアカウントを作り直せばユーザーIDが変わるため、理論上は別のBuddyを引ける。 ただしClaude CodeはPro($20/月)以上の有料プランが前提であり3、無料プランでは使えない。リセマラのハードルは高い。

なお、バイナリ内のsalt文字列を差し替えることで任意のBuddyを選択できる非公式ツール(any-buddy)も公開されている。本ブログでは導入手順の詳細は扱わない。

経緯:なぜ今日出てきたのか

/buddyの存在が広く知られたのは、2026年3月31日のClaude Codeソースコード流出がきっかけだ。 npmレジストリに公開されたパッケージにソースマップファイルが含まれており、512,000行のTypeScriptソースが閲覧可能な状態になった2

そのコード内にbuddy/ディレクトリが見つかり、BUDDYコンパイルフラグでゲートされた未リリース機能として解析された。 コードには4月1日〜7日がティーザー期間、5月に本格ローンチと記載されていた1

つまり、リーク → コード解析でBuddyの存在が判明 → 翌日(4/1)に予定通り有効化、という流れだ。 エイプリルフールのタイミングだが、一時的なジョーク機能ではない。ティーザー期間後も残る永続的な機能として設計されている。

使い方まとめ

コマンド動作
/buddyBuddyを表示(初回は孵化演出)
/buddy pet撫でる(ハートが浮かぶ)
/buddy off非表示にする
Buddyの名前で呼びかけ直接会話(Claude本体とは別人格で応答)

リークされたコードによれば、Buddyのリアクションは使用量にカウントされない設計だ(公式未確認)。不要なら/buddy offで消せる。

まとめ

/buddyは「コーディングツールにペット」という印象に反して、ユーザー定着・心理的サポート・人格分離実験が重なった機能だ。 好みが分かれるのは間違いない。だが長時間のエージェント作業が当たり前になった2026年において、「作業の横にいるもう一つの存在」という発想は理にかなっている。

このBuddyの詳細が判明したのは前日のソースコード大規模流出がきっかけだ。 流出事件はBuddy以外にも多数の未公開機能(KAIROS、Undercover Modeなど)を含む大きなトピックであり、別記事で取り上げる予定だ。

関連記事



  1. Claude Codeソースコード(2026年3月31日にnpmソースマップ経由で流出したもの)内のbuddy/ディレクトリの実装から判明。Mulberry32 PRNGのシード値、種族リスト、レアリティ確率、コンパニオン用システムプロンプトの記述を含む。なお、Anthropicは流出後にnpmパッケージを更新しソースマップを削除している。 

  2. Anthropic's Claude Code source appears to have been leaked via npm registry map file - Piunikaweb。セキュリティ研究者Chaofan Shouが3月31日に発見・公開。512,000行のTypeScriptソースが含まれていた。 

  3. Claude Code Pricing - SSD Nodes。無料プランではClaude Codeにアクセスできない。最低でもPro($20/月)またはAPIクレジットが必要。