この記事は、AIエージェントを段階的に構築していくシリーズの第1弾です。
まずは、VS CodeのClaude Codeを使って、iOSコードレビューから修正、Xcodeビルド確認までを自動化する流れを扱います。

はじめに

iOSアプリ開発において、コードレビュー → 修正 → ビルド確認のサイクルは日常的に発生します。

この記事では、VS Code上のClaude Codeから、Gitの差分をレビューし、問題があればコードを修正し、Xcodeでビルドが通るかまで確認する一連の流れを構築する方法を紹介します。

ポイントは xcrun mcpbridge を使ったXcodeとのMCP接続です。これにより、Claude CodeがXcodeのビルドや診断情報にアクセスできるようになります。

全体像

VS Code (Claude Code)
  │
  ├── git diff で差分取得・レビュー
  ├── ファイルを直接編集して修正
  │
  └── MCP (xcrun mcpbridge) 経由
        └── Xcode にビルド指示 → 結果取得

Claude Codeがターミナル操作とXcode操作の両方を担い、人間は指示を出すだけで一連のフローが完了します。

前提条件

項目	バージョン等
macOS	Sonoma 以降推奨
Xcode	26.0 以降（`mcpbridge` 対応）
Node.js	v18 以降
VS Code	最新版
Claude Code VS Code拡張機能	インストール済み
Anthropicアカウント	Claude Pro / Team / Enterprise いずれか

手順

1. Xcode側の設定

まず、Xcodeで外部エージェントからのMCP接続を許可します。

Claude Agentの確認

Xcode > Settings > Intelligence > Claude Agent を開き、モデルとアカウントが設定されていることを確認します。

Claude Agentが登録され、モデル（Opus）とアカウントが設定されている状態

MCP接続の許可（重要）

同じく Settings > Intelligence の画面下部にある 「Model Context Protocol」 セクションで、「Allow external agents to use Xcode tools」を有効（ON） にします。

「Allow external agents to use Xcode tools」のトグルをONにする

この設定をONにしないと、VS CodeのClaude Codeからのビルド指示が機能しません。 必ず有効にしてください。

2. Claude Code VS Code拡張機能のインストール（未導入の場合）

以下の公式ドキュメントを参考に、VS Code用のClaude Code拡張機能をインストールします。

3. Node.js のインストール（未導入の場合）

brew install node

インストール確認：

node -v
npm -v

3. Claude Code CLI のインストール

VS Codeの拡張機能だけではターミナルから claude コマンドが使えません。CLIを別途インストールします。

npm install -g @anthropic-ai/claude-code

インストール確認：

claude --version

注意: VS CodeのClaude Code拡張機能はエディタ内のUI統合を提供しますが、claude mcp add などのコマンドを実行するにはCLIが必要です。

5. Xcode MCP ブリッジの接続

以下のコマンドで、Claude CodeにXcodeのMCPサーバーを登録します。

claude mcp add --transport stdio xcode -- xcrun mcpbridge

成功すると以下のように表示されます：

Added stdio MCP server xcode with command: xcrun mcpbridge to local config
File modified: /Users/<ユーザー名>/.claude.json

補足: mcpbridge はアクティブなXcodeプロセスを自動検出します。実際にビルド等を実行する際にはXcodeでプロジェクトを開いておく必要があります。

6. 実行

事前準備

Xcode で対象プロジェクトを開く（mcpbridgeがプロセスを検出するため）
VS Code で同じプロジェクトを開く

プロンプトの入力

VS Code内のClaude Codeに以下のプロンプトを入力します。

467904298..4a209d66a の差分をレビューして、
問題があれば修正し、Xcodeでビルドが通るか確認してください

467904298..4a209d66a の部分は、レビュー対象のコミット範囲を指定しています。以下のような形式が使えます。

# コミットハッシュで範囲指定
467904298..4a209d66a

# ブランチ間の差分
main..feature/login

# タグ間の差分
v1.2.0..v1.3.0

# 直近N件のコミット
HEAD~3..HEAD

Claude Codeが実行するフロー

このプロンプトを入力すると、Claude Codeが以下を自動的に実行します。

git diff 467904298..4a209d66a で差分を取得
差分の内容をレビューし、問題点を報告
問題のあるファイルを直接修正
mcpbridge 経由でXcodeにビルドを指示
ビルド結果を確認し、エラーがあればさらに修正
最終結果を報告

人間が操作するのは最初のプロンプト入力だけで、あとはClaude Codeが一連の作業を自動で進めます。

レビューだけ行いたい場合

修正やビルド確認は不要で、レビューだけしたい場合は MCP接続は不要 です。以下のようなプロンプトで実行できます。

467904298..4a209d66a の差分をレビューしてください。
コード修正は行わず、問題点の有無とリスク評価を日本語で出力してください。

MCP接続の確認・管理

# 設定済みのMCPサーバーを確認
claude mcp list

# MCP接続の削除（不要になった場合）
claude mcp remove xcode

まとめ

やりたいこと	Xcode MCP設定	CLI MCP接続
コードレビューのみ	不要	不要
レビュー + 修正 + ビルド確認	ONにする	必要

セットアップのポイントは2つです。

Xcode側: Settings > Intelligence で「Allow external agents to use Xcode tools」をON
ターミナル側: claude mcp add でmcpbridgeを登録

この2つが揃えば、VS CodeのClaude Codeにプロンプトを1行入力するだけで、レビューから修正、ビルド確認までを一気通貫で実行できます。

本記事は、AIエージェントを段階的に構築していくシリーズの一部です。