- Codex CLIでReact/Next.jsコンポーネントをデザイン仕様から自動生成
- レスポンシブCSS・Tailwind設計・アクセシビリティ対応も一括で自動化
- SES現場で即戦力になるフロントエンド開発ワークフローを構築できる
「このFigmaデザインをReactコンポーネントに落としてください。レスポンシブ対応もお願いします。あ、WCAG準拠も忘れずに。」
SES現場でフロントエンド開発を任されると、コンポーネント設計、スタイリング、アクセシビリティ対応、テストと、やるべきことが一気に広がります。特にReactやNext.jsのプロジェクトでは、ボイラープレートコードの量が多く、1つのUIパーツを作るだけでも複数ファイルの作成が必要です。
本記事では、OpenAI Codex CLI を使ってフロントエンド開発の大部分を自動化する方法を解説します。コンポーネント生成からCSS設計、アクセシビリティ対応、Storybook連携まで、SES現場で即実践できるワークフローを紹介します。

なぜフロントエンド開発にCodex CLIが効くのか
フロントエンド開発はパターンの繰り返しが多い領域です。フォーム、テーブル、モーダル、カード——UIコンポーネントには確立されたベストプラクティスがあり、LLMが最も力を発揮できる分野の一つです。
フロントエンド開発における3つの課題
| 課題 | 従来の対処法 | Codex CLI活用後 |
|---|---|---|
| コンポーネントのボイラープレート | 手動でファイル作成+コピペ | 自然言語指示で一括生成 |
| レスポンシブ対応の抜け漏れ | デバイスごとに手動テスト | ブレークポイント込みで自動生成 |
| アクセシビリティ対応 | 後から手動で修正 | 生成時にWCAG準拠を組み込み |
Codex CLIのサンドボックス環境なら、生成されたコードを安全にプレビュー・検証してから本番コードに取り込めます。SES現場のセキュリティ要件にも対応しやすい点が大きなメリットです。
Reactコンポーネントの自動生成
基本的なコンポーネント生成
Codex CLIで最もよく使うのが、UIコンポーネントの自動生成です。自然言語でデザイン仕様を伝えるだけで、TypeScript + React のコンポーネントが生成されます。
codex "以下の仕様でReactコンポーネントを作成してください:
- ユーザープロフィールカード
- アバター画像、名前、役職、メールアドレスを表示
- TypeScript + React.FC で型定義
- Tailwind CSSでスタイリング
- src/components/UserProfileCard.tsx に出力"
生成されるコードの例:
// src/components/UserProfileCard.tsx
import React from 'react';
interface UserProfileCardProps {
avatarUrl: string;
name: string;
role: string;
email: string;
}
export const UserProfileCard: React.FC<UserProfileCardProps> = ({
avatarUrl,
name,
role,
email,
}) => {
return (
<div className="flex items-center gap-4 rounded-xl border border-gray-200 bg-white p-6 shadow-sm">
<img
src={avatarUrl}
alt={`${name}のプロフィール画像`}
className="h-16 w-16 rounded-full object-cover"
/>
<div>
<h3 className="text-lg font-bold text-gray-900">{name}</h3>
<p className="text-sm text-gray-500">{role}</p>
<a
href={`mailto:${email}`}
className="text-sm text-blue-600 hover:underline"
>
{email}
</a>
</div>
</div>
);
};
複数コンポーネントの一括生成
SES現場では、画面単位でまとめてコンポーネントを作成することが多いです。Codex CLIなら、画面構成を伝えるだけで関連コンポーネントを一括生成できます。
codex "ダッシュボード画面に必要なコンポーネントを一括生成してください:
1. StatCard - KPI表示カード(アイコン、数値、ラベル、前月比)
2. RecentActivityList - 最近のアクティビティ一覧
3. NotificationBell - 通知ベルアイコン(未読バッジ付き)
4. DashboardLayout - 上記を配置するレイアウト
各コンポーネントはsrc/components/dashboard/に出力。
TypeScript、Tailwind CSS、React.FC形式で。"
ポイントは、ディレクトリ構造も含めて指示することです。Codex CLIはファイル作成まで自動で行うため、コンポーネントの分割方針を事前に決めておくと効率的です。
Next.js App Routerとの連携
ページコンポーネントの生成
Next.js 14以降のApp Routerに対応したページ生成も、Codex CLIの得意領域です。
codex "Next.js App Routerで以下のページを作成:
- /dashboard/settings のページコンポーネント
- Server Component として実装
- メタデータ(title, description)を設定
- ローディングUI(loading.tsx)も同時に生成
- エラーバウンダリ(error.tsx)も作成"
Server ComponentとClient Componentの使い分け
Codex CLIに「このコンポーネントはServer/Clientどちらが適切か判断して」と指示すると、インタラクティブ要素の有無やデータフェッチの必要性に基づいて適切に分離してくれます。
codex "src/components/ProductList.tsx を確認して、
Server ComponentとClient Componentに適切に分離してください。
'use client' ディレクティブの配置も最適化して。"
これはSES現場でNext.jsの既存プロジェクトにアサインされた際に特に役立ちます。既存コードを解析して最適なレンダリング戦略を提案してもらえるためです。
CSS設計とTailwindの効率化
レスポンシブデザインの自動実装
レスポンシブ対応は手作業だと抜け漏れが発生しやすい領域です。Codex CLIにブレークポイントごとの挙動を指示すると、漏れなく実装できます。
codex "src/components/PricingTable.tsx のレスポンシブ対応:
- モバイル(<640px): カード縦並び、1列
- タブレット(640-1024px): 2列グリッド
- デスクトップ(>1024px): 3列グリッド、ホバーエフェクト追加
Tailwind CSSのレスポンシブプレフィックスを使用"
Tailwind CSSの最適化
既存プロジェクトでTailwindのクラスが冗長になっている場合、Codex CLIで最適化できます。
codex "src/components/ 配下のTailwindクラスを最適化:
1. 重複クラスの削除
2. @apply で共通スタイルを抽出
3. tailwind.config.js のtheme.extendに
プロジェクト固有の値を追加
4. 変更のサマリーを出力"
CSS-in-JSからTailwindへの移行
SES現場では、styled-componentsやEmotionからTailwindへの移行案件も増えています。Codex CLIなら機械的な変換を自動化できます。
codex "src/components/Header.tsx の styled-components を
Tailwind CSSに変換してください。
レスポンシブ対応とダークモード対応は維持して。"
アクセシビリティ(a11y)の自動対応
WCAG準拠チェックと修正
アクセシビリティ対応は後回しにされがちですが、Codex CLIならコンポーネント生成時にWCAG準拠を組み込むことができます。
codex "src/components/ 配下の全コンポーネントを
WCAG 2.1 AA基準でチェックして修正:
1. aria-label / aria-describedby の追加
2. フォーカス管理(tabIndex、フォーカストラップ)
3. カラーコントラスト比の確認
4. スクリーンリーダー対応
5. キーボードナビゲーション対応
修正一覧をリストで出力"
フォームのアクセシビリティ改善
フォームは特にアクセシビリティの問題が発生しやすい領域です。
codex "src/components/ContactForm.tsx のa11y改善:
- 全input要素にlabelを関連付け
- エラーメッセージをaria-liveで通知
- 必須フィールドにaria-required
- バリデーションエラー時のフォーカス移動
- 送信ボタンの状態管理(aria-disabled)"
SES現場では、既存プロジェクトのa11y対応を任されるケースが増えています。Codex CLIで既存コードを解析し、改善点を自動で洗い出せるのは大きな武器になります。
Storybook連携でコンポーネントカタログを自動構築
Storiesの自動生成
コンポーネントを作成したら、Storybookのストーリーも同時に生成しましょう。
codex "src/components/UserProfileCard.tsx の
Storybook ストーリーを生成:
- Component Story Format 3.0(CSF3)
- Default / WithLongName / WithoutAvatar のバリエーション
- args でプロパティをコントロール可能に
- src/stories/UserProfileCard.stories.tsx に出力"
デザインシステムの構築
複数のコンポーネントをまとめてデザインシステム化する際も、Codex CLIが活躍します。
codex "以下のデザイントークンでデザインシステムを構築:
- カラー: Primary(#4285f4), Secondary(#10b981), Danger(#ef4444)
- タイポグラフィ: Heading(Noto Sans JP 700), Body(同 400)
- スペーシング: 4px単位のスケール
基本コンポーネントを生成:
Button, Input, Select, Checkbox, Badge, Avatar
各コンポーネントにStoryも同時に作成"
SES現場でのフロントエンド開発ワークフロー
プロジェクト参画初日の効率化
SES現場にアサインされた初日、大量のコンポーネントを把握するのは大変です。Codex CLIで既存コードの解析から始めましょう。
# プロジェクト構造の把握
codex "src/components/ のディレクトリ構造を解析して、
コンポーネントの依存関係をツリー形式で出力してください。
各コンポーネントのpropsの型定義もまとめて。"
# 既存の設計パターンの把握
codex "このプロジェクトで使われている
状態管理パターンとデータフェッチパターンを分析して、
新しいコンポーネントを作る際のテンプレートを提案して。"
コードレビューでの活用
フロントエンドのPRレビューでもCodex CLIは強力です。
codex "このPRの差分をレビュー:
1. Reactのベストプラクティスに沿っているか
2. パフォーマンス問題(不要な再レンダリング等)
3. アクセシビリティの考慮
4. Tailwindクラスの最適化余地
改善提案をコメント形式で出力"
既存UIのリファクタリング
レガシーなclass componentをfunction componentに変換する作業も、Codex CLIに任せられます。
codex "src/components/legacy/ 配下のclass componentを
全てfunction component + hooksに変換:
- setState → useState
- componentDidMount → useEffect
- shouldComponentUpdate → React.memo
- 型定義をTypeScriptに追加
変換前後の対応表も出力"
パフォーマンス最適化の自動化
レンダリング最適化
codex "src/components/ のレンダリングパフォーマンスを最適化:
1. React.memo が必要なコンポーネントを特定
2. useMemo / useCallback の適切な配置
3. 不要な再レンダリングの原因を特定
4. React DevTools のProfilerで確認すべきポイントをリスト化"
バンドルサイズの削減
codex "package.json の依存関係を分析して:
1. バンドルサイズが大きいライブラリを特定
2. 軽量な代替ライブラリを提案
3. dynamic import でコード分割すべき箇所を特定
4. Tree-shakingが効いていないインポートを修正"
実践的なプロンプトテクニック
フロントエンド開発でCodex CLIの精度を上げるポイントをまとめます。
AGENTS.md にフロントエンドルールを追加
プロジェクトのルートに AGENTS.md(または codex.md)を配置して、フロントエンド固有のルールを記述します。
## フロントエンド規約
- React 18 + TypeScript 5.x
- Tailwind CSS v3(CSS-in-JS禁止)
- コンポーネントはfunction component + React.FC
- 状態管理: Zustand(Redux禁止)
- データフェッチ: TanStack Query v5
- テスト: Vitest + React Testing Library
- 全コンポーネントにStorybook story必須
- WCAG 2.1 AA準拠必須
効果的なプロンプトの構造
codex "[何を] ユーザー一覧テーブルコンポーネントを作成
[どのように] TypeScript + Tailwind CSS + React.FC
[制約] ソート・フィルタ・ページネーション対応
[出力先] src/components/users/UserTable.tsx
[追加] Storybook storyとユニットテストも同時に生成"
まとめ:Codex CLIでフロントエンド開発を次のレベルへ
Codex CLIを使えば、フロントエンド開発の反復的な作業を大幅に効率化できます。
| 活用シーン | 効率化の目安 |
|---|---|
| コンポーネント生成 | 手動比 70%短縮 |
| レスポンシブ対応 | 抜け漏れゼロ |
| a11y対応 | WCAG準拠を自動組み込み |
| Storybook連携 | ストーリー自動生成 |
| レガシーコード変換 | class → function 自動化 |
SES現場では、短期間でプロジェクトの技術スタックに適応する力が求められます。Codex CLIを活用すれば、React/Next.jsの既存プロジェクトへの参画初日から生産性を発揮できます。
関連記事
シリーズの他のエピソードも合わせてチェックしてみてください。
- Ep.1 Codex CLI使い方入門
- Ep.2 実践テクニック集
- Ep.3 プロンプトエンジニアリングとSkill開発
- Ep.7 ドキュメント自動生成
- Ep.9 データベース設計・マイグレーション自動化