Claude Code 実践テクニック15選 — 知らないと損する使いこなし術【2026年版】

エンジニアのゆとです。

Claude Codeを本格的に使い始めて数ヶ月。正直なところ、最初の1週間と今では使い方がまるで違う。最初は「ターミナルで動くChatGPTでしょ？」くらいの認識だったが、掘れば掘るほど「これ、使い方次第で生産性が5倍にも10倍にもなるな」と実感している。

公式ドキュメントを読んだだけでは気づかない、実際に手を動かして初めて分かるテクニックがかなりある。この記事では、自分が日々の開発で実際に使っている Claude Codeの実践テクニック15個 を、具体的なコマンド例やコード例付きで紹介する。

初心者向けの「インストール方法」みたいな話はしない。すでにClaude Codeを触っている人が「あ、こういう使い方あるのか」と思えるレベルの内容を目指した。

Mar 9, 2026 Claude Codeで「副業の全自動化」を作った — Skills・Hooks・MCP・定期実行の実践構成Claude CodeのSkills・Hooks・MCP・LaunchAgentでGA4分析から記事生成・note投稿・X宣伝・SEO通知まで全自動化した実践構成をコード付きで解説。読む →

---

1. CLAUDE.mdの書き方で出力が劇的に変わる

Claude Codeの出力品質を決めるのは、プロンプトの上手さじゃない。CLAUDE.mdの設計だ。

プロジェクトルートに CLAUDE.md を置くと、Claude Codeがセッション開始時に自動で読み込む。ここに「プロジェクトの構成」「コーディング規約」「やってほしいこと・やってほしくないこと」を書いておくと、毎回の指示が格段に減る。

# CLAUDE.md

## プロジェクト概要
- Astro v5 + Cloudflare Workers で構築されたブログサイト
- TypeScript + Tailwind CSS
- コンテンツは src/content/blog/ に .mdx 形式で配置

## コーディング規約
- 変数名はcamelCase、コンポーネントはPascalCase
- CSS-in-JSは使わない。Tailwindのユーティリティクラスを使う
- console.logは本番コードに残さない

## 禁止事項
- node_modulesの中身を直接編集しない
- .envファイルの内容をログに出力しない
- 既存のテストを削除しない

コツは「禁止事項」を明示すること。AIは「やってほしいこと」より「やらないでほしいこと」のほうが守りやすい。「console.logを残さないで」と書くだけで、生成コードからデバッグ用のログが消える。

さらに上級者向けの活用として、自律権限レベルを定義するのもおすすめ:

## 自律権限レベル
- GREEN: ファイル読み書き・コード生成 → 確認不要で実行
- YELLOW: 設定ファイル変更・依存追加 → 事前報告してから実行
- RED: デプロイ・外部API呼び出し → 必ず事前承認を取る

これを書いておくと、Claude Codeが「これはYELLOWなので報告します」と自己判断してくれるようになる。

💡 CLAUDE.mdやCursorのルール設定を書くときに「どんなルールを入れればいいか分からない」という人は、The Prompt Shelfを参考にするといい。95以上のAIコードエディタ向けルールが用途別にまとまっていて、すべて無料で閲覧できる。

2. /init でプロジェクト理解を一発で

新しいプロジェクトをClaude Codeに理解させたいとき、ファイル構成やREADMEを一つずつ読ませるのは非効率。/initコマンド一発でCLAUDE.mdを自動生成させるのが最速。

# プロジェクトルートで
claude
> /init

Claude Codeがディレクトリ構造、package.json、設定ファイル、既存のREADMEなどを自動で読み取り、CLAUDE.mdのドラフトを生成してくれる。もちろんそのまま使うのではなく、生成されたドラフトを自分でカスタマイズするのが大事。

自分の場合、/initで生成された内容に加えて、前述の権限レベルやスキル定義への参照を手動で追記している。

3. bashツールと組み合わせた自動化

Claude Codeの真価はbashコマンドを実行できることにある。単なるコード生成AIとの決定的な違いはここ。

例えば「ログファイルからエラーを抽出して、原因を分析して、修正パッチを当てる」を一連の流れでやれる:

claude "production.logの直近100行からERRORを含む行を抽出して、
エラーの原因を分析して、修正が必要なファイルがあれば直して"

Claude Codeは内部的に tail -100 production.log | grep ERROR のようなコマンドを実行し、その結果を見て原因を推測し、該当ファイルを読んで修正まで行う。

