Claude Code プロジェクト初期化

Claude Code プロジェクト初期化は、Claude Code の対話インターフェースで次のように入力できます：

/init

既存のプロジェクトディレクトリで初期化することも、新しいディレクトリを作成することもできます。

まずディレクトリを作成しましょう：

mkdir claude-サンプル-test

そのディレクトリに移動します：

cd claude-サンプル-test

テストファイル test.py を作成します。コードは以下の通りです：

print("Hello, サンプル!")

Claude Code の対話インターフェースに入ります：

claude

使用する/init コマンドでプロジェクトを初期化します：

/init

VS Code を使用する場合、VS Code の Claude Code インターフェースで入力することもできます/init:

Claude は自動的にコードベースをスキャンし、package.json、既存のドキュメント、設定ファイル、コード構造を読み取って、プロジェクト専用の CLAUDE.md ファイルを生成します。

Claude プロセス全体で手動操作は不要です。Claude が自動的に分析し、初期設定を出力します。

CLAUDE.md ファイル

CLAUDE.md はプロジェクトのルートディレクトリに置かれる Markdown ファイルで、Claude Code はセッション開始時に毎回自動的に読み込みます。

CLAUDE.md は Claude のシステムプロンプトの一部となり、毎回の対話でプロジェクトのコンテキストを事前に読み込めるため、基本情報を繰り返し説明する必要がなくなります。

優れた CLAUDE.md は次の3つの側面をカバーする必要があります：

  • WHAT（何か）：技術スタック、プロジェクト構造。Claude にコードベースの全体像を提供します
  • WHY（なぜ）：プロジェクトの目的、各モジュールの機能と役割
  • HOW（どうやって）：開発方法。例えば node ではなく bun を使用する、また Claude が変更を正しく検証する方法 Humanlayer

以下は典型的な CLAUDE.md の構造例です：

# 项目名称

## 项目概述
简述这个项目的目的和功能。

## 技术栈
- Frontend: React + TypeScript
- Backend: Node.js + Express
- Database: PostgreSQL

## 目录结构
- `src/components/` - React 组件
- `src/api/`        - API 层
- `tests/`          - 测试文件

## 常用命令
- 启动开发服务器：`pnpm dev`
- 运行测试：`pnpm test`
- 代码检查：`pnpm lint`

## 开发规范
- 使用 TypeScript strict 模式
- 优先使用 interface 而非 type
- 禁止使用 any，使用 unknown 替代
```

### 文件位置与层级

项目的核心文件结构如下： 
```
your-project/
├── CLAUDE.md                  # 项目主记忆文件（团队共享）
├── .claude/
│   ├── settings.json          # Hooks、权限、环境配置
│   ├── settings.local.json    # 个人配置（建议加入 .gitignore）
│   └── commands/              # 自定义斜杠命令
│       └── my-command.md
└── .mcp.json                  # MCP 服务配置
```

初期化後のベストプラクティス

一度に書き切るのではなく、反復的に最適化する。

/initコマンドはクイックスタートに適していますが、真の価値は時間とともに反復的に改善していくことにあります。Claude が自動的に推測できない内容（ブランチ命名規則、デプロイフロー、コードレビュー要件など）を補足し、同時に適用できない一般的なアドバイスを削除します。

  • バージョン管理にコミットする：～をCLAUDE.mdGit にコミットすると、チーム全体がその恩恵を受けられます。新しいメンバーは Claude にコードベースを説明させることで、迅速に習得できます。

  • 簡潔に保つ：内容は簡潔で広く適用できるものにします。「プログレッシブ・ディスクロージャー（段階的開示）」の原則を採用します——Claude に知ってほしい内容をすべて詰め込むのではなく、次のことを伝えます重要な情報の見つけ方、必要なときに取得させることで、コンテキストウィンドウを圧迫するのを防ぎます。

  • CLAUDE.md を linter の代わりにしない：ファイルにコードスタイルの規約を書くことは、最もよくある誤解の1つです。LLM に linter の仕事をさせるべきではありません——linter はより速く、より安価で、決定的です。コードスタイルの制約はコンテキストウィンドウを肥大化させ、Claude の指示への従順さを低下させるだけです。

使用#ショートカットキーは随時更新

対話中はいつでも#プレフィックスを使用して Claude に記憶コマンドを送信できます：

# 我们始终使用 pnpm，不用 npm
# 所有组件必须包含单元测试

これらの補足は徐々に蓄積され、チームの実際の作業方法を真に反映したものになりますCLAUDE.md。

初期化効果の検証

初期化が完了したら、以下の対話で Claude がプロジェクトを正しく理解しているか確認できます：

  • このプロジェクトは何をするものですか？
  • ディレクトリ構造を説明してください。
  • プロジェクトはどの技術を使用していますか？
  • テストを実行するコマンドは何ですか？
その他の拡張