【実践】AIエージェントでのコーディング指南書 - 4ヶ月の開発から学ぶプロンプト術

Wed, 07 Jan 2026 10:00:00 +0900

はじめに

「AIエージェントを使ってみたけど、うまく動かない」「何を指示すればいいかわからない」——そんな声をよく聞きます。

この記事は、約4ヶ月間AIエージェント（Claude Code、Codex CLIなど）を使って開発してきた経験から見つけた、効果的なパターンをまとめた指南書です。これまで各自が試行錯誤しながら使ってきましたが、知見が整理されないまま属人化していました。開発チームに新メンバーが加わったこのタイミングで、改めてノウハウを整理・共有することにしました。

1. 効果的なプロンプトの書き方

1.1 「@ファイルパス」でコンテキストを明示する

AIエージェントは賢いですが、読心術は使えません。どのファイルの話をしているのか、明示的に教えてあげましょう。

1
2
3
4
5
6
7


❌ 悪い例：
「このエラーを直して」

✅ 良い例：
「@src/components/user-profile/sections/department-info.tsx
について、部署名がIDのまま表示されてしまっています。
原因を調査して修正してください。」

Anthropic のベストプラクティスでも、「giving clear directions upfront reduces the need for course corrections later」（最初に明確な指示を与えることで、後から軌道修正する必要が減る）と述べられています¹。

@記法のポイント：

ポイント	良い例	悪い例
フルパスで指定	`@src/components/.../file.tsx`	`file.tsx を見て`（どこにあるか不明）
複数ファイル比較時	両方のパスを明示	「もう一つのファイルと比較して」

1.2 問題の背景・文脈を詳細に説明する

実際の開発で効果的だったプロンプトパターンを見てみましょう。

1
2
3
4
5
6
7


元請けベンダーから以下の質問が来ています。
コードベースやSalesforceの現在のライセンス構成での
ガバナ制限など、Context7やネット調査も含めて調査してください。

---

[質問内容をそのまま貼り付け]

このプロンプトには以下の要素が含まれています。

頭脳 vs 手足：Claude Code（Opus 4.5）とCodex CLI（GPT-5.2）徹底比較

Tue, 06 Jan 2026 12:00:00 +0900

はじめに

2025年末から2026年にかけて、AIコーディングツールは新たなステージに突入しました。AnthropicのClaude Code（Opus 4.5）とOpenAIのCodex CLI（GPT-5.2）は、どちらも「AIエージェントが自律的にコードを書く」時代を切り開いています。

しかし、この2つのツールは設計思想が根本的に異なります。本記事では、**「頭脳 vs 手足」**という独自の視点からこの2大ツールを比較し、それぞれの強みと使い分けのポイントを解説します。

1. 両ツールの概要

まずは、それぞれのツールの基本的な特徴を押さえておきましょう。

1.1 Claude Code + Opus 4.5

Claude Codeは、Anthropicが提供するAIコーディングエージェントです。2025年11月にリリースされたOpus 4.5モデルと組み合わせることで、「世界最高のAIコーディングツール」を謳っています¹。

主な特徴は以下の通りです。

ローカルファースト設計: ターミナルやIDEに直接統合され、開発者のワークフローに溶け込む
インタラクティブな操作: 開発者が「コントロールを握り続ける」設計思想
チェックポイント機能: 作業の進捗を保存し、いつでも以前の状態にロールバック可能
ハイブリッド推論: 即座の応答と拡張思考を状況に応じて切り替え

1.2 Codex CLI + GPT-5.2

Codex CLIは、OpenAIが提供するオープンソースのAIコーディングエージェントです。GPT-5.2-Codexは、複雑なソフトウェアエンジニアリングタスクに最適化された専用モデルで、2025年12月にリリースされました²。

主な特徴は以下の通りです。

クラウドベース設計: タスクは隔離されたサンドボックス環境で非同期に処理
委任型ワークフロー: タスクを渡して「任せる」スタイル
長時間自律作業: テスト中に7時間以上連続して複雑なタスクに取り組んだ実績
サイバーセキュリティ強化: CTFチャレンジでの高精度を実証

2. 「頭脳 vs 手足」の比較軸

ここで本記事の核心となる比較軸を紹介します。

観点	GPT-5.2 Codex（頭脳型）	Claude Code + Opus 4.5（手足型）
設計思想	「深く考える」ことに最適化	「精密に実行する」ことに最適化
強み	巨大なコンテキスト、長時間思考	ローカル統合、ツール操作の精度
操作感	「従業員に任せる」感覚	「道具を使いこなす」感覚

2.1 GPT-5.2 Codex：「賢い頭脳」

GPT-5.2 Codexは、まさに**「頭脳派」**のAIエージェントです。

Claude Code on Feature Branch Tech Blog

【実践】AIエージェントでのコーディング指南書 - 4ヶ月の開発から学ぶプロンプト術

はじめに

1. 効果的なプロンプトの書き方

1.1 「@ファイルパス」でコンテキストを明示する

1.2 問題の背景・文脈を詳細に説明する

頭脳 vs 手足：Claude Code（Opus 4.5）とCodex CLI（GPT-5.2）徹底比較

はじめに

1. 両ツールの概要

1.1 Claude Code + Opus 4.5

1.2 Codex CLI + GPT-5.2

2. 「頭脳 vs 手足」の比較軸

2.1 GPT-5.2 Codex：「賢い頭脳」