
2026/03/27 23:35
**`.claude/` フォルダの構成** - `config.json` ― ユーザー設定や好みを保存します。 - `history.log` ― すべての対話ログを参照用に記録します。 - `models/` ― ダウンロード済み Claude モデルと関連メタデータが格納されています。 - `sessions/` ― アクティブなチャットスレッドなど、臨時セッション情報を保持します。 - `logs/` ― デバッグやパフォーマンス監視のためのシステムログです。 このようにフォルダ構成を整えることで、Claude AI 環境が円滑に動作し、保守も容易になります。
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
サマリー
Postman と Claude Code はともに AI で拡張されたワークフローを管理するための構造化アプローチを提供しますが、対象とするニーズは異なります。
Postman
- コスト削減分析 を公開し、AI 統合有無で比較した6つの一般的な API 開発パイプラインを提示しています。
- このレポートはエンジニアリングリードに対して AI ネイティブツール導入の ROI 指標を明確に提供します。
Claude Code
ディレクトリ を構成ファイルの制御センターとして使用し、指示・カスタムコマンド・許可ルール・セッション間メモリを管理します。.claude- 二つのレベルがあります:
プロジェクトレベル(
)– Git にコミットされる。.claude/
グローバル(
)– 個人設定とマシン固有状態を保持します。~/.claude/
- 二つのレベルがあります:
- 最も重要なファイルは
です。その内容が対話全体で Claude のシステムプロンプトになります。良いコンテンツにはビルド/テスト/リンティングコマンド、アーキテクチャ決定事項、注意点、インポート規約、およびフォルダ構成が含まれます—理想的には 200 行程度に収める。CLAUDE.md- コミットすべきでない個人調整は
(git‑ignored)をメインのCLAUDE.local.md
と同じ場所に作成します。CLAUDE.md
- コミットすべきでない個人調整は
フォルダ は指示をフォーカスした Markdown ファイルに分割でき、各ファイルは YAML フロントマターの.claude/rules/
ブロックで一致するファイルパスにのみ有効化できます。paths- コマンド は
(プロジェクト固有)または.claude/commands/
(グローバル)に格納されます。各 Markdown ファイルが~/.claude/commands/
コマンドとして名前付きになります(例:/
)。コマンドはreview.md → /project:review
構文でシェル出力を埋め込み、!
で引数を受け取ります。$ARGUMENTS - スキル は
または.claude/skills/
に定義される自律ワークフローです。各スキルには YAML フロントマターを使用して会話が説明と一致した時に自動的にトリガーされる~/.claude/skills/
が付属します。スキルはサポートファイル(例:SKILL.md
)をまとめることもできます。DETAILED_GUIDE.md - サブエージェント は
に位置し、各エージェントは Markdown ファイルでシステムプロンプト、ツールアクセス、およびモデル設定を指定します。これによりコードレビューやセキュリティ監査などのタスク用に隔離されたコンテキストが提供されます。.claude/agents/
は許可および拒否するコマンド/ツール(例:Bash スクリプトを許可、破壊的なシェルコマンドやネットワーク呼び出し、機密ファイルを拒否)を制御します。settings.json
を作成すればユーザーごとに上書きが可能で、変更をコミットせずに設定できます。settings.local.json
推奨セットアップの進行
を実行して初期/init
を生成します。CLAUDE.md- 生成されたファイルをトリミングし、簡潔に編集します。
- 適切な許可/拒否ルールを持つ
を追加します。settings.json - 必須コマンド(例:コードレビュー)を作成します。
- 必要に応じて指示を
に分割します。.claude/rules/ - 個人設定用のグローバル
を追加します。~/.claude/CLAUDE.md
これらのツールは、Postman の分析でエンジニアリングリードが AI ROI を定量化できる一方、開発者に再現性・バージョン管理されたプロンプトとコマンド構成を提供し、新規採用時のフリクションを低減しつつセキュリティポリシーを強制します。
本文
Postman AI‑ROIガイド
多くのチームは何らかの形でAIを導入していますが、「AIを使う」ことと「AIから測定可能な ROI を得る」こととのギャップは、人々が想像するよりも大きいです。
Postman は、6 つの一般的な API 開発ワークフローに対してコスト削減分析を公開しました。この分析では、プラットフォームに AI が組み込まれた場合と外部で追加された場合の実際の時間・コスト差をベンチマークしています。データ駆動型の短い読み物であり、エンジニアリングリーダーが AI‑ネイティブツールがどこで本当に価値を生むかを主張するのに役立ちます。
ガイドは以下から無料で入手できます → 今日は Postman と提携できたことに感謝します!
Claude Code – .claude
フォルダーの解説
.claudeClaude Code のユーザーは、通常
.claude フォルダーをブラックボックスとして扱います。存在を知り、プロジェクトルートに出現するのを見たことがあるだけで、内部のファイル一つひとつが何をしているかを開いたり理解したりしたことはほとんどありません。それは大きなチャンス損失です。
.claude フォルダーは、Claude がプロジェクト内でどのように振る舞うかを制御するコントロールセンターです。次のものが格納されています:
- あなたの指示
- カスタムコマンド
- 許可規則
- Claude のセッション間メモリ
場所と役割がわかれば、Claude Code をチームに必要な動作を正確に実現できるよう設定できます。
2 つの .claude
ディレクトリ
.claude| 場所 | 用途 |
|---|---|
プロジェクトレベル() | チーム構成 – Git にコミット。共有ルール、コマンド、ポリシー。 |
グローバル() | 個人設定と機械固有の状態(セッション履歴、自動メモリ)。 |
最も重要なファイル:CLAUDE.md
CLAUDE.mdClaude Code セッションを開始すると、最初に読み込まれるのが
CLAUDE.md です。システムプロンプトへ直接ロードされ、会話全体で記憶に留まります。
- 書いた内容 → Claude が従う
- 「実装前に必ずテストを書く」→ Claude はそれを行う。
- 「console.log を使わないで常にカスタムロガーモジュールを使用する」→ Claude は尊重します。
プロジェクトルートに
CLAUDE.md(一般的な設定)、~/.claude/CLAUDE.md にグローバル設定、さらにサブディレクトリ内にフォルダー固有のルール用に置くこともできます。Claude はすべてを読み込み、統合します。
良い CLAUDE.md の書き方
| 書く | 理由 |
|---|---|
ビルド・テスト・リントコマンド(、 など) | コアワークフロー |
| アーキテクチャ上の重要決定(例: 「モノレポを Turborepo で使用」) | コンテキスト |
| 明らかではない落とし穴(「TypeScript strict mode はオン。未使用変数はエラー」) | ミス防止 |
| インポート規則、命名パターン、エラーハンドリングスタイル | 一貫性 |
| 主要モジュールのファイル・フォルダー構成 | ナビゲーション |
| 書かない | 理由 |
|---|---|
| linter や formatter の設定に入るもの | 冗長 |
| リンクできる完全なドキュメント | CLAUDE.md をスリムに保つため |
| 理論を説明する長文パラグラフ | コンテキストを消費 |
CLAUDE.md は 200 行以内に抑えましょう。超えるとコンテキストが奪われ、Claude の指示遵守率が低下します。
最小例(約20行) – Claude に必要な情報をすべて提供しつつ、頻繁な確認を不要にします。
個人設定
あなた専用の好み(テストランナーやファイルオープンパターンなど)がある場合は、プロジェクトルートに
CLAUDE.local.md を作成してください。自動で .gitignore されるため、個人設定がリポジトリに入ることはありません。
規則の整理:.claude/rules/
.claude/rules/大きなファイルを一つ持つ代わりに、関心ごとに分割します:
api-conventions.mdtesting.md- など
各ファイルは焦点が絞られ、更新しやすいです。YAML フロントマターに
paths フィールドを追加すると、Claude が該当ファイル(例: src/api/、src/handlers/)で作業しているときのみ有効になります。paths を持たないルールは無条件で読み込まれます。
コマンド:.claude/commands/
.claude/commands/このフォルダーに入れた Markdown ファイルがスラッシュコマンドになります。
→review.md/project:review
→fix‑issue.md/project:fix‑issue
$ARGUMENTS を使ってコマンド名後のテキストを渡せます(例: /project:fix‑issue 234)。コマンドはコミットされ、チームと共有できます。プロジェクト非依存コマンドは ~/.claude/commands/ に置き、 /user:command-name として利用します。
スキル
スキルは Claude が自動で呼び出せるワークフローです。
- 各スキルは独自サブディレクトリに
を持つ。SKILL.md
は YAML フロントマターで使用条件を記述。SKILL.md- スキルは補助ファイル(例:
)も一緒に配置可能。DETAILED_GUIDE.md
個人スキルは
~/.claude/skills/ に置きます。
エージェント:.claude/agents/
.claude/agents/複雑タスク用にサブエージェント人格を定義します:
- Markdown ファイルが独自システムプロンプト、ツールアクセス、モデル設定。
- 例:
– コードレビューを隔離されたコンテキストウィンドウで実行。code-reviewer.md
tools フィールドでエージェントが使用できる操作(Read, Grep, Glob 等)を制限し、model フィールドでタスク専用の安価・高速モデルを指定できます。
個人エージェントは
~/.claude/agents/ に配置します。
設定:.claude/settings.json
.claude/settings.jsonClaude が実行できるツール、読み込めるファイル、および特定コマンドを実行する前に確認が必要かどうかを制御します。
行 → オートコンプリートとインラインバリデーション。$schema- 許可リスト(確認不要で実行できる):
- Bash (
,npm run *
)make * - Git 読み取り専用コマンド (
)git * - ファイル操作:Read, Write, Edit, Glob, Grep
- Bash (
- 拒否リスト(完全にブロック):
- 破壊的シェルコマンド(
等)rm -rf - ネットワークコマンド(
等)curl - 機密ファイル(
、.env
内のもの)secrets/
- 破壊的シェルコマンド(
リストに載っていない場合は Claude が実行前に確認を求めます。
個人上書きは
.claude/settings.local.json を作成。自動で .gitignore されます。
グローバルファイル
| ファイル | 用途 |
|---|---|
| 個人のコーディング原則、スタイル嗜好など |
| プロジェクト別セッション転写と自動メモリ(発見したコマンド、観測されたパターン、アーキテクチャインサイト) |
, | すべてのプロジェクトで利用可能な個人コマンドとスキル |
はじめに
- Claude Code 内で
を実行 → スタート用/init
が生成。必須項目だけに絞って編集。CLAUDE.md
にスタック固有の許可/拒否ルールを設定(例:実行コマンドは許可、.claude/settings.json
の読み取りは禁止)。.env- よく使うワークフロー用に 1〜2 個のコマンドを作成(コードレビュー、問題修正など)。
が増えてきたら、指示をCLAUDE.md
ファイルへ分割。.claude/rules/- グローバル
に個人設定を追加。~/.claude/CLAUDE.md
これでプロジェクトの 95 % をカバーできます。スキルとエージェントは、再発する複雑なワークフローをパッケージ化したい場合に導入します。
最終的な結論
.claude フォルダーは Claude に「あなたが誰であり、プロジェクトが何をしているか、どんな規則に従うべきか」を伝えるプロトコルです。定義を明確にすればするほど、Claude を修正する時間が減り、有用な作業に費やせる時間が増えます。
小さく始めて、必要に応じて洗練し、
CLAUDE.md をプロジェクトのインフラストラクチャとして扱いましょう。適切に設定すれば、毎日利益を生み出します。
読んでいただきありがとうございます!