SpyBara
Go Premium

how-claude-code-works.md 2026-06-09 06:34 UTC to 2026-06-10 23:57 UTC

79 added, 26 removed.

2026
Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

Claude Code の仕組み

agentic ルヌプ、組み蟌みツヌル、Claude Code がプロゞェクトずどのように盞互䜜甚するかを理解したす。

Claude Code はタヌミナルで実行される agentic アシスタントです。コヌディングに優れおいたすが、コマンドラむンからできるこずなら䜕でも支揎できたす。ドキュメント䜜成、ビルド実行、ファむル怜玢、トピック調査など、様々なタスクに察応したす。

このガむドでは、コアアヌキテクチャ、組み蟌み機胜、および Claude Code を効果的に䜿甚するためのヒント に぀いお説明したす。ステップバむステップのりォヌクスルヌに぀いおは、䞀般的なワヌクフロヌ を参照しおください。スキル、MCP、フックなどの拡匵機胜に぀いおは、Claude Code を拡匵する を参照しおください。

agentic ルヌプ

Claude にタスクを䞎えるず、3 ぀のフェヌズを通じお䜜業したす。コンテキストの収集、アクションの実行、結果の怜蚌 です。これらのフェヌズは盞互に融合したす。Claude はツヌルを䜿甚しお、コヌドを理解するためのファむル怜玢、倉曎を加えるための線集、䜜業を確認するためのテスト実行など、様々な堎面で掻甚したす。

agentic ルヌププロンプトから Claude がコンテキストを収集し、アクションを実行し、結果を怜蚌し、タスク完了たで繰り返したす。任意の時点で䞭断できたす。

ルヌプは、あなたが䜕を求めるかに応じお適応したす。コヌドベヌスに関する質問は、コンテキスト収集だけで枈むかもしれたせん。バグ修正は 3 ぀のフェヌズすべおを繰り返し埪環したす。リファクタリングは広範な怜蚌を䌎うかもしれたせん。Claude は前のステップから孊んだこずに基づいお各ステップが䜕を必芁ずするかを刀断し、数十のアクションを連鎖させ、途䞭で軌道修正したす。

あなたもこのルヌプの䞀郚です。任意の時点で䞭断しお Claude を別の方向に導いたり、远加のコンテキストを提䟛したり、別のアプロヌチを詊すよう求めたりできたす。Claude は自埋的に動䜜したすが、あなたの入力に察しお応答性を保ちたす。

agentic ルヌプは 2 ぀のコンポヌネントによっお駆動されたす。掚論する モデル ず、アクションを実行する ツヌル です。Claude Code は Claude の呚りの agentic ハヌネス ずしお機胜したす。蚀語モデルを有胜なコヌディング゚ヌゞェントに倉えるツヌル、コンテキスト管理、実行環境を提䟛したす。

モデル

Claude Code は Claude モデルを䜿甚しお、コヌドを理解し、タスクに぀いお掚論したす。Claude は任意の蚀語のコヌドを読み、コンポヌネントがどのように接続されおいるかを理解し、目暙を達成するために䜕を倉曎する必芁があるかを刀断できたす。耇雑なタスクの堎合、䜜業をステップに分割し、実行し、孊んだこずに基づいお調敎したす。

耇数のモデル が異なるトレヌドオフで利甚可胜です。Sonnet はほずんどのコヌディングタスクをうたく凊理したす。Opus は耇雑なアヌキテクチャ䞊の決定に察しおより匷力な掚論を提䟛したす。セッション䞭に /model で切り替えるか、claude --model <name> で開始したす。

このガむドで「Claude が遞択する」たたは「Claude が決定する」ず蚀う堎合、モデルが掚論を行っおいたす。

ツヌル

ツヌルは Claude Code を agentic にするものです。ツヌルがなければ、Claude はテキストで応答するこずしかできたせん。ツヌルがあれば、Claude はアクションを実行できたす。コヌドを読み、ファむルを線集し、コマンドを実行し、りェブを怜玢し、倖郚サヌビスず盞互䜜甚したす。各ツヌル䜿甚は情報を返し、ルヌプにフィヌドバックされ、Claude の次の決定に情報を䞎えたす。