ワンライナーで使う -p フラグも便利:

# パイプで標準入力を渡す
cat error.log | claude -p "このエラーログを分析して原因と対策を教えて"

# ファイル一覧を渡してリファクタリング
find src -name "*.ts" | claude -p "これらのファイルで非推奨APIを使っている箇所を探して"

-p（print）フラグを付けると、対話モードではなくワンショットで実行される。シェルスクリプトに組み込むならこれ一択。

4. git操作をClaude Codeに任せる

Git操作は地味に面倒だ。特にコミットメッセージを考えるのが億劫になりがち。Claude Codeに任せると捗る。

claude "現在のgit diffを見て、適切なコミットメッセージを付けてコミットして。
Conventional Commitsの形式で。日本語で。"

するとClaude Codeが git diff を実行し、変更内容を理解した上で git commit -m "feat: ユーザー認証にOAuth2.0を追加" のようなコミットを作ってくれる。

ブランチ戦略を含めた一連のフローもいける:

claude "feature/add-search ブランチを作って、
src/components/Search.tsx にインクリメンタルサーチを実装して、
テストも書いて、コミットして"

ただし、force pushやrebase系の操作は明示的に許可しない限りClaude Codeはやらない（デフォルトの安全設計）。CLAUDE.mdに「force pushは禁止」と書いておけばさらに安心。

5. テスト駆動開発との相性

Claude Codeとの開発で最も生産性が上がるパターンがTDD（テスト駆動開発）。理由は単純で、「テストが通ること」という明確なゴールがあると、AIの出力精度が段違いに上がる。

claude "以下のテストが通る実装を書いて:
- ユーザー名は3文字以上20文字以下
- メールアドレスの形式バリデーション
- パスワードは大文字・小文字・数字を含む8文字以上
テストファイルは tests/validation.test.ts にある"

Claude Codeはテストファイルを読み、実装を書き、npm testを実行し、失敗したら修正を繰り返す。テスト→実装→テスト実行→修正のループを自動で回してくれる。

さらに賢い使い方として、先にテストを書かせてからレビューする:

claude "validateEmail関数のエッジケースを含むテストを網羅的に書いて。
正常系5パターン、異常系10パターン以上。
実装はまだ書かなくていい。テストだけ。"

テストのレビューは実装のレビューより楽だし、テストの網羅性が上がれば実装の品質も自然と上がる。

6. 大規模リファクタリングの進め方

100ファイル超のリファクタリングでも、Claude Codeなら安全に進められる。コツは段階的に進めること。

# ステップ1: 影響範囲の調査
claude "プロジェクト全体でlegacy APIのUserService.getUser()を
使っている箇所を全部洗い出して。ファイルパスと行番号のリストを作って"

# ステップ2: 移行計画の作成
claude "UserService.getUser()をUserRepository.findById()に
置き換える移行計画を作って。依存関係を考慮した実行順序で"

# ステップ3: 段階的に実行
claude "まずsrc/services/配下のファイルだけ、
UserService.getUser()をUserRepository.findById()に置き換えて。
テストも更新して、全テストが通ることを確認して"

一気に全部やらせるのではなく、ディレクトリ単位で区切るのがポイント。1回の変更が大きすぎると、Claude Codeのコンテキストウィンドウを圧迫して精度が落ちる。

また、リファクタリング前にセーフティネットを張るのも大事:

claude "リファクタリング前にgit stashで現在の変更を退避して、
新しいブランチ refactor/user-repository を作って"

7. マルチファイル編集のコツ

Claude Codeは複数ファイルの同時編集が得意だが、指示の出し方にコツがある。

悪い例:

「認証機能を追加して」

良い例:

「JWT認証を追加して。以下のファイルを作成・修正:
1. src/middleware/auth.ts — JWTの検証ミドルウェア
2. src/routes/login.ts — ログインエンドポイント
3. src/types/auth.ts — 型定義
4. tests/auth.test.ts — テスト
既存の src/routes/index.ts にミドルウェアを適用して」

ファイル名と役割を明示すると、Claude Codeは各ファイルの責務を正確に理解して、一貫性のあるコードを生成する。

もう一つ重要なのが、編集対象のファイルが多すぎる場合は分割すること。体感として1回のリクエストで5〜8ファイルくらいが精度の上限。10ファイル超えると、後半のファイルで前半との整合性が怪しくなることがある。

