Claude Code プロジェクトを
コマンド一発で正しく始める

Start your Claude Code project
right, with one command

迷わない。シンプル。クリーン。
最適なディレクトリ構造と設定ファイル一式を、解説付きで自動生成します。

No confusion. Simple. Clean.
Generates the ideal directory structure and config files — with documentation built in.

ターミナルに貼り付けるだけ:
Just paste into your terminal:
curl -fsSL https://raw.githubusercontent.com/AgenticAIJP/ClaudeCodeAutoSetup/main/setup.sh | bash
✅ 完全オープンソース (MIT) 💰 非営利・広告なし 🌏 日本語 / English
✅ Fully open source (MIT) 💰 Non-profit, no ads 🌏 日本語 / English

使い方は3ステップ

Three steps

Node.js も npm も不要。bash と curl があれば動きます。

No Node.js, no npm. Just bash and curl.

STEP 1

コマンドを実行

Run the command

上のコマンドをターミナルに貼り付けて Enter。言語(日本語/English)を選択。

Paste the command above and hit Enter. Pick your language (日本語/English).

STEP 2

タイプと名前を選ぶ

Pick a type and name

6種類から番号を選んで、プロジェクト名を入力するだけ。

Choose one of six types, type a project name — that's it.

STEP 3

claude を起動

Launch claude

CLAUDE.md の TODO を3箇所埋めたら、もう開発を始められます。

Fill in three TODOs in CLAUDE.md and you're ready to build.

6つのプロジェクトタイプ

Six project types

用途に合わせて、最適な構造とルールが生成されます。

Each generates the right structure and rules for the job.

🧱

汎用ベース

Generic base

まずはこれ。最小のきれいな骨格。

Start here. A minimal, clean skeleton.

src/ tests/ docs/ tasks/
🌐

Webアプリ型

Web app

前後端分離。API境界のルール付き。

Split front/back, with API-boundary rules.

frontend/ backend/
🔌

APIサービス型

API service

仕様書の自動更新ルールが特徴。

Specs kept in sync with the code, by rule.

routes/ services/ models/
⌨️

CLIツール型

CLI tool

stdout/stderr 分離・終了コード規約。

stdout/stderr discipline, exit-code rules.

commands/ handlers/
🤖

AI Agent型

AI Agent

MCP設定例つき。1エージェント1責務。

MCP config samples. One agent, one job.

agents/ skills/ tools/
📚

ドキュメント型

Documentation

学習サイト・技術ブログ。記事雛形つき。

Learning sites and blogs, with article boilerplate.

docs/ examples/ templates/

設計哲学: 困った場所の隣に、答えがある

Design philosophy: the answer sits next to the question

すべての設定ファイルの隣に、日英それぞれの解説(*.ja.sample.md / *.en.sample.md)がペアで置かれます。README を探し回る時間はゼロ。

Every config file ships with documentation right next to it, in both languages (*.ja.sample.md / *.en.sample.md). Zero time spent hunting through READMEs.

.claude/rules/
├── architecture.md              ← Claude が読む(ルール本体)
├── architecture.ja.sample.md    ← あなたが読む(日本語解説)
└── architecture.en.sample.md    ← 英語話者のチームメイトが読む
.claude/rules/
├── architecture.md              ← Claude reads this (the rules)
├── architecture.en.sample.md    ← you read this (why, how, effects)
└── architecture.ja.sample.md    ← your Japanese teammates read this

✅ ルールを書いた場合

✅ With rules

Claude はビジネスロジックを core 層に置き、アーキテクチャを守る。仕様書も同じ変更で更新される。

Claude keeps business logic in the core layer and respects the architecture. Specs get updated in the same change.

❌ 書かなかった場合

❌ Without rules

Claude は最短経路でコードを書く。3回の機能追加で main が500行になり、構造が崩壊する。

Claude takes the shortest path. Three features later, main is 500 lines and the architecture has collapsed.

学習ロードマップ

Learning roadmap

自分のレベルを選んで、そこから始めてください。

Pick your level and start there.

Level 1

概念理解 — 読むだけ

Concepts — just read

⏱ 約30分
⏱ ~30 minutes
  • Claude Code とは何か / 通常の Claude との違い
  • CLAUDE.md の役割と書き方の基本
  • プロジェクト構造がなぜ重要か(Before / After)
  • /init コマンドで CLAUDE.md を自動生成する方法
  • What Claude Code is / how it differs from regular Claude
  • What CLAUDE.md does and how to write one
  • Why project structure matters (Before / After)
  • Auto-generating CLAUDE.md with /init
Level 2

実戦設定 — 手を動かす

Hands-on setup

⏱ 1〜2時間
⏱ 1-2 hours
  • settings.json(permissions / hooks)の設定
  • カスタムスラッシュコマンドの作り方(.claude/commands/)
  • Hooks の設定(PreToolUse / PostToolUse / Stop)
  • CLAUDE.md の三層階層(グローバル / プロジェクト / サブディレクトリ)
  • Configuring settings.json (permissions / hooks)
  • Building custom slash commands (.claude/commands/)
  • Setting up hooks (PreToolUse / PostToolUse / Stop)
  • The three-layer CLAUDE.md hierarchy (global / project / subdirectory)
Level 3

高度な活用 — 本番レベル

Advanced — production level

⏱ チーム・本番運用
⏱ teams & production
  • MCP サーバーの接続(GitHub / DB / Slack)
  • Multi-agent 協調(Claude が Claude を呼び出す)
  • 大規模プロジェクトでのコンテキスト管理戦略
  • カスタム MCP サーバーの自作
  • Connecting MCP servers (GitHub / DB / Slack)
  • Multi-agent orchestration (Claude calling Claude)
  • Context-management strategies for large projects
  • Building your own MCP server

公式学習リソース

Official resources

このサイトの役割は「どこから学ぶか迷わせない」こと。詳細は公式へ。

This site's job is to point you to the right starting place. The details live in the official docs.

GitHub で見る →View on GitHub →