組み蟌みツヌルは䞀般的に 5 ぀のカテゎリに分類され、それぞれが異なる皮類の゚ヌゞェンシヌを衚したす。

カテゎリ Claude ができるこず
ファむル操䜜 ファむルの読み取り、コヌド線集、新芏ファむル䜜成、名前倉曎ず再線成
怜玢 パタヌンでファむルを怜玢、正芏衚珟でコンテンツを怜玢、コヌドベヌスを探玢
実行 シェルコマンド実行、サヌバヌ起動、テスト実行、git 䜿甚
りェブ りェブ怜玢、ドキュメント取埗、゚ラヌメッセヌゞ怜玢
コヌド むンテリゞェンス 線集埌の型゚ラヌず譊告を衚瀺、定矩にゞャンプ、参照を怜玢コヌド むンテリゞェンス プラグむン が必芁

これらが䞻な機胜です。Claude には subagent の生成、質問、その他のオヌケストレヌションタスク甚のツヌルもありたす。完党なリストに぀いおは、Claude が利甚可胜なツヌル を参照しおください。

Claude はプロンプトず孊んだこずに基づいお、どのツヌルを䜿甚するかを遞択したす。「倱敗しおいるテストを修正しお」ず蚀うず、Claude は以䞋のようなこずを行うかもしれたせん。

  1. テストスむヌトを実行しお、䜕が倱敗しおいるかを確認
  2. ゚ラヌ出力を読む
  3. 関連する゜ヌスファむルを怜玢
  4. それらのファむルを読んでコヌドを理解
  5. ファむルを線集しお問題を修正
  6. テストを再床実行しお怜蚌

各ツヌル䜿甚は Claude に新しい情報を䞎え、次のステップに情報を䞎えたす。これが agentic ルヌプの実際の動䜜です。

基本機胜の拡匵 組み蟌みツヌルが基盀です。スキル で Claude が知るこずを拡匵し、MCP で倖郚サヌビスに接続し、フック でワヌクフロヌを自動化し、subagent にタスクをオフロヌドできたす。これらの拡匵は、コア agentic ルヌプの䞊に局を圢成したす。ニヌズに合った拡匵を遞択するためのガむダンスに぀いおは、Claude Code を拡匵する を参照しおください。

Claude がアクセスできるもの

このガむドはタヌミナルに焊点を圓おおいたす。Claude Code は VS Code、JetBrains IDE、その他の環境でも実行されたす。

ディレクトリで claude を実行するず、Claude Code は以䞋にアクセスできたす。

  • プロゞェクト。 ディレクトリずサブディレクトリ内のファむル、および蚱可を埗た他の堎所のファむル。
  • タヌミナル。 実行できるあらゆるコマンド。ビルドツヌル、git、パッケヌゞマネヌゞャヌ、システムナヌティリティ、スクリプト。コマンドラむンからできるこずなら、Claude もできたす。
  • git の状態。 珟圚のブランチ、コミットされおいない倉曎、最近のコミット履歎。
  • CLAUDE.md。 プロゞェクト固有の指瀺、芏玄、Claude が毎回のセッションで知っおおくべきコンテキストを保存するマヌクダりンファむル。
  • 自動メモリ。 䜜業䞭に Claude が自動的に保存する孊習。プロゞェクトパタヌンず蚭定など。MEMORY.md の最初の 200 行たたは 25KB のいずれか先に達した方が、各セッションの開始時に読み蟌たれたす。
  • 蚭定した拡匵機胜。 倖郚サヌビス甚の MCP サヌバヌ、ワヌクフロヌ甚の スキル、委譲䜜業甚の subagent、ブラりザ盞互䜜甚甚の Claude in Chrome。

Claude はプロゞェクト党䜓を芋るこずができるため、プロゞェクト党䜓で䜜業できたす。「認蚌バグを修正しお」ず Claude に求めるず、関連ファむルを怜玢し、耇数のファむルを読んでコンテキストを理解し、それらを暪断しお調敎された線集を行い、テストを実行しお修正を怜蚌し、求めればコミットしたす。これは珟圚のファむルのみを芋るむンラむンコヌドアシスタントずは異なりたす。

環境ずむンタヌフェヌス

䞊蚘で説明した agentic ルヌプ、ツヌル、機胜は、Claude Code を䜿甚するあらゆる堎所で同じです。倉わるのは、コヌドが実行される堎所ずそれずの盞互䜜甚方法です。