8. エラーデバッグの委任パターン

デバッグはClaude Codeが最も輝く場面の一つ。スタックトレースをそのまま投げるだけで原因特定まで持っていける。

# エラーログをそのまま貼る
claude "このエラーを直して:

TypeError: Cannot read properties of undefined (reading 'map')
    at UserList (src/components/UserList.tsx:23:18)
    at renderWithHooks (node_modules/react-dom/...)
"

Claude Codeはスタックトレースから src/components/UserList.tsx の23行目を読みに行き、原因を特定し、修正まで行う。

より高度なデバッグパターンとして、再現手順を含める:

claude "以下の手順でエラーが発生する:
1. npm run dev でサーバー起動
2. /dashboard にアクセス
3. 検索ボックスに日本語を入力
4. エンコーディングエラーが出る

原因を特定して修正して。修正後、同じ手順で問題が起きないことを確認して"

Claude Codeは実際にサーバーを起動し、curlやfetchでリクエストを送り、再現確認まで行える。「確認して」と一言添えるのがポイント。これがないと修正だけして検証をスキップすることがある。

9. コードレビューを依頼する

プルリクエストのレビューをClaude Codeに依頼するのも有効。特に一人開発やチームの人数が少ない場合、セカンドオピニオンとして使える。

claude "git diff main...feature/new-api を見て、以下の観点でレビューして:
1. セキュリティ上の懸念
2. パフォーマンスのボトルネック
3. エラーハンドリングの漏れ
4. テストカバレッジの不足
指摘は重要度(高/中/低)付きで"

Claude Codeは差分を取得し、各ファイルを分析し、構造化された指摘を返してくれる。

レビュー指摘をそのまま修正させることもできる:

claude "先ほどのレビューで「高」と指摘された項目を全部修正して"

ただし、ビジネスロジックの正しさや設計判断は人間がやるべき領域。Claude Codeが得意なのは「この変数、nullチェックしてないですよね」「このN+1クエリ、パフォーマンス大丈夫ですか」みたいな機械的に検出可能な指摘。

10. ドキュメント自動生成

コードを書いた直後にドキュメントを生成させるのが効率的。後で書こうとすると絶対に書かない。

claude "src/services/ 配下のファイルを全部読んで、
各サービスのAPIリファレンスをJSDoc形式で追記して。
既存のJSDocがある場合は上書きせず、不足分だけ追記"

READMEの自動更新もいける:

claude "package.jsonとsrc/の構成を見て、READMEの
セットアップ手順とディレクトリ構成の説明を最新化して。
既存のREADMEの文体を維持して"

「既存の文体を維持して」が重要。これを書かないと、Claude Code独特の丁寧語で上書きされてしまう。

11. CI/CDパイプラインとの連携

Claude Codeはヘッドレスモード（-pフラグ）でCI/CDに組み込める。GitHub Actionsでの実用例:

# .github/workflows/claude-review.yml
name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Claude Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          npm install -g @anthropic-ai/claude-code
          DIFF=$(git diff origin/main...HEAD)
          echo "$DIFF" | claude -p \
            "このPRの差分をレビューして。セキュリティ・パフォーマンス・
            可読性の観点で。問題があればGitHubのPRコメント形式で出力して" \
            > review.md
      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const body = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: body
            });

PRが作られるたびに自動レビューが走る。人間のレビュアーが見る前に、機械的な指摘が済んでいる状態を作れる。

12. セキュリティチェック

セキュリティの脆弱性チェックもClaude Codeの得意分野。特に「コードを書いた本人が見落としやすい問題」を見つけるのに向いている。

claude "プロジェクト全体をセキュリティ観点でスキャンして。
チェック項目:
- ハードコードされたAPIキー・パスワード
- SQLインジェクションの可能性
- XSSの可能性
- 依存パッケージの既知の脆弱性(npm audit結果を含む)
- 環境変数の適切な管理
結果をCSV形式で出力して"

npm audit との組み合わせも強力:

claude "npm auditを実行して、criticalとhighの脆弱性があれば
影響範囲を調査して、安全にアップデートできるか判断して。
破壊的変更がある場合はその影響も教えて"

人間が npm audit の出力を読んで「このパッケージを上げて大丈夫か？」を判断するのは結構大変。Claude Codeなら依存関係のツリーを辿って影響範囲を即座に分析してくれる。

