Claude Code導入ガイド — インストールからCLAUDE.mdの書き方まで

Claude Codeとは何か

Claude Codeは、ターミナルから「この機能を実装して」と依頼するだけで、計画→実装→テスト→修正まで自律的に進めてくれるエージェント型コーディングツールです。個人開発では「自分がプロダクトオーナー、Claude Codeが開発チーム」という役割分担が成立します。

インストール

前提: Node.js 18以上が必要です(未導入なら https://nodejs.org からLTS版を)。

npm install -g @anthropic-ai/claude-code

プロジェクトのフォルダに移動して起動します:

cd my-project
claude

初回はブラウザが開いてログインを求められます。Claude Pro/Maxのサブスクリプション、またはAPIキー(従量課金)のどちらでも利用できます。個人開発を本格的にやるならProプラン($20/月)が定額で使えて安心です。

最初に覚える操作は3つだけ

• タスクを日本語で依頼する: 「ログイン機能を追加して」のように書くだけ。ファイル編集の前に確認を求められるので、内容を見て承認します。
• /init: プロジェクトを解析してCLAUDE.mdの雛形を自動生成してくれます。まずこれを実行しましょう。
• Escキー: 動作を止めたいときはEsc。いつでも中断・方向修正できます。

CLAUDE.mdがAIの精度を決める

CLAUDE.mdはプロジェクトのルートに置く「AIへの申し送り書」です。Claude Codeは毎回これを読んでから作業するため、ここの品質がそのまま出力の品質になります。

# プロジェクト概要
家計簿WebアプリをAstro + Supabaseで開発している。

# 技術スタック
- Astro 5 / TypeScript / Tailwind
- DB: Supabase(スキーマは supabase/schema.sql)

# ルール
- UIテキストは日本語
- コミットメッセージは Conventional Commits
- DBスキーマ変更時は必ずschema.sqlも更新

コツは「毎回口頭で言いたくなることを全部書く」こと。Claudeの出力を修正したら、その修正理由をCLAUDE.mdに追記していくと、同じ指摘が二度と不要になります。

次のステップ

導入が済んだら、実際にWebアプリを1つ作ってみましょう。「AI個人開発 Webアプリ入門ロードマップ」の次のステップに進んでください。