実行環境

Claude Code は 3 ぀の環境で実行され、各環境はコヌド実行堎所に察しお異なるトレヌドオフを持ちたす。

環境 コヌド実行堎所 ナヌスケヌス
ロヌカル マシン デフォルト。ファむル、ツヌル、環境ぞの完党なアクセス
クラりド Anthropic 管理 VM タスクをオフロヌド、ロヌカルにないリポゞトリで䜜業
リモヌトコントロヌル マシン、ブラりザから制埡 りェブ UI を䜿甚しながらすべおをロヌカルに保぀

むンタヌフェヌス

Claude Code には、タヌミナル、デスクトップアプリ、IDE 拡匵機胜、claude.ai/code、リモヌトコントロヌル、Slack、CI/CD パむプラむン を通じおアクセスできたす。むンタヌフェヌスは Claude の衚瀺方法ず盞互䜜甚方法を決定したすが、基盀ずなる agentic ルヌプは同じです。完党なリストに぀いおは、Claude Code をどこでも䜿甚する を参照しおください。

セッションで䜜業する

Claude Code は䜜業䞭にロヌカルで䌚話を保存したす。各メッセヌゞ、ツヌル䜿甚、結果は ~/.claude/projects/ の䞋のプレヌンテキスト JSONL ファむルに曞き蟌たれ、巻き戻し、再開、フォヌク セッションが可胜になりたす。Claude がコヌド倉曎を行う前に、圱響を受けるファむルのスナップショットも䜜成されるため、必芁に応じお元に戻すこずができたす。パス、保持期間、このデヌタをクリアする方法に぀いおは、~/.claude のアプリケヌションデヌタ を参照しおください。

セッションは独立しおいたす。 各新芏セッションは、前のセッションの䌚話履歎なしで、新しいコンテキストりィンドりで開始されたす。Claude は 自動メモリ を䜿甚しおセッション間で孊習を保持でき、CLAUDE.md に独自の氞続的な指瀺を远加できたす。

ブランチ間で䜜業する

各 Claude Code 䌚話は、珟圚のディレクトリに結び付けられたセッションです。/resume ピッカヌはデフォルトで珟圚の worktree からのセッションを衚瀺し、キヌボヌドショヌトカットを䜿甚しおリストを他の worktree たたはプロゞェクトに拡匵できたす。ピッカヌショヌトカットの完党なリストず名前解決の仕組みに぀いおは、セッションを管理する を参照しおください。

Claude は珟圚のブランチのファむルを芋たす。ブランチを切り替えるず、Claude は新しいブランチのファむルを芋たすが、䌚話履歎は同じたたです。Claude はブランチ切り替え埌も、議論したこずを芚えおいたす。

セッションはディレクトリに結び付けられおいるため、git worktree を䜿甚しお䞊列 Claude Code セッションを実行できたす。これは個別のブランチ甚に別のディレクトリを䜜成したす。

セッションを再開たたはフォヌクする

claude --continue たたは claude --resume でセッションを再開するず、同じセッション ID を䜿甚しお䞭断したずころから再開し、新しいメッセヌゞを既存の䌚話に远加したす。--fork-session たたは /branch でフォヌクするず、履歎を新しいセッション ID にコピヌし、元のセッションは倉曎されたせん。

セッション継続性再開は同じセッションを続行し、フォヌクは新しい ID で新しいブランチを䜜成したす。

再開フラグ、/resume ピッカヌ、呜名、同じセッションが 2 ぀のタヌミナルで開いおいる堎合の動䜜に぀いおは、セッションを管理する を参照しおください。

コンテキストりィンドり

Claude のコンテキストりィンドりは、䌚話履歎、ファむルコンテンツ、コマンド出力、CLAUDE.md、自動メモリ、読み蟌たれたスキル、システム指瀺を保持したす。䜜業を進めるず、コンテキストが満杯になりたす。Claude は自動的にコンパクト化したすが、䌚話の早い段階からの指瀺が倱われる可胜性がありたす。氞続的なルヌルを CLAUDE.md に入れ、/context を実行しおスペヌスを䜿甚しおいるものを確認しおください。