13. パフォーマンス最適化の相談

パフォーマンス改善は「どこがボトルネックか」の特定が8割。Claude Codeに計測から改善提案までやらせる。

claude "src/pages/dashboard.tsx のレンダリングが遅い。
以下をやって:
1. コンポーネントツリーを分析して、不要な再レンダリングを特定
2. React.memoやuseMemoを適切に適用
3. バンドルサイズに影響する重いimportを特定
4. 改善前後でLighthouseスコアの変化を予測して"

データベースクエリの最適化も得意:

claude "src/repositories/ のクエリを全部分析して。
N+1問題やインデックスが効いていないクエリがあれば指摘して。
Prismaのincludeで解決できるものは修正案も出して"

体感として、Claude Codeはフロントエンドのバンドルサイズ最適化とSQLクエリのN+1問題の検出精度がかなり高い。

14. APIクライアント生成

OpenAPI（Swagger）仕様書からAPIクライアントを生成させる。既存のコード生成ツール（openapi-generator等）より柔軟にカスタマイズできるのが強み。

claude "openapi.yaml を読んで、TypeScriptのAPIクライアントを生成して。
要件:
- fetch APIベース（axiosは使わない）
- レスポンスの型定義を自動生成
- エラーハンドリングはResult型パターン
- リトライロジックを組み込み（3回、exponential backoff）
- 出力先は src/api/generated/"

既存のコード生成ツールだと「リトライロジックを入れたい」「エラーハンドリングのパターンを変えたい」といったカスタマイズに別途テンプレート修正が必要。Claude Codeなら自然言語で要件を伝えるだけ。

既存APIの型定義の自動推論も実用的:

claude "src/api/legacy-client.js を読んで、
各エンドポイントのリクエスト・レスポンスの型を推論して、
TypeScriptの型定義ファイルを生成して"

型のないレガシーコードからの移行で特に重宝する。

15. Claude Codeの限界と回避策

最後に、Claude Codeの限界も正直に書いておく。万能ではない。

限界1: コンテキストウィンドウ

長いセッションを続けると、初期の文脈を忘れる。対策はこまめにコンパクションすること。Claude Codeは自動的にコンテキストを圧縮するが、重要な情報はCLAUDE.mdに書いておけば毎回読み込まれる。

# セッションが長くなったら新しいセッションで再開
claude --resume   # 前のセッションを要約して引き継ぐ

限界2: 大きなバイナリやメディアファイル

画像生成・動画編集・バイナリ解析は不得手。Claude Code単体では処理できないので、外部ツール（FFmpeg、ImageMagick等）をbash経由で呼び出す形になる。

限界3: リアルタイムの外部情報

学習データのカットオフ以降の情報は持っていない。最新のライブラリバージョンや最近のバグ情報は、WebFetchやMCPで外部検索を併用する必要がある。

# MCPでWeb検索を接続する設定例
# .mcp.json
{
  "mcpServers": {
    "web-search": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-web-search"]
    }
  }
}

限界4: 秘匿情報の扱い

APIキーやパスワードをClaude Codeのコンテキストに渡すのは避けるべき。環境変数経由で参照させ、CLAUDE.mdには「.envの中身をログに出さない」と明記しておく。

限界5: 100%の正確性は保証されない

当たり前だが、AIが生成したコードには必ずレビューが必要。特にセキュリティ関連のコード、金銭処理、認証周りは人間が責任を持って確認すべき。テストを書かせて通ることを確認するのが最低限のセーフティネット。

---

まとめ

15個のテクニックを紹介したが、全部を一度に使い始める必要はない。個人的なおすすめの導入順は:

1. CLAUDE.md を書く（これだけで体験が変わる）
2. git操作の委任 から始める（低リスクで効果を実感しやすい）
3. TDD連携 で品質を担保しながらスピードを出す
4. CI/CDへの組み込み でチーム全体に恩恵を広げる

Claude Codeは「AIにコードを書かせるツール」というより、「開発の全工程を一緒にやってくれるペアプロ相手」に近い。指示の出し方次第で、ジュニアエンジニアにもシニアエンジニアにもなる。

その指示の出し方こそが、CLAUDE.mdの設計であり、この記事で紹介した15個のテクニックだ。

使いこなせば、間違いなく開発の景色が変わる。