クロードコードの解説：ビジュアルガイド

概要

Claude Codeのメッセージ処理の流れをソースコードベースで解説。 40以上のツールやコマンド、多エージェント連携の仕組みを整理。エージェントループ、アーキテクチャ、ツールシステムの主要ポイントを紹介。未公開機能や隠し機能の存在も明らかに。関連リークや議論スレッドも簡単に参照。

Claude Codeのメッセージ処理フロー

ユーザーがメッセージを入力 すると、Claude Codeの エージェントループ が始動
- キー入力から レスポンスのレンダリング までの一連の流れ
エージェントループ は以下の処理を段階的に実行
- 入力解析、意図推定、適切なツールやコマンドの選択
- 必要に応じて 複数エージェント や 外部ツール を呼び出し協調処理
- レスポンス生成 後、UIに レンダリング

アーキテクチャと構成

ソースツリー は用途ごとにディレクトリ分割
- utils/ （564ファイル）：ユーティリティ、補助関数群
- components/ （389ファイル）：UI層、各種コンポーネント
- commands/ （189ファイル）：スラッシュコマンド実装
- tools/ （184ファイル）：ビルトインツール本体
- services/ （130ファイル）：バックエンド連携やサービス層
- hooks/、 ink/、 bridge/、 constants/、 skills/、 cli/ なども存在

ツールシステムの全貌

組み込みツール は40種類以上、機能別に分類
- File Operations （6ツール）：ファイル操作
- Execution （3ツール）：コード実行
- Search & Fetch （3ツール）：検索・取得
- Agents & Tasks （10ツール）：タスク分担・エージェント連携
- Planning （4ツール）：計画立案
- MCP （4ツール）：マルチエージェント制御
- System （8ツール）：システム操作
- Experimental （4ツール）：実験的機能
  - 各ツールごとに 詳細情報やソースコード も閲覧可能

コマンドカタログ

スラッシュコマンド も機能別に整理
- Setup & Config （12コマンド）：初期設定・構成
- Daily Workflow （24コマンド）：日常作業自動化
- Code Review & Git （13コマンド）：コードレビュー・Git操作
- Debugging & Diagnostics （23コマンド）：デバッグ・診断
- Advanced & Experimental （23コマンド）：高度・実験的操作
  - 各コマンドの 詳細やソース も参照可能

隠し機能・未公開機能

feature-flag や 環境変数 で制御される 未公開機能 が複数存在
- コード上ではコメントアウトや条件分岐で管理
- 一部は 将来的なリリース候補 や 社内限定機能

Hackerたちの意見

あの「隠れた機能」、すごいね！特にクロスセッションの参照が。将来的に楽しみにしてるよ。それと、絶対にClaude Codeのスピリットアニマルが欲しいな。

└

ついにライブだ！最新のccを使ってるなら、今すぐ/buddyが使えるよ。

AI生成コンテンツには変なところがあって、見た目は完璧なのに内容がほとんどないんだよね。例えば、このウェブサイトのアニメーション、バックエンドにリクエストを送って、ツールコールがあるかもしれないっていう以上のこと、何を言ってるの？

└

本当に変だけど、このパターンでAIのテキストを簡単に見分けられるよね。

└

それに、ところどころでランダムに間違ってるし。例えば、「Buddy」種の一つに「狐」って書いてあるけど、それはコードにないんだよね。

└

それは分かる。サイトは深い技術的な分析をするためのものじゃなくて、AIの助けを借りながらコードベースを探索してきた中でキュレーションしたものを視覚的に示す高レベルなガイドって感じだからね。50万行のコードベースを短時間でさっと見るのは無理があるよ。

└

一番可能性の高いトークンを選ぶと、意外性が少ないトークン、つまりエントロピーが少なくて、トークンごとの情報量が少ないものが出てくるよね。

彼らは本当に自分たちの製品を使って、技術的負債を気にせずに進めてるのかな？ある意味、いい挑戦だけど、今のプロジェクトの状態を見るのは結構つらいよ（もう約1年経ってるから、そろそろいい感じになってるはずなのに）。

└

クロードコードのクリエイター、ボリス・チェルニーが「CCを使ってCCを作ってる」って言ってたよ。

└

これはもう約1年経ってるから、状態は良さそうだね。1年のプロジェクトは、もし一人の開発者が書いたなら良い状態かもしれないけど、複数の開発者がいると、絶対にごちゃごちゃしてバグだらけになるよ。1年経ったばかりだと、まだバグがいっぱい残ってる可能性が高いと思う。

これらのフロンティアLLMモデルのトランスフォーマーコードが漏れたらいいな。HNはそんな暴露で盛り上がるだろうね。

└

フロンティアラボが使ってるトランスフォーマーコードに特別なことはないと思うよ。おそらく、特許があるのは大規模分散トレーニングのインフラ特有の最適化やGPUカーネルトリックくらいじゃないかな。実際の強みはトレーニングデータ、特にRLHFやファインチューニングデータ、検証可能な報酬環境、そしてGPUクラスターだね。オープンソースのモデルもかなり近いし、フロンティアラボが持ってるのと同じくらいの計算資源やデータがあれば、同じくらいの性能になると思うよ。

これをAwesome Claude codeに追加してもいいよ。 https://github.com/rosaboyle/awesome-cc-oss

カイロスとオートドリームはエージェントループセクションのどれよりも面白いね。セッション間のメモリ統合が実際の未解決問題だと思う。残りは正直言って、ただの配管作業だね。

└

Beadsみたいなプロジェクトは、記憶の定着を助けるんだよね。オフラインのままで、いつでも思い出せるから、あんまり意味がなくなるって感じ。

これの視覚化、めっちゃいいね！高レベルでの流れが理解しやすくなってる。ツールシステムやコマンドカタログ、特にゲート付きのやつはすごく興味深いよ。

つまり、ripgrepを使ってて、unix grepじゃないんだね。[0] HNの他のコメントから知ってたけど、ソースでも確認できて嬉しいよ。0 - https://github.com/zackautocracy/claude-code/blob/main/src/u...

関連リンク: https://www.ccleaks.com このデプロイは一時的に停止中だよ。

2020年だったら、数時間や数日後にそんな詳細な統計付きの漏洩のビジュアルが手に入るなんて想像できなかったよね、笑

└

これってどうやって生成されたの？「AI/Claudeのコードで」ってのは確かだけど、実際のステップは何なの？

ハクソク