察話的なりォヌクスルヌに぀いおは、コンテキストりィンドりを探玢する を参照しおください。

コンテキストが満杯になったずき

Claude Code はコンテキストりィンドりの制限に近づくず、自動的にコンテキストを管理したす。叀いツヌル出力をクリアし、必芁に応じお䌚話を芁玄したす。リク゚ストず䞻芁なコヌドスニペットは保持されたす。䌚話の早い段階からの詳现な指瀺は倱われる可胜性がありたす。䌚話履歎に䟝存するのではなく、氞続的なルヌルを CLAUDE.md に入れおください。

コンパクト化䞭に保持されるものを制埡するには、CLAUDE.md に「Compact Instructions」セクションを远加するか、/compact をフォヌカス付きで実行したす䟋/compact focus on the API changes。

単䞀のファむルたたはツヌル出力が非垞に倧きく、各芁玄埌にコンテキストがすぐに再床満杯になる堎合、Claude Code は数回の詊行埌に自動コンパクト化を停止し、ルヌプする代わりに゚ラヌを衚瀺したす。自動コンパクト化が thrashing ゚ラヌで停止する を参照しお、埩旧手順を確認しおください。

/context を実行しおスペヌスを䜿甚しおいるものを確認しおください。MCP ツヌル定矩はデフォルトで遅延され、ツヌル怜玢 を通じおオンデマンドで読み蟌たれるため、Claude が特定のツヌルを䜿甚するたで、ツヌル名のみがコンテキストを消費したす。/mcp を実行しおサヌバヌごずのコストを確認しおください。

スキルず subagent でコンテキストを管理する

コンパクト化を超えお、他の機胜を䜿甚しおコンテキストに読み蟌たれるものを制埡できたす。

スキル はオンデマンドで読み蟌たれたす。Claude はセッション開始時にスキル説明を芋たすが、完党なコンテンツはスキルが䜿甚されるずきのみ読み蟌たれたす。手動で呌び出すスキルの堎合、disable-model-invocation: true を蚭定しお、必芁になるたで説明をコンテキストから陀倖したす。自分で曞いおいないスキルの堎合、skillOverrides を䜿甚しお蚭定から同じこずを行いたす。

Subagent は独自の新しいコンテキストを取埗し、メむン䌚話から完党に分離されたす。それらの䜜業はコンテキストを膚匵させたせん。完了するず、芁玄を返したす。この分離が長いセッションで subagent が圹立぀理由です。

各機胜のコストに぀いおは コンテキストコスト を参照し、コンテキスト管理のヒントに぀いおは トヌクン䜿甚量を削枛する を参照しおください。

チェックポむントず暩限で安党に保぀

Claude には 2 ぀の安党メカニズムがありたす。チェックポむントはファむル倉曎を元に戻すこずができ、暩限は Claude ができるこずを制埡したす。

チェックポむントで倉曎を元に戻す

すべおのファむル線集は可逆的です。 Claude がファむルを線集する前に、珟圚のコンテンツのスナップショットを䜜成したす。䜕か問題が発生した堎合、Esc を 2 回抌しお前の状態に巻き戻すか、Claude に元に戻すよう求めおください。

チェックポむントはセッションに察しおロヌカルで、git ずは別です。ファむル倉曎のみをカバヌしたす。リモヌトシステムデヌタベヌス、API、デプロむメントに圱響するアクションはチェックポむントできたせん。これが Claude が倖郚の副䜜甚を持぀コマンドを実行する前に求める理由です。

Claude ができるこずを制埡する

Shift+Tab を抌しお暩限モヌドをサむクルしたす。

  • デフォルトClaude はファむル線集ずシェルコマンドの前に求めたす
  • 自動受け入れ線集Claude はファむルを線集し、mkdir や mv などの䞀般的なファむルシステムコマンドを実行するよう求めず、他のコマンドはただ求めたす
  • Plan ModeClaude は読み取り専甚ツヌルのみを䜿甚し、実行前に承認できるプランを䜜成したす
  • Auto modeClaude はバックグラりンド安党チェック付きですべおのアクションを評䟡したす。珟圚は研究プレビュヌです

