SOURCES — 一次情報源の台帳
このページは「どこを読むべきか」の索引。日本語のページがあるものは ✅、まだ無いものは ⬜。 優先度は「AI活用全般のベストプラクティスとしての汎用性」で付けている。
日本語のページにしたのは 128本。下表の ⬜ はまだ取り込んでいない(足したモデル別 prompting 2本、compaction から分かれた子ページのうち2本、以前の取得で見つかった plugins 系15本 —— 旧 plugins ページから分かれた
plugins/*14本とplugin-evals)。 §1 末尾の「参考(事例報告)」2本は、Claude の使い方についての主張を持たないので意図的に入れていない。事例でも、Claude の使い方についての主張(手法・判断の基準)を持つものは取り込む(Balyasny・Asana・Cresta・Anthropic の営業の4本を取り込んだ)。主張を持たない事例報告だけを「参考」に置く。
0. ドメイン構成の注意(重要)
一次情報は3つのホストに分かれており、過去に大きなURL移設があった。
| ホスト | 扱う範囲 |
|---|---|
www.anthropic.com/engineering | Engineering ブログ。設計思想・研究寄り |
code.claude.com/docs | Claude Code の製品ドキュメント |
platform.claude.com/docs | Claude Developer Platform(API、prompting、tool use、Skills、evals) |
判明している転送:
www.anthropic.com/engineering/claude-code-best-practices→ 308 →code.claude.com/docs/en/best-practices(かつての有名なブログ記事は独立文書として消滅。ネット上の解説記事の多くは古い版を参照している)docs.claude.com/en/docs/claude-code/*→ 301 →code.claude.com/docs/en/*docs.claude.com/en/docs/build-with-claude/*→ 302 →platform.claude.com/docs/en/*
日本語版について: 両ドキュメントサイトとも /docs/ja/<en と同じパス> で到達する。
この台帳は英語版 URL を正とし、日本語版 URL を併記する。
Engineering ブログに日本語版は存在しない(404)。
索引ファイル(全ページを機械的に列挙できる):
- https://code.claude.com/docs/llms.txt (200 直接)
- https://platform.claude.com/llms.txt (
/docs/は付かない。platform.claude.com/docs/llms.txtは 308 でここへ転送される)
2サイトで llms.txt の位置が非対称なので注意。実測して確認済み。
1. Engineering ブログ(全25本)
https://www.anthropic.com/engineering
エージェント設計
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Building effective agents | building-effective-agents | 高 — この分野の出発点 |
| ✅ | How we built our multi-agent research system | multi-agent-research-system | 高 — orchestrator-workers の実運用 |
| ✅ | Effective harnesses for long-running agents | effective-harnesses-for-long-running-agents | 高 |
| ✅ | Harness design for long-running application development | harness-design-long-running-apps | 中 |
| ✅ | Scaling Managed Agents: Decoupling the brain from the hands | managed-agents | 中 |
| ✅ | Building a C compiler with a team of parallel Claudes | building-c-compiler | 中 — 並列エージェントの事例 |
コンテキスト設計
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Effective context engineering for AI agents | effective-context-engineering-for-ai-agents | 高 |
| ✅ | Introducing Contextual Retrieval | contextual-retrieval | 中 — RAG 寄り |
| ✅ | The “think” tool | claude-think-tool | 中 |
ツール・MCP
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Writing effective tools for agents — with agents | writing-tools-for-agents | 高 |
| ✅ | Code execution with MCP: Building more efficient agents | code-execution-with-mcp | 高 — MCP のトークン効率 |
| ✅ | Equipping agents for the real world with Agent Skills | equipping-agents-for-the-real-world-with-agent-skills | 高 |
| ✅ | Introducing advanced tool use on the Claude Developer Platform | advanced-tool-use | 中 |
| ✅ | Desktop Extensions: One-click MCP server installation | desktop-extensions | 低 |
Claude Code
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Beyond permission prompts: making Claude Code more secure and autonomous | claude-code-sandboxing | 中 |
| ✅ | How we built Claude Code auto mode | claude-code-auto-mode | 中 |
Claude Code のベストプラクティス本体は Engineering ブログではなく
code.claude.com/docs/en/best-practices(§2 参照)。
評価 (evals)
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | Demystifying evals for AI agents | demystifying-evals-for-ai-agents | 高 |
| ✅ | Designing AI-resistant technical evaluations | AI-resistant-technical-evaluations | 中 |
| ✅ | Quantifying infrastructure noise in agentic coding evals | infrastructure-noise | 中 — eval の再現性 |
| ✅ | Eval awareness in Claude Opus 4.6’s BrowseComp performance | eval-awareness-browsecomp | 低 — モデル固有 |
| ✅ | Raising the bar on SWE-bench Verified with Claude 3.5 Sonnet | swe-bench-sonnet | 低 — モデル固有・古い |
安全性・運用
| 記事 | URL slug | 優先度 | |
|---|---|---|---|
| ✅ | How we contain Claude across products | how-we-contain-claude | 中 |
参考(ベストプラクティスではなく事例報告)
Claude の使い方についての主張を持たない事例報告なので、日本語のページは作らず、
出典としてここに URL だけ挙げている(主張を持つ事例は sources/ に取り込む)。
- An update on recent Claude Code quality reports(
april-23-postmortem) — https://www.anthropic.com/engineering/april-23-postmortem - A postmortem of three recent issues(
a-postmortem-of-three-recent-issues) — https://www.anthropic.com/engineering/a-postmortem-of-three-recent-issues
2. Claude Code ドキュメント
https://code.claude.com/docs/en/ (日本語: /docs/ja/)
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Best practices for Claude Code | best-practices | 最高 — Claude Code 運用の中核 |
| ✅ | How Claude Code works | how-claude-code-works | 高 — agentic loop の内部 |
| ✅ | Extend Claude Code(skills/hooks/MCP/subagents/plugins の使い分け) | features-overview | 高 — 判断ガイドとして実用性が高い |
| ✅ | How Claude remembers your project(CLAUDE.md、auto memory) | memory | 高 |
| ✅ | Explore the context window | context-window | 高 — 起動時に何が読まれるかの実測 |
| ✅ | Extend Claude with skills | skills | 高 |
| ✅ | Create custom subagents | sub-agents | 高 |
| ✅ | Orchestrate subagents at scale with dynamic workflows | workflows | 高 |
| ✅ | Common workflows | common-workflows | 中 — レシピ集 |
| ✅ | Automate actions with hooks | hooks-guide / hooks | 中 → sources/hooks-guide.md(解説)と sources/hooks.md(リファレンス)の2本に分解 |
| ✅ | Connect Claude Code to tools via MCP | mcp | 中 |
| ✅ | Orchestrate teams of Claude Code sessions | agent-teams | 中 |
| ✅ | Message your other Claude Code sessions | cross-session-messaging | 高 — SendMessage の適用範囲がチーム外へ広がった。信頼モデルが要点 |
| ✅ | Choose a permission mode / Configure permissions | permission-modes / permissions | 中 → sources/permission-modes.md と sources/permissions.md の2本に分解 |
| ✅ | Manage costs effectively | costs | 中 |
| ✅ | Set up Claude Code in a monorepo or large codebase | large-codebases | 中 |
| ✅ | Run Claude Code programmatically | headless | 中 |
| ✅ | Claude Code settings | settings | 低 — リファレンス |
| ✅ | Run parallel sessions with worktrees | worktrees | 高 — 並行セッションの隔離。4つの検査で強制され、1つは切れない |
| ✅ | Manage sessions | sessions | 高 — 再開で戻らないもの(起動フラグと permission mode)の境目 |
| ✅ | Model configuration | model-config | 高 — default の解決先、effort の既定、auto-compact の窓の優先順位 |
| ✅ | Plugins overview | plugins/overview(旧 plugins) | 中 — 以前の取得で概要ページになっていた。部品は単体で動く。有効な plugin は使わないセッションでも毎ターン context を食う |
| ✅ | Create a Claude Code plugin | plugins/create | 中 — 旧 plugins ページの本文の移り先。部品を .claude-plugin/ に入れると読まれず、移行中は hook が二重に走る |
| ⬜ | Install and manage plugins | plugins/install | 中 — 旧 plugins ページから分かれた子ページ(以下 plugins/* は同じ) |
| ⬜ | Plugin components | plugins/components | 低 — 部品の種類ごとの例 |
| ⬜ | Plugin manifest reference | plugins/manifest-reference | 低 — リファレンス |
| ⬜ | Plugin loading reference | plugins/loading | 低 — リファレンス |
| ⬜ | Plugin security and trust | plugins/security | 中 |
| ⬜ | Measure plugin cost and usage | plugins/measure | 中 |
| ⬜ | Publish and distribute a plugin | plugins/publish | 低 |
| ⬜ | Create a marketplace | plugins/create-marketplace | 低 |
| ⬜ | Host and maintain a marketplace | plugins/host-marketplace | 低 |
| ⬜ | Anthropic’s marketplaces | plugins/anthropic-marketplaces | 低 |
| ⬜ | Manage plugins for your organization | plugins/org | 低 |
| ⬜ | Troubleshoot plugins | plugins/troubleshooting | 低 |
| ⬜ | Plugin commands reference | plugins/cli-reference | 低 — リファレンス |
| ⬜ | Plugin dependencies | plugins/dependencies | 低 |
| ⬜ | Test plugins with evals | plugin-evals | 中 — plugins/ の外にある関連ページ |
| ✅ | Mods overview | plugins/mods/overview | 高 — permissions / permission-modes から発見。JavaScript / TypeScript のイベントハンドラで動く plugin。tool.check を扱う mod は ask ルール・hook のブロック・分類器・(条件つきで)deny ルールを覆して承認できる |
| ✅ | Create a mod | plugins/mods/create | 中 — 同上 |
| ✅ | Manage mods for your organization | plugins/mods/admin | 中 — 同上。deny ルールが mod に勝つかどうかの組織側の設定 |
| ✅ | React to events | plugins/mods/events | 中 — hooks から発見。mod が JavaScript の関数として登録する hook |
| ✅ | CLI reference | cli-reference | 低 — リファレンス。要約せず原典へ送る |
| ✅ | Environment variables | env-vars | 低 — リファレンス。他の原典が挙げる変数の正典 |
| ✅ | Tools reference | tools-reference | 低 — リファレンス。permission ルールに書くツール名 |
| ✅ | Glossary | glossary | 低 — 用語確認用 |
| ✅ | What’s new(週次) | whats-new/index | 低 — 鮮度確認の起点として有用 |
3. Claude Developer Platform ドキュメント
https://platform.claude.com/docs/en/intro (日本語: /docs/ja/...)
platform.claude.com/docs/enおよび.../docs/en/はどちらも/docs/en/introへ転送される。 各ページの実URLは、ホストplatform.claude.com+/docs/en/+ 下表の「パス」欄を連結した形。
プロンプト設計
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Prompting best practices(公式が「living reference。まずここから」と明言) | build-with-claude/prompt-engineering/claude-prompting-best-practices | 最高 |
| ✅ | Prompt engineering overview | build-with-claude/prompt-engineering/overview | 中 — 上記への導線 |
| ✅ | Prompting Claude Opus 5 | build-with-claude/prompt-engineering/prompting-claude-opus-5 | 高 — モデル固有の調整 |
| ✅ | Prompting Claude Sonnet 5 / Opus 4.8 / Fable 5 | 同ディレクトリ | 中 → prompting-claude-sonnet-5.md / prompting-claude-opus-4-8.md / prompting-claude-fable-5.md の3本に分解 |
| ⬜ | Prompting Claude Fable 5.1 / Mythos 5.1 | build-with-claude/prompt-engineering/prompting-claude-fable-5-1 | 高 — claude-prompting-best-practices の表で発見。Fable 5 との差(thinking ブロックをそのまま返す、ツール呼び出しのバッチ化ほか) |
| ⬜ | Prompting Claude Opus 5.5 | build-with-claude/prompt-engineering/prompting-claude-opus-5-5 | 高 — 同上。Opus 5 との差(thinking 無効前提の prompt、安全機構の誤検知ほか) |
| ✅ | Claude Sonnet 5.5 migration guide | models/sonnet-5-5/migration-guide | 中 — Sonnet 5 のコードからの破壊的変更と、Sonnet 4.6 以前からの手順(claude-prompting-best-practices から発見) |
| ✅ | Prompting Claude Sonnet 5.5 | build-with-claude/prompt-engineering/prompting-claude-sonnet-5-5 | 高 — thinking の原典から発見。between_tools で事前の thinking を切って走らせるときの prompt、ユーザー向けの進捗更新 |
Agent Skills
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Skill authoring best practices | agents-and-tools/agent-skills/best-practices | 最高 |
| ✅ | Agent Skills overview | agents-and-tools/agent-skills/overview | 中 |
ツール使用
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Manage tool context | agents-and-tools/tool-use/manage-tool-context | 高 |
| ✅ | Define tools | agents-and-tools/tool-use/define-tools | 中 |
| ✅ | Programmatic tool calling | agents-and-tools/tool-use/programmatic-tool-calling | 中 |
| ✅ | Tool search tool(ツールが多数あるとき) | agents-and-tools/tool-use/tool-search-tool | 中 |
| ✅ | Memory tool | agents-and-tools/tool-use/memory-tool | 中 |
| ✅ | Code execution tool | agents-and-tools/tool-use/code-execution-tool | 中 — サンドボックスの制約と課金。web search と併用すると無料 |
| ✅ | Computer use tool | agents-and-tools/tool-use/computer-use-tool | 中 — クライアントツールセット。座標系とスクリーンショット履歴が要点 |
コンテキスト管理
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Context windows | build-with-claude/context-windows | 高 |
| ✅ | Compaction | build-with-claude/compaction | 高 — 概要ページになった。3方式の比較と「使えるなら要求時」 |
| ✅ | Compaction on demand | build-with-claude/compaction-on-demand | 高 — 要求時方式。差し替えの誤り2つはエラーにならない |
| ✅ | Compaction at a token threshold | build-with-claude/compaction-threshold | 中 — 閾値方式。旧 compaction ページの本文の移り先 |
| ✅ | Compaction and preserved thinking | build-with-claude/compaction-thinking-blocks | 高 — 要求時方式で残したターンの thinking を有効に保つ条件。以前は compaction の要約にあった内容の移り先 |
| ⬜ | Compaction that keeps recent turns | build-with-claude/compaction-keep-recent-turns | 中 — 直近のターンを原文のまま残す |
| ⬜ | Compaction in the background | build-with-claude/compaction-background | 中 — 要約を裏で走らせて差し替える。以前は compaction の要約にあったコードの移り先 |
| ✅ | Context editing | build-with-claude/context-editing | 中 |
| ✅ | Prompt caching | build-with-claude/prompt-caching | 中 — コスト直結 |
| ✅ | Thinking / Steering thinking / Effort | build-with-claude/thinking*, build-with-claude/effort | 中 → thinking.md / thinking-steering-and-cost.md / effort.md の3本に分解 |
| ✅ | Troubleshooting thinking | build-with-claude/thinking-troubleshooting | 高 — モデル別に 400 で蹴られる設定の正典。症状から引ける |
評価・品質
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Define success criteria and build evaluations | test-and-evaluate/develop-tests | 最高 — evals の起点 |
| ✅ | Reduce hallucinations | test-and-evaluate/strengthen-guardrails/reduce-hallucinations | 高 |
| ✅ | Increase output consistency | test-and-evaluate/strengthen-guardrails/increase-consistency | 中 |
| ✅ | Mitigate jailbreaks and prompt injections | test-and-evaluate/strengthen-guardrails/mitigate-jailbreaks | 中 |
| ✅ | Reducing latency | test-and-evaluate/strengthen-guardrails/reduce-latency | 中 |
その他
| ページ | パス | 優先度 | |
|---|---|---|---|
| ✅ | Choosing the right model | about-claude/models/choosing-a-model | 中 |
| ✅ | Securely deploying AI agents | code.claude.com agent-sdk/secure-deployment | 中 |
| ✅ | Use case guides(分類、ticket routing、content moderation 等) | about-claude/use-case-guides/overview | 中 |
| ✅ | Prompt library | code.claude.com prompt-library | 低 |
4. ブログ・その他(Engineering 以外)
| 資料 | URL | 優先度 | |
|---|---|---|---|
| ✅ | How Claude Code works in large codebases | https://claude.com/blog/how-claude-code-works-in-large-codebases-best-practices-and-where-to-start | 高 — エージェント検索の代償と、harness を削る周期 |
| ✅ | The evolution of agentic surfaces: building with Claude Managed Agents | https://claude.com/blog/building-with-claude-managed-agents | 中 — 脳と手の分離。TTFT を p50 で約60%削減 |
| ✅ | New in Claude Managed Agents: dreaming, outcomes, and multiagent orchestration | https://claude.com/blog/new-in-claude-managed-agents | 中 — outcomes(別 context の採点役)で最大10ポイント |
| ✅ | Increase web search accuracy and efficiency with dynamic filtering | https://claude.com/blog/improved-web-search-with-dynamic-filtering | 中 — 結果を context 前に絞る。BrowseComp 45.3→61.6 の出典 |
| ✅ | Improving frontend design through Skills | https://claude.com/blog/improving-frontend-design-through-skills | 中 — 分布収束と、禁止が別の既定を作る問題。約400トークンの prompt |
| ✅ | Measuring AI agent autonomy in practice | https://www.anthropic.com/news/measuring-agent-autonomy | 高 — 実運用での裁量の実測。deployment overhang |
| ✅ | Clio: privacy-preserving insights into real-world AI use | https://www.anthropic.com/research/clio | 中 — 上の実測を支える方法論 |
| ✅ | Claude can now create and edit files | https://claude.com/blog/create-files | 低 — 製品告知。「Claude のコンピュータ」の記述だけが他の原典の前提 |
| ✅ | Multi-agent coordination patterns: Five approaches and when to use them | https://claude.com/blog/multi-agent-coordination-patterns | 高 — 5つの協調パターンを壊れ方で切り分ける |
| ✅ | How Anthropic runs large-scale code migrations with Claude Code | https://claude.com/blog/ai-code-migration | 高 — コードではなくループを直す。実測のトークン量つき |
| ✅ | Agent Harness Design: 3 Patterns for Harnessing Claude’s Intelligence | https://claude.com/blog/harnessing-claudes-intelligence | 高 — harness 設計の3パターン。「何をやめられるか」 |
| ✅ | Building multi-agent systems: When and how to use them | https://claude.com/blog/building-multi-agent-systems-when-and-how-to-use-them | 高 — multi-agent を使う/使わない判断と、分割線の引き方 |
| ✅ | Best practices for prompt engineering | https://claude.com/blog/best-practices-for-prompt-engineering | 高 — 大半はモデルを問わない一般論 |
| ✅ | Maximizing the value of your Claude Code sessions | https://claude.com/blog/maximizing-the-value-of-your-claude-code-sessions | 高 — セッションの請求額を決めるもの。prompt cache を捨てる操作の一覧 |
| ✅ | A harness for every task: dynamic workflows in Claude Code | https://claude.dev/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code/ | 高 — Claude Code チーム自身の使い方 |
| ✅ | Lessons from building Claude Code: How we use skills | https://claude.dev/blog/lessons-from-building-claude-code-how-we-use-skills/ | 高 — 社内の skill の9分類と書き方(落とし穴の節、description は発火条件) |
| ✅ | The new rules of context engineering for Claude 5 generation models | https://claude.dev/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models/ | 高 — system prompt を8割削っても落ちなかった。規則より判断、例より設計 |
| ✅ | Getting the most out of Opus 5.5 | https://claude.dev/blog/getting-the-most-out-of-opus-5-5/ | 中 — Opus 5.5 の使い方(完了条件を言って任せる、止まる規則を CLAUDE.md に) |
| ✅ | How we made claude.ai faster | https://claude.dev/blog/how-we-made-claude-ai-faster/ | 中 — 事例。測ることがそのまま取り組めることになる、CI のラチェット、人の舵取り |
| ✅ | Using Claude Code: Spending your effort | https://claude.dev/blog/spending-your-effort/ | 高 — effort が何を変えるか(検証とエッジケース)と使い分け |
| ✅ | What a task costs on Opus 5.5 | https://claude.dev/blog/what-a-task-costs-on-opus-5-5/ | 高 — タスクの値段を決める4つと、キャッシュと compaction の損得 |
| ✅ | Automating eval design and hillclimbing with Claude | https://claude.dev/blog/automating-eval-design-and-hillclimbing/ | 高 — 良い eval の4条件と、過学習を避ける hillclimb |
| ✅ | Building with Claude Sonnet 5.5 | https://claude.dev/blog/building-with-claude-sonnet-5-5/ | 中 — Sonnet 5.5 と Opus 5.5 の使い分け、価格、移行の要点 |
| ✅ | Getting started with Claude Code mods | https://claude.dev/blog/getting-started-with-claude-code-mods/ | 中 — mod 入門。作例3つと4つの習慣 |
| ✅ | How to prepare for AI-driven code modernization projects | https://claude.com/blog/how-to-prepare-for-ai-driven-code-modernization-projects | 高 — 目標・証明書・昇格の方針を先に決める。ボトルネックは組織側に移る |
| ✅ | Coding sessions are longer and use more context. Claude Opus 5.5 is built with that in mind. | https://claude.com/blog/claude-opus-5-5-built-for-coding-sessions-that-use-more-context | 中 — Claude Code の使われ方の集計(context 2.6倍)とキャッシュの守り方 |
| ✅ | Claude in Chrome is generally available | https://claude.com/blog/claude-in-chrome-generally-available | 中 — ブラウザの注入対策の3層と評価の数字 |
| ✅ | Built-in memory for Claude Managed Agents | https://claude.com/blog/claude-managed-agents-memory | 低 — memory をファイルシステムに置く理由 |
| ✅ | How Anthropic’s sales team rebuilt inbound with Claude Managed Agents | https://claude.com/blog/how-anthropics-sales-team-rebuilt-inbound-with-claude-managed-agents | 中 — 事例。規則より目的、prompt は短く、引き継ぎをフィードバックに |
| ✅ | Working at the frontier: How Balyasny Asset Management evaluates and governs Claude Fable 5 | https://claude.com/blog/working-at-the-frontier-how-balyasny-asset-management-evaluates-and-governs-claude-fable-5 | 中 — 事例。実タスクでの評価と、モデルの周りに置く統制 |
| ✅ | Agents you can coach: how Asana builds human-agent teams with Claude | https://claude.com/blog/agents-you-can-coach-how-asana-builds-human-agent-teams-with-claude | 中 — 事例。役割・起動者に縛られる権限・使うことと鍛えることの分離 |
| ✅ | How Cresta turned CX expertise into an agent builder on the Claude Agent SDK | https://claude.com/blog/how-cresta-turned-cx-expertise-into-an-agent-builder-on-the-claude-agent-sdk | 中 — 事例。柔軟さと決定性の線引き、成果・経路・品質・資源の評価 |
| ✅ | How Anthropic teams use Claude Code (PDF) | https://www-cdn.anthropic.com/58284b19e702b49db9302d5b6f135ad8871e7658.pdf | 中 — 社内事例集 |
| ✅ | prompt-eng-interactive-tutorial | https://github.com/anthropics/prompt-eng-interactive-tutorial | 中 — 手を動かす用 |
| ✅ | claude-cookbooks | https://github.com/anthropics/claude-cookbooks | 中 — 実装レシピ |