はじめに
Claude Code（Opus 4.6）とOpenAI Codex CLI（GPT-5.4）をMCPプロトコルで連携させると、単一モデルでは得られない実用的なワークフローが実現できます。
本記事では、claude-code-codex-agentsというMCPサーバーを使って、Claude CodeからGPT-5.4にタスクを委譲し、構造化された実行レポートを受け取る方法をハンズオンで解説します。
アーキテクチャ
Claude Code (Opus 4.6)
| MCP Protocol
v
claude-code-codex-agents (MCPサーバー)
| subprocess + stdin
v
Codex CLI -> OpenAI API (GPT-5.4)
| JSONL event stream
v
構造化レポート -> Claude Code に返却
```
ポイントは**Codex CLIが出力するJSONLイベントストリームを全解析**し、ツール呼び出し・ファイル操作・エラーを構造化レポートに変換する点です。
## 前提条件
| 要件 | バージョン |
|------|-----------|
| Python | 3.12以上 |
| Node.js | 18以上 |
| uv | 最新版推奨 |
| OpenAIアカウント | Codex CLI認証用 |
## Step 1: Codex CLIのインストールと認証
```bash
npm install -g @openai/codex
codex login
```
## Step 2: claude-code-codex-agentsのインストール
```bash
git clone https://github.com/tsunamayo7/claude-code-codex-agents.git
cd claude-code-codex-agents
uv sync
```
## Step 3: MCPクライアントへの登録
`~/.claude/settings.json` に以下を追加:
```json
{
"mcpServers": {
"claude-code-codex-agents": {
"type": "stdio",
"command": "uv",
"args": ["run", "--directory", "/path/to/claude-code-codex-agents", "python", "server.py"],
"env": { "PYTHONUTF8": "1" }
}
}
}
```
## Step 4: 利用可能なツール一覧
| ツール | 用途 | サンドボックス |
|--------|------|---------------|
| execute | タスクをCodexに委譲し構造化レポートを取得 | workspace-write |
| trace_execute | execute+全イベントタイムライン付き | workspace-write |
| parallel_execute | 最大6タスクを同時並列実行 | read-only |
| review | GPT-5.4によるコードレビュー | read-only |
| explain | コード解説（brief/medium/detailed） | read-only |
| generate | コード生成 | workspace-write |
| discuss | GPT-5.4の見解を取得 | read-only |
| session_continue | 前回スレッドを引き継いで継続 | workspace-write |
| session_list | セッション履歴の一覧表示 | - |
| status | Codex CLIの状態と認証確認 | - |
## Step 5: 実際に使ってみる
### 基本的なタスク委譲（execute）
```
[Codex gpt-5.4] Completed
Execution time: 8.3s
Thread: 019d436e-4c39-7093-b7ed-f8a26aca7938
Tools used (3):
read_file -- src/auth.py
edit_file -- src/auth.py
shell -- python -m pytest tests```
Files touched (1):
src/auth.py
```
### Adversarial Review（review）
```
[Codex Review] GPT-5.4 Review Result
Execution time: 15.7s
- [CRITICAL] os.system(cmd) -- command injection
- - [WARNING] ZeroDivisionError when b == 0
- - [INFO] No type hints on function signatures
- ```
異なるモデルが異なる視点でレビューするため、**単一モデルの盲点を補完**できます。
## セキュリティモデル
| モード | ファイル書き込み | シェル実行 | 用途 |
|--------|-----------------|-----------|------|
| read-only | ブロック | ブロック | review, explain |
| workspace-write | CWDのみ | 許可 | execute, generate |
| danger-full-access | どこでも | 許可 | フルアクセス |
ANSI/OSCエスケープシーケンスのサニタイズ（ターミナルインジェクション防止）も実装済みです。
## まとめ
- **インストール**: git clone + uv sync で完結
- - **単一ファイル構成**: server.py（約820行）のみ
- - **56テスト**: パース、セキュリティ、セッション管理をカバー
リポジトリ: https://github.com/tsunamayo7/claude-code-codex-agents
ライセンス: MIT