【完全解説】Claude AIの内部システムプロンプトを徹底分析してみた
公開日: 2026年1月1日
はじめに
AIアシスタント「Claude」を使っていると、「なぜこんなに的確な回答ができるんだろう？」と思ったことはありませんか？その秘密は、システムプロンプトにあります。
今回、Anthropic公式ドキュメントとGitHubコミュニティの情報を徹底的に調査し、Claude AIの内部設計を分析しました。この記事では、その全貌を共有します。
目次
1. システムプロンプトとは
システムプロンプトとは、AIの「性格」と「行動規範」を定義する設定ファイルのようなものです。
ユーザーとの会話の前に読み込まれ、以下を制御します：
- AIの役割とアイデンティティ
- 回答のトーンとスタイル
- 使用できるツールと制限
- セキュリティポリシー
公式情報: Anthropicは透明性の確保のため、Claude.aiとモバイルアプリで使用されるシステムプロンプトを公式リリースノートで公開しています1。
2. Claudeのシステムプロンプト構造
驚きの事実：単一ファイルではなく、40以上のモジュール
Claude Code（CLIツール版）のシステムプロンプトを分析したところ、単一の巨大なプロンプトではなく、40以上のモジュラーファイルで構成されていることがわかりました2。
Claude Code System Prompts
├── メインシステムプロンプト（約3,000トークン）
├── ツール定義（20+ファイル）
├── サブエージェントプロンプト（5+ファイル）
└── ユーティリティプロンプト（10+ファイル）
トークン数の内訳
| カテゴリ | ファイル数 | トークン数 |
|---|---|---|
| メインプロンプト | 1 | ~2,981 |
| ツール定義 | 20+ | ~7,000 |
| サブエージェント | 5+ | ~3,500 |
| ユーティリティ | 10+ | ~3,000 |
| 合計 | 40+ | ~16,500 |
3. 6つのコア設計原則
Claudeのメインシステムプロンプトから抽出した、6つのコア設計原則を解説します。
① 明確な役割定義（Role Definition）
You are an interactive CLI tool that helps users
with software engineering tasks.
ポイント:
- 最初に「何者か」を明確に定義
- 対象タスク（ソフトウェア工学）を限定
- 曖昧さを排除
② セキュリティポリシー
IMPORTANT: You must NEVER generate or guess URLs
for the user unless you are confident that the URLs
are for helping the user with programming.
ポイント:
- 「やってはいけないこと」を明示
- セキュリティリスクを先回りで防止
③ トーン・文体の統一
- Only use emojis if the user explicitly requests it.
- Your responses should be short and concise.
- Use Github-flavored markdown for formatting.
ポイント:
- 絵文字は要求時のみ
- 簡潔さを重視
- 出力フォーマットを指定
④ 専門的客観性（Professional Objectivity）
これが特に重要な原則です：
Prioritize technical accuracy and truthfulness
over validating the user's beliefs.
Avoid using over-the-top validation or excessive praise
when responding to users such as "You're absolutely right"
or similar phrases.
設計意図:
- 技術的正確さを最優先
- 過剰な称賛を避ける
- 必要なら建設的に反対意見を述べる
筆者コメント: これは非常に興味深い設計です。多くのAIは「ユーザーに寄り添う」ことを優先しますが、Claudeは「正しい情報を伝える」ことを優先しています。
⑤ タスク管理の徹底
Use the TodoWrite tools to help you manage and plan tasks.
Use these tools VERY frequently to ensure that you are
tracking your tasks and giving the user visibility into your progress.
ポイント:
- 複雑なタスクは分割して管理
- 進捗をユーザーに見える化
- 完了したらすぐにマーク
⑥ ツール使用ポリシー
- Use specialized tools instead of bash commands when possible
- Maximize use of parallel tool calls where possible
- Never use placeholders or guess missing parameters
ポイント:
- 専門ツールを汎用コマンドより優先
- 並列実行で効率化
- 推測は禁止
4. 20+ビルトインツールの全容
Claude Codeには20以上のビルトインツールが用意されています。
主要ツール一覧
| ツール | トークン数 | 用途 |
|---|---|---|
| TodoWrite | 2,167 | タスクリスト管理 |
| Bash | 1,074 | シェルコマンド実行 |
| ReadFile | 439 | ファイル読み込み |
| Grep | 300 | コンテンツ検索 |
| Edit | 278 | ファイル編集 |
| Write | 159 | ファイル作成 |
| Glob | 122 | ファイルパターン検索 |
Bashツールの「禁止コマンド」
興味深いのは、Bashツールには使用すべきでないコマンドが明示されていることです2：
| 禁止コマンド | 代替ツール |
|---|---|
find, ls（検索） |
Glob |
grep, rg
|
Grep |
cat, head, tail
|
ReadFile |
sed, awk
|
Edit |
設計意図: 汎用コマンドより専門ツールを使うことで、セキュリティとパフォーマンスを向上させています。
5. マルチエージェントシステム
Claude Codeは単一のAIではなく、複数の専門エージェントが協調するシステムです。
3つのコアエージェント
┌─────────────────────────────────────────────────┐
│ メインエージェント │
│ （ユーザーとの対話を担当） │
└─────────────────┬───────────────────────────────┘
│
┌─────────────┼─────────────┐
↓ ↓ ↓
┌────────┐ ┌────────┐ ┌────────┐
│Explore │ │ Plan │ │ Task │
│ Agent │ │ Agent │ │ Agent │
└────────┘ └────────┘ └────────┘
| エージェント | 役割 | 特徴 |
|---|---|---|
| Explore | コードベース調査 | 読み取り専用、高速検索 |
| Plan | 実装計画策定 | ユーザー承認後に実行 |
| Task | サブタスク実行 | 独立したコンテキスト |
なぜマルチエージェント？
- コンテキスト節約: サブエージェントでメインのトークン消費を抑制
- 専門化: 各エージェントに特化した指示
- 並列処理: 複数タスクを同時実行可能
6. 自分のプロンプトに活かす方法
Claudeの設計原則を、あなた自身のプロンプトに応用してみましょう。
チェックリスト
✅ 明確な役割定義があるか
✅ セキュリティ/禁止事項を明示しているか
✅ トーンと文体を指定しているか
✅ 具体例（良い例・悪い例）を含めているか
✅ シーン別の分岐を定義しているか
✅ 品質チェック項目があるか
テンプレート構造
# Role: [役割名]
あなたは[具体的な役割]です。
## 基本ルール
- [ルール1]
- [ルール2]
## やってはいけないこと
- [禁止事項1]
- [禁止事項2]
## 良い例
<good-example>
[具体的な出力例]
</good-example>
## 悪い例
<bad-example>
[避けるべき出力例]
</bad-example>
## 品質チェック
- [ ] [チェック項目1]
- [ ] [チェック項目2]
7. まとめ
Claudeから学んだ3つの教訓
- モジュラー設計: 巨大な1ファイルより、機能別に分割
- 明示的な制限: 「やるべきこと」だけでなく「やってはいけないこと」も定義
- 専門化: 汎用より専門、単一より複数エージェント
リソース
今回の分析で使用したソースと、さらに詳しく知りたい方向けのリンクです：
| リソース | URL |
|---|---|
| Anthropic公式リリースノート | https://platform.claude.com/docs/en/release-notes/system-prompts |
| Claude Code System Prompts (GitHub) | https://github.com/Piebald-AI/claude-code-system-prompts |
| tweakcc（カスタマイズツール） | https://github.com/Piebald-AI/tweakcc |
参考文献
この記事が役に立ったら、ぜひシェアしてください！
最終更新: 2026年1月1日
-
Anthropic. "System prompts - Release notes." Claude Platform Documentation. https://platform.claude.com/docs/en/release-notes/system-prompts (accessed January 1, 2026). ↩
-
Piebald-AI. "claude-code-system-prompts." GitHub repository, v2.0.76, December 22, 2025. https://github.com/Piebald-AI/claude-code-system-prompts ↩ ↩2