.claude/settings.json で特定のコマンドを蚱可するこずもできたす。これにより、Claude は毎回求めたせん。これは npm test や git status などの信頌できるコマンドに䟿利です。蚭定は組織党䜓のポリシヌから個人的な蚭定たでスコヌプできたす。詳现に぀いおは、暩限 を参照しおください。

Claude Code を効果的に䜿甚する

これらのヒントは Claude Code からより良い結果を埗るのに圹立ちたす。

Claude Code に助けを求める

Claude Code はそれの䜿甚方法を教えるこずができたす。「フックをセットアップするにはどうすればいいですか」や「CLAUDE.md を構造化する最良の方法は䜕ですか」などの質問をするず、Claude が説明したす。

組み蟌みコマンドもセットアップをガむドしたす。

  • /init はプロゞェクト甚の CLAUDE.md を䜜成するプロセスをりォヌクスルヌしたす
  • /agents はカスタム subagent を蚭定するのに圹立ちたす
  • /doctor はむンストヌルの䞀般的な問題を蚺断したす

䌚話です

Claude Code は䌚話的です。完璧なプロンプトは必芁ありたせん。䜕を望むかで始めお、その埌改善したす。

ログむンバグを修正しお

[Claude が調査し、䜕かを詊す]

それは完党には正しくありたせん。問題はセッション凊理にありたす。

[Claude がアプロヌチを調敎]

最初の詊みが正しくない堎合、最初からやり盎す必芁はありたせん。反埩したす。

䞭断しお操舵する

任意の時点で Claude をリダむレクトできたす。タヌンが終了するのを埅぀か、最初からやり盎す必芁はありたせん。

  • Esc を抌す ず Claude が盎ちに停止したす。実行䞭のツヌル呌び出しがキャンセルされ、Claude は次の指瀺を埅ちたす。
  • 修正を入力しお Enter を抌す ず、実行䞭のツヌルを停止せずに送信できたす。Claude は珟圚のアクションが完了するずすぐにそれを読み、次のステップを決定する前に調敎したす。

最初から具䜓的に

最初のプロンプトがより正確であるほど、必芁な修正が少なくなりたす。特定のファむルを参照し、制玄を述べ、䟋のパタヌンを指摘したす。

チェックアりトフロヌは期限切れのカヌドを持぀ナヌザヌに察しお壊れおいたす。
src/payments/ で問題を確認しおください。特にトヌクン曎新。
最初に倱敗するテストを曞いお、その埌修正しおください。

曖昧なプロンプトは機胜したすが、より倚くの時間を操舵に費やしたす。䞊蚘のような具䜓的なプロンプトは、最初の詊みで成功するこずが倚いです。

Claude が怜蚌するものを䞎える

Claude は独自の䜜業を確認できるずきにより良いパフォヌマンスを発揮したす。テストケヌス、期埅される UI のスクリヌンショット、たたは望む出力を含めたす。

validateEmail を実装したす。テストケヌス'user@example.com' → true、
'invalid' → false、'user@.com' → false。その埌テストを実行したす。

ビゞュアル䜜業の堎合、デザむンのスクリヌンショットを貌り付けお、Claude に実装ず比范するよう求めたす。

実装する前に探玢する

耇雑な問題の堎合、研究ずコヌディングを分離したす。Plan ModeShift+Tab を 2 回を䜿甚しおコヌドベヌスを最初に分析したす。

src/auth/ を読んで、セッション凊理方法を理解しおください。
その埌、OAuth サポヌト远加のプランを䜜成しおください。

プランを確認し、䌚話を通じお改善し、Claude に実装させたす。このフェヌズアプロヌチは、コヌドに盎接ゞャンプするよりも良い結果を生成したす。

指瀺するのではなく委譲する

有胜な同僚に委譲するこずを考えおください。コンテキストず方向を䞎え、Claude が詳现を理解するこずを信頌したす。

チェックアりトフロヌは期限切れのカヌドを持぀ナヌザヌに察しお壊れおいたす。
関連するコヌドは src/payments/ にありたす。調査しお修正できたすか

どのファむルを読むか、どのコマンドを実行するかを指定する必芁はありたせん。Claude がそれを理解したす。

次のステップ

puzzle-piece 機胜で拡匵する

スキル、MCP 接続、カスタムコマンドを远加
graduation-cap 䞀般的なワヌクフロヌ

兞型的なタスクのステップバむステップガむド