Claude Code の使い方と活用パターン

#Claude Code とは

Anthropic が提供する ターミナルで動くコーディングエージェント。リポジトリを読み、ファイルを編集し、コマンドを実行し、テストを回してコミットまでを自律的に行う。CLI のほか、デスクトップアプリ、Web（claude.ai/code）、VS Code / JetBrains 拡張がある。

#基本操作

# インストール
npm install -g @anthropic-ai/claude-code

# プロジェクトのルートで起動
cd my-project
claude

# 1回だけ実行して終了（スクリプトから使う）
claude -p "テストが落ちている原因を調べて修正して"

よく使うスラッシュコマンド:

#CLAUDE.md でプロジェクトの前提を教える

リポジトリ直下の CLAUDE.md は毎回のセッションで自動的に読み込まれる。ここに プロジェクト固有のルール を書いておくと、毎回説明する手間が省け、出力の一貫性が上がる。

# プロジェクト概要
Next.js 15 + TypeScript の EC サイト。

# コマンド
- 開発: `npm run dev`
- テスト: `npm test`（変更後は必ず実行）
- Lint: `npm run lint`

# コーディング規約
- 関数コンポーネント + hooks のみ
- API 呼び出しは `src/lib/api/` に集約
- コミットメッセージは Conventional Commits

# 触ってはいけないもの
- `src/legacy/` 配下は変更禁止
- `.env*` は読み書きしない

#効果的な指示の出し方

#1. まず調査させる

いきなり「実装して」より、「まず関連コードを読んで、実装方針を提案して」 と段階を分ける方が手戻りが少ない。

ユーザー認証にパスキー対応を追加したい。
まず既存の認証周りのコードを読んで、変更が必要なファイルと方針を提案して。実装はまだしないで。

#2. 完了条件を明示する

- `npm test` が全部通ること
- `npm run lint` でエラーが出ないこと
- 変更内容を1つのコミットにまとめること

#3. 検証手段を与える

テスト、型チェック、スクリーンショットなど、自分で正しさを確認できる手段 があると品質が大きく上がる。テストがないなら「先にテストを書いてから実装して」と頼む。

#4. スコープを区切る

大きな作業は分割する。1セッションで1機能が目安。コンテキストが膨らんだら /compact か /clear。

#よく使うワークフロー

#バグ修正

issue #123 の再現手順に従ってバグを再現し、原因を特定して修正して。
修正後、再発防止のテストを追加して。

#リファクタリング

`src/utils/date.ts` の関数群を、挙動を変えずに整理して。
- 変更前後でテストが通ることを確認
- 公開APIは変えない

#コードベースの理解

このリポジトリのアーキテクチャを説明して。
主要なディレクトリの役割、データの流れ、エントリーポイントを図で。

#コミット・PR

変更内容を確認して、適切な粒度でコミットを分けて。
その後 PR を作成して。説明には変更理由とテスト方法を書いて。

#権限とセーフティ

• ファイル編集やコマンド実行は既定で 確認プロンプト が出る
• 信頼できるコマンドは許可リストに追加して手間を減らす
• 危険な操作（rm -rf、force push、本番デプロイ）は必ず自分で確認
• 秘密情報（.env、認証情報）はエージェントから読めないようにしておく

#拡張機能

• MCP サーバー: 外部ツール（DB、ブラウザ、Slack など）を接続
• スキル: 特定の作業手順をパッケージ化して再利用
• フック: ツール実行前後に自動処理（フォーマッタの自動実行など）
• サブエージェント: 調査やレビューを並列で分担

#まとめ

• CLAUDE.md にプロジェクトのルールを書く
• 「調査 → 方針 → 実装 → 検証」の段階を踏ませる
• 完了条件と検証手段を与える
• 権限は最小限、危険操作は人間が確認