メインコンテンツへスキップ
見出し画像

Claude CodeでReact Native開発で失敗しない5つの鉄則

    「Claude CodeでReact Nativeアプリを作りたいけど、AIが生成するコードって信用していいの?」

    AI支援開発を始めると、こんな疑問が浮かんでくるのではないでしょうか。私も最初は「AIが書いてくれるなら楽じゃん」と思っていました。でも、実際に使い込んでいくと、AIが生成したコードをそのまま使うと痛い目を見るということがわかってきたんです。

    この記事では、モバイルアプリ開発に7年以上携わってきた私が、Claude CodeでReact Native開発をする際に「これだけは守っている」という5つの鉄則を紹介します。

    前回の記事「React Native vs Flutter 完全比較」では技術選定について解説しました。今回は、React Nativeを選んだ方向けの実践編です。

    AI支援開発の現実を知っておこう

    Claude CodeやCursor、GitHub Copilotを使った開発は確かに生産性を向上させます。私も日々の開発で恩恵を受けています。

    でも、知っておくべき事実があります。

    40〜62%のAI生成コードにセキュリティ上の欠陥が含まれているという研究結果が報告されているんです。さらに、4人に1人の開発者が「5回に1回は機能的なエラーを含む提案を受ける」と回答しています。

    React Native 0.76以降ではNew Architectureがデフォルト有効になりましたが、AIツールの学習データは2024年以前のコードが中心です。そのため、旧アーキテクチャのパターンを生成してしまうことが頻繁に起こります。

    こうした課題を踏まえて、私が実践している5つの鉄則を紹介します。

    鉄則1:CLAUDE.mdでプロジェクトコンテキストを明文化する

    AIに正確なコードを生成させるには、プロジェクトの文脈を伝えることが大事です。私がやっているのは、CLAUDE.mdファイルにフレームワークバージョン、アーキテクチャパターン、コーディング規約を書いておくこと。

    これをやるだけで、AIの出力精度が全然違うんです。

    React Native向けの設定例はこんな感じです。

    # Project: MyApp
    
    ## Architecture
    - Framework: Expo SDK 54 / React Native 0.81+
    - Navigation: Expo Router v6 (file-based routing)
    - State: Zustand (client) + TanStack Query (server)
    - Testing: Jest + Detox
    
    ## AI Instructions
    - components/フォルダを確認してから新しいUIを作成
    - フォーム入力にはKeyboardAvoidingScrollViewを使用
    - 既存のナビゲーションパターンを参照(app/ディレクトリ)
    - 依存パッケージのバージョンを必ず確認
    - New Architecture(TurboModules/Fabric)を前提としたコード生成
    - 旧ブリッジパターン(JSON直列化ベース)は使用禁止

    書いておくと便利な項目

    • フレームワークとSDKのバージョン

    • ナビゲーションライブラリ(Expo Router or React Navigation)

    • 状態管理ライブラリ

    • テストフレームワーク

    • New Architecture対応の明示的な指示

    Expo MCP Serverの導入

    Expo MCP Serverは、Expoが提供するリモートMCPサーバーです。Claude Codeと直接統合されて、最新のExpoドキュメントをオンデマンドで取得できます。

    導入方法はシンプルで、Claude Codeで以下のコマンドを実行するだけです。

    # Claude Codeでの認証
    /mcp

    認証時にExpoアカウントのアクセストークンが必要です。EASダッシュボードの「Credentials > Access tokens > Personal access tokens」から作成できます。

    これを設定しておくと、互換性のある依存関係バージョンの管理や、iOS Simulatorからスクリーンショットを取得してAIに渡すことも可能になります。正直、これは便利すぎて手放せなくなりました。

    鉄則2:Skills/SubAgentで専門領域を分業させる

    Claude CodeにはSkillsやSubAgentという機能があります。これを活用して、UI実装、バックエンド連携、コードレビューを専門のエージェントに任せることで、品質が向上します。

    Callstack agent-skillsの導入

    React Nativeの開発元であるCallstackが公開している「agent-skills」リポジトリは、Claude Code/Cursorに最適化されたベストプラクティス集です。

    GitHub: github.com/callstackincubator/agent-skills

    「The Ultimate Guide to React Native Optimization」の知見をエージェント向けにパッケージ化したもので、以下のスキルが含まれています。

    • JSプロファイリング

    • メモ化パターン

    • ネイティブモジュール実装

    • バンドル最適化

    Claude Codeでの導入は、プラグインマーケットプレイスから行えます。

    /plugin marketplace add callstackincubator/agent-skills
    /plugin install react-native-best-practices@callstack-agent-skills

    SubAgentの役割分担パターン

    大規模な機能を実装する際は、以下のような分業が効果的です。

    • UIエージェント - コンポーネント設計とスタイリング

    • Backendエージェント - API連携とデータフェッチ

    • Reviewerエージェント - コードレビューとセキュリティチェック

    鉄則3:Linter + TypeScript strict + デッドコード検出で品質を自動担保する

    AI生成コードの品質を担保するには、自動チェックの仕組みがあると安心です。正直、人間がすべてをレビューするのは無理なんですよね。

    ESLint + react-native pluginの推奨設定

    // .eslintrc.js
    module.exports = {
      extends: [
        '@react-native',
        'plugin:@typescript-eslint/recommended',
        'plugin:@typescript-eslint/recommended-requiring-type-checking',
      ],
      rules: {
        '@typescript-eslint/no-explicit-any': 'error',
        '@typescript-eslint/strict-boolean-expressions': 'error',
        'react-native/no-inline-styles': 'error',
      },
    };

    tsconfig.jsonのstrict mode完全有効化

    {
      "compilerOptions": {
        "strict": true,
        "noImplicitAny": true,
        "strictNullChecks": true,
        "noUncheckedIndexedAccess": true,
        "exactOptionalPropertyTypes": true
      }
    }

    `strict: true`だけでなく、`noUncheckedIndexedAccess`と`exactOptionalPropertyTypes`も有効にすると、AI生成コードの型安全性がかなり向上します。これで何度救われたことか…。

    Expo Atlasでバンドル分析・デッドコード検出

    AI生成コードでよくある問題が「バンドルサイズの肥大化」です。AIはライブラリ全体をインポートするコードを生成しがちで、Font Awesomeの例では6.39MBから70%削減できたというケースもあります。

    Expo SDK 51以降ではExpo Atlasでバンドル分析ができます。

    npx expo export --experimental-bundle-analyzer

    tree-shakableなインポートに修正することで、アプリサイズを大幅に削減できます。

    鉄則4:CI/CDでAI生成コードの検証を自動化する

    AIが生成したコードをそのままマージするのは危険です。CI/CDパイプラインでの自動検証を組み込んでおくと安心です。

    Swift/KotlinでのiOS/Android開発経験がある方なら、Xcode CloudやBitriseを使ったことがあるかもしれません。React Native + Expoの場合は、GitHub ActionsとEAS Buildの組み合わせがおすすめです。

    GitHub Actions + EAS Build設定例

    # .github/workflows/eas-build.yml
    name: EAS Build
    on:
      pull_request:
        branches: [main]
    
    jobs:
      # Step 1: まずコード品質をチェック
      lint-and-test:
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v5
          
          # Node.js環境のセットアップ
          - uses: actions/setup-node@v6
            with:
              node-version: 22
              cache: npm
          
          # 依存関係のインストール(package-lock.jsonを厳密に使用)
          - run: npm ci
          
          # ESLintでコード品質チェック
          - run: npm run lint
          
          # TypeScriptの型チェック
          - run: npm run typecheck
          
          # ユニットテスト実行
          - run: npm test
          
          # セキュリティ監査(脆弱性のある依存関係を検出)
          - run: npm audit --audit-level=high
    
      # Step 2: 品質チェックが通ったらビルド
      build:
        needs: lint-and-test  # lint-and-testが成功した場合のみ実行
        runs-on: ubuntu-latest
        steps:
          - uses: actions/checkout@v5
          - uses: actions/setup-node@v6
            with:
              node-version: 22
              cache: npm
          
          # Expo GitHub Actionでeas-cliをセットアップ
          - uses: expo/expo-github-action@v8
            with:
              eas-version: latest
              token: ${{ secrets.EXPO_TOKEN }}  # Expoのアクセストークン
          
          - run: npm ci
          
          # EAS Buildを実行(--no-waitで非同期実行)
          - run: eas build --platform all --non-interactive --no-wait

    ポイントは、`lint-and-test`ジョブで品質チェックを先に行い、それが通った場合のみ`build`ジョブが実行される点です。AIが変なコードを生成しても、ここで弾かれるので安心です。

    Pre-commitフックの設定(Husky)

    コミット前にもチェックを入れておくと、CIで失敗する前に問題を検出できます。

    npx husky-init && npm install
    npx husky add .husky/pre-commit "npm run lint && npm run typecheck"

    npm auditによる依存関係監査

    AI生成コードは存在しないパッケージを参照する「ハルシネーション」を起こすことがあります。また、古いバージョンのパッケージを推奨することもあります。

    `npm audit --audit-level=high`をCIに組み込むことで、脆弱性のある依存関係を検出できます。

    ちなみに、2025年にはReact Native Community CLIにRCE(リモートコード実行)脆弱性(CVE-2025-11953)が発見されました。サプライチェーンセキュリティの重要性を示す事例です。

    鉄則5:AIの出力は必ず検証する(セキュリティとパフォーマンス)

    最後の鉄則は、AIの出力を盲信しないこと。これが一番大事かもしれません。

    セキュリティのチェックポイント

    以下の項目は特に注意して確認してください。私はPRレビュー時に必ずチェックしています。

    • ハードコードされたクレデンシャルがないか

    • 入力バリデーションが実装されているか

    • 認証・認可チェックが適切か

    • 存在しないパッケージを参照していないか(ハルシネーション)

    • 非推奨の暗号ライブラリを使用していないか

    非推奨API・ハルシネーションの検出

    AIは複数の異なるインポートパスを提案することがあります。AsyncStorageを例にとると、こんな問題が起こります。

    // ❌ AI生成コード(RN 0.59以降非推奨)
    import { AsyncStorage } from 'react-native';
    
    // ❌ 古いコミュニティパッケージ(非推奨)
    import AsyncStorage from '@react-native-community/async-storage';
    
    // ✅ 現行の正しいインポート
    import AsyncStorage from '@react-native-async-storage/async-storage';

    これ、実際に私も何度かハマりました。AIが生成したインポート文は確認しておくと安心です。

    パフォーマンスの盲点

    AIが最も頻繁に犯すパフォーマンスアンチパターンは「useMemo/useCallbackの過剰使用」です。

    AIはすべての関数を`useCallback`で、すべての値を`useMemo`でラップしがちですが、これらのフック自体にもオーバーヘッドがあります。developerway.comの分析によれば「90%のuseMemo/useCallbackは削除可能」という結果が出ています。

    メモ化がre-renderを防ぐには、子コンポーネントが`React.memo`でラップされ、かつすべてのpropsが安定している必要があります。片方だけでは効果がないんです。

    FlatList vs FlashListの判断

    100件以上のアイテムリストでは、FlatListからFlashListへの移行を検討してみてください。

    ベンチマーク結果(notjust.dev実測)は印象的です。

    • JSスレッドFPS:9.28 → 41.56(約4.5倍改善)

    • パフォーマンススコア:79.2

    • CPU使用率:198.9% → 36.5%(82%削減)

    • メモリクラッシュも解消

    FlashListを使う際の注意点があります。

    • `key` propを追加してはならない(ビューリサイクルが無効化される)

    • `estimatedItemSize`は必須で、平均アイテム高さを正確に指定

    • 異種アイテムリストでは`getItemType`を使用

    • New Architecture環境ではFlashList 2.0以降を使用すると安定性が向上

    New Architecture対応の確認

    React Native 0.76以降とExpo SDK 52以降ではNew Architectureがデフォルト有効です。約75%のExpo SDK 52+プロジェクトがNew Architectureを採用しています。

    AIが生成したコードが旧ブリッジパターン(JSON直列化ベース)を使っていないか確認してみてください。New ArchitectureではJSI(JavaScript Interface)を使った直接メモリアクセスが標準です。

    TurboModulesのspec定義には`Native`プレフィックス(例:`NativeLocalStorage.ts`)、Fabric Components(UIコンポーネントの新しいレンダリングシステム)には`NativeComponent`サフィックス(例:`WebViewNativeComponent.ts`)が必要です。AIはこれらの命名規則を無視することが多いので注意が必要です。

    New Architectureでは、5,000個の`<Text />`要素のレンダリングが20%高速化されたベンチマーク結果も報告されています。ただし、実際の改善はアプリの設計や実装によって異なるため、自分のアプリで計測することをおすすめします。

    まとめ

    画像
    ClaudeCode × ReactNative 開発5つの鉄則

    Claude CodeでReact Native開発を成功させるための5つの鉄則を振り返ります。

    鉄則1 - CLAUDE.mdでプロジェクトコンテキストを明文化する
    鉄則2 - Skills/SubAgentで専門領域を分業させる
    鉄則3 - Linter + TypeScript strict + デッドコード検出で品質を自動担保する
    鉄則4 - CI/CDでAI生成コードの検証を自動化する
    鉄則5 - AIの出力は必ず検証する(セキュリティとパフォーマンス)

    AI支援開発は生産性を大きく向上させます。でも、40〜62%のコードにセキュリティ欠陥が含まれるという現実を忘れてはいけません。適切な設定と検証プロセスを組み込むことで、AIの恩恵を最大限に受けながら、品質を担保できます。

    私の個人的なおすすめは、まずCLAUDE.mdの設定から始めること。これだけでAIの出力精度がかなり変わります。

    React NativeとFlutterの技術選定で迷っている方は、前回の記事「React Native vs Flutter 完全比較」も参考にしてください。


    出典

    • AI生成コードのセキュリティ欠陥に関する研究データ(arXiv、Veracode、Endor Labs)

    • developerway.com「90%のuseMemo/useCallbackは削除可能」

    • Callstack agent-skills (github.com/callstackincubator/agent-skills)

    • CVE-2025-11953(React Native Community CLI RCE脆弱性、CVSSスコア9.8)

    • React Native 0.76 New Architecture ベンチマーク(React Native Working Group)

    • FlashListベンチマーク(notjust.dev、Whitespectreの分析)

    • Expo MCP Server(docs.expo.dev/eas/ai/mcp/)

     
     
    モバイルアプリ開発のフリーランスエンジニアです!暦7年。 最近はReactNativeやFlutter等のクロスプラットフォームでのアプリ開発にハマっています。 普段はClaudeCodeやCursorを使って開発しています。AI駆動開発のノウハウを発信中!

    あなたへのおすすめ