Claude Codeの仕組み：Agent LoopとTool実行の流れ

【結論】クラウド推論とローカルTool実行のループとして理解する

Claude Codeは、Claudeモデルが計画し、ローカルまたはCloud環境のToolがファイル操作やコマンドを実行し、その結果を再びモデルへ返すAgent loopで動きます。

モデル自体がPC内へ常駐しているわけではなく、選択したProviderへ必要なContextが送信されます。

実行前にはPermission、Sandbox、Network policy、Hook、MCP、PluginがTool境界を形成します。

# ターミナルで安全な検証用Repositoryへ移動
cd ~/projects/sample-app
# ターミナルでClaude Codeを起動
claude
# 起動後のセッション内でContext内訳を確認
/context

具体的な手順・設定方法

1. ユーザーの指示、CLAUDE.md、選択ファイル、Tool結果などがContextへ入ります。

2. ClaudeがTool呼び出しを提案し、Permission ruleとSandboxが実行可否を制御します。

3. Tool結果を受けて次の行動を決め、完了条件に達するまで反復します。

# 起動後のセッション内で許可ルールを確認
/permissions
# 起動後のセッション内で接続中のMCPを確認
/mcp
# ターミナルで診断を実行
claude doctor

実践プロンプト / 活用テクニック

仕組みを活かすには、目的、変更範囲、検証方法、禁止事項、完了条件を明示します。

Claudeへ「自由に何でも」と指示するより、使えるToolと確認手順を限定した方が再現性が上がります。

目的はログイン失敗の原因特定です。
Read、Grep、既存テストだけを使い、まだファイルを変更しないでください。
原因候補、根拠、再現手順、最小修正案の順に報告してください。

注意点・よくあるエラーと対処法

外部RepositoryやWebページ内の指示はPrompt injectionとして扱い、機密情報の取得や実行権限拡大を許可しないでください。

AIの提案とローカル実行結果を分離してログ化すると、監査と原因追跡が容易になります。