無料相談する

カテゴリー / VS Code・Git・ツール連携

Claude CodeとXcodeの連携方法｜内蔵機能・MCP・シミュレータ

NO WAVE公開 更新 読了目安 14分

この記事の目次

Claude Code と Xcode の連携には、Anthropic の公式資料に載っている連携経路が3つある。1つ目は Xcode の設定画面で Claude アカウントにサインインし、Xcode の中で Claude を使う方法。2つ目は Xcode 26.3 が MCP で公開する機能に、ターミナルの Claude Code から接続する方法。3つ目は Claude Code Desktop の iOS Simulator ペイン（CLI なら computer use）で、Claude にアプリをビルドさせ、シミュレータ上で動作確認までさせる方法だ。どれを選ぶかは「どこで作業したいか」と「契約プラン」でほぼ決まる。

Claude Code と Xcode の連携にはどんな経路があるか？

3つの経路を、Xcode 内蔵は版ごとに、シミュレータは Desktop と CLI に分けて、作業する場所・できること・対象プランで並べると次のようになる。

経路 作業する場所 主にできること 対象プラン（公式記載）
Xcode 26 内蔵の Claude Xcode コードへの質問、ドキュメント生成、SwiftUI プレビュー作成、警告・エラーの修正 Pro、Max、Team/Enterprise のプレミアムシート
Xcode 26.3 の Claude Agent Xcode 目標を渡しての自律的な作業、Previews での見た目確認 本稿の調査では確認できず
Claude Code CLI から Xcode の MCP に接続 ターミナル CLI のまま Xcode と連携し、Xcode Previews を取得する 本稿の調査では確認できず
Claude Code Desktop の iOS Simulator ペイン（公開ベータ） Claude Desktop（macOS） ビルド、シミュレータ起動、タップ操作での動作確認 Pro、Max、Team、Enterprise（HIPAA 構成の Enterprise を除く）
CLI の computer use（リサーチプレビュー）でシミュレータを操作 ターミナル＋画面操作 xcodebuild でのビルドと、画面操作による確認 Pro、Max のみ（Team/Enterprise は不可）

Xcode 内での Claude の利用枠について、Anthropic のヘルプ記事は、他のプラットフォームと上限を共有し、5時間ごとのリセットと週次の上限に計上されると説明している。上限そのものの考え方は Claude Code の使用制限 で扱っている。

Xcode の中で Claude を使うにはどう設定するか？

Xcode だけで完結させたいなら、Xcode の設定から Claude アカウントにログインする。ヘルプ記事に載っている手順は次の3つだ。

  1. Mac App Store から Xcode 26 を入手する
  2. Xcode の設定を開き、Intelligence の項目へ進む
  3. Claude アカウントでログインする

ヘルプ記事が Xcode の中で Claude が支える機能として挙げているのは次のとおり。

  • コーディングアシスタント: 自然言語でコードについて質問でき、作業中の会話を覚えている。ファイルを添付して、デバッグや構造の改善、新機能の開発を相談できる
  • コーディングツール: ドキュメント生成、選択した箇所の説明、SwiftUI のプレビューと Playground の作成、エディタ上でのインライン変更、警告とエラーの自動修正

対象は Pro と Max の個人プラン、そして Team と Enterprise のプレミアムシートだ。チームで使えないメンバーがいる場合は、そのメンバーのプランとシートがこの条件を満たしているかを管理者に確認する。

Xcode 26.3 で何が加わったか

Xcode 26 の時点で、Claude の役割は1回ずつの依頼に答える支援にとどまっていた。Anthropic は、Xcode 26.3 で Claude Agent SDK とのネイティブ統合が入ったと告知している。Claude Agent SDK は Claude Code と同じ基盤で、Xcode の中からサブエージェント、バックグラウンドタスク、プラグインが使える。

告知で挙げられている具体的な動きを4点に整理する。

  • Xcode Previews をキャプチャして作っている画面の見た目を確かめ、見つけた問題をもとに直しを繰り返す
  • プロジェクト全体のファイル構成を探索し、コードを書く前に変更が必要な箇所を特定する
  • 細かい指示ではなく目標を渡すと、作業を分解し、どのファイルを直すか決め、うまくいかなければやり直す。Apple の API の使い方は Apple のドキュメントを直接検索して調べる
  • 同じ機能を MCP でも公開する（次の節で扱う経路）

告知の時点で Xcode 26.3 は Apple Developer Program 向けのリリース候補版として配布されていた。Claude Agent は 26.3 で入った機能として告知されているので、見当たらない場合は手元の Xcode のバージョンを確認する。なお、26.3 の Claude Agent に必要なプランやサインイン方法は、本稿の調査（Anthropic の告知とヘルプ記事）では確認できなかった。

ターミナルの Claude Code から Xcode につなぐには？

普段ターミナルで Claude Code を使っているなら、Xcode を MCP サーバーとして登録する経路が合う。Anthropic の告知によると、Xcode 26.3 は機能を MCP（Model Context Protocol）でも公開しており、Claude Code を使う開発者は MCP経由で Xcode と連携し、CLI を離れずにXcodeのプレビュー取得ができる。

ただし、Xcode 側で MCP を有効にする手順、Claude Code に登録する起動コマンド、接続方式（ローカルの stdio か HTTP か）は、本稿の調査では確認できなかった。この部分は Apple の Xcode ドキュメントで確認する必要がある。以下は Claude Code に MCP サーバーを登録する一般的な手順で、Xcode 固有の手順ではない。MCP のクイックスタートによると、ローカルの stdio サーバーは claude mcp add <name> -- <起動コマンド> の形で登録し、-- より後ろが Claude Code の実行する起動コマンドになる。--transport の指定は要らない。登録したら接続状態を確認する。

claude mcp list

✔ Connected と出れば接続できている。詳しい状態は次のコマンドで見られる。

claude mcp get <name>

登録先のスコープをどう選ぶか

claude mcp add は、何も指定しなければ local スコープに登録する。自分だけが、そのプロジェクトでだけ使える状態だ。スコープによって保存先が変わる。

スコープ 保存先 使える人
local（既定） ~/.claude.json のこのプロジェクトの項目 自分だけ、このプロジェクトだけ
project プロジェクト直下の .mcp.json リポジトリをクローンした全員
user ~/.claude.json の mcpServers 自分だけ、全プロジェクト

MCP サーバーの共有設定をチームで整えたいときは、一般には --scope project で .mcp.json に書き、リポジトリにコミットする。クローンしたメンバーが Claude Code を起動すると承認の確認が表示され、承認すると接続される。MCP の仕組みそのものは Claude Code の MCP 解説 にまとめてある。

Claude にアプリをビルドさせ、シミュレータで確認させるには？

コードを書くだけでなく「動かして確かめる」までを任せたいなら、Claude Code Desktop の iOS Simulator ペインを使う。公式ドキュメントによると、Claude がシミュレータでアプリをビルド・インストール・起動・確認するとペインが自動で開き、デバイスの画面をライブで映す。自分でクリックやドラッグをしてタップ・スワイプすることもできる。

主な環境要件は次の3つ。対象プランは冒頭の表のとおり。

  • Claude Desktop v1.24012.0 以降
  • Mac（iOS Simulator は macOS でしか動かない）
  • iOS プラットフォームを入れた Xcode。推奨は Xcode 26.x または Xcode 27

ペインを開くためのコマンドや設定はない。Code タブでアプリのプロジェクトをプロジェクトフォルダとしてセッションを始め、「アプリをビルドしてシミュレータで起動し、オンボーディングの流れを確認して」のように、実行や確認を目的として頼む。最初にデバイスを使うときはデバイス権限を求められ、許可はセッションごとではなくデバイスごとに1回で済む。

使う前に知っておきたい点がいくつかある。

  • ペインはローカルセッションでのみ使える。クラウドや SSH のセッションからは Mac のシミュレータに届かない
  • Claude が撮ったデバイスのスクリーンショットは Anthropic に送られ、通常の会話の保持設定で扱われる。Claude が使うデバイスで実際のアカウントにサインインしない
  • 公式ドキュメントは、デバイスで URL を開く操作（ディープリンクのテストなど）とアプリのビルドの2つを、デバイスへの一回限りの許可ではなくセッションの権限モードに従う操作として挙げている。ビルドについては xcodebuild がプロジェクトのビルドスクリプトを Mac 上で実行するためと説明されている
  • 並行セッションはデバイスを共有せず、1セッションで最大4台までペインを開ける
  • 操作できるのはシミュレータだけで、実機の iPhone や iPad は動かせない。公式ドキュメントは、実機では自分で Xcode から実行し、見えた内容を説明するかスクリーンショットを添付するよう案内している

Xcode を複数入れている場合、ペインは xcode-select が指している Xcode を使う。今どれが選ばれているかは次で確認できる。

xcode-select -p

別の Xcode に切り替えるときはパスを指定し、そのあと Claude Desktop を終了して開き直す。次は公式ドキュメントの例なので、パスは自分の Xcode のインストール先に置き換える。

sudo xcode-select -s /Applications/Xcode-26.4.app

CLI でシミュレータを操作する場合

ターミナルの Claude Code では、シミュレータの操作は computer use 経由になる。computer use は組み込みの MCP サーバー computer-use として用意されていて、既定ではオフだ。対話セッションで /mcp を実行し、サーバー一覧で無効になっている computer-use を選んで Enable にする。設定はプロジェクト単位で残る。Claude が初めて画面を操作しようとしたときに、macOS のアクセシビリティと画面収録の2つの許可を求められる。

computer use は macOS のリサーチプレビューで、Pro と Max のプランに限られ、Team と Enterprise では使えない。-p での非対話実行でも使えない。ネイティブアプリの検証を頼むと、xcodebuild でビルドし、アプリを起動して画面を操作し、結果を報告する。CLI 版 computer use の詳細は Claude Code の computer use（CLI） で扱っている。

連携がうまく動かないときは何を確認するか？

経路ごとに、公式資料にある確認点を並べる。

Xcode 内の Claude にログインできない・使えない

  • 契約が Pro か Max か、Team/Enterprise ならプレミアムシートか
  • Xcode のバージョン。ヘルプ記事は Xcode 26 を前提にしており、Claude Agent は 26.3 で入った機能として告知されている
  • 「You’ve reached your rate limit, please try again later.」は、ヘルプ記事によると5時間または週次のどちらかの上限に達したときに表示される

Claude Code から MCP サーバーにつながらない

  • claude mcp list の状態が Failed to connect なら、claude mcp get <name> でエラーの詳細を見る
  • stdio サーバーなら、登録した起動コマンドを端末で直接実行し、その場のエラーを確認する。claude mcp get <name> に表示されるコマンドが意図と違う場合は、-- を付け忘れている可能性が高い。削除して -- を付けて登録し直す
  • /mcp に何も出ないときは、別のプロジェクトで claude mcp add していないか確かめる。local スコープのサーバーは登録したプロジェクトでしか有効にならない
  • .mcp.json で共有したサーバーが Pending approval のままなら、claude を起動して承認する
  • 起動に時間がかかって切れる場合、既定の起動タイムアウトは30秒で、MCP_TIMEOUT（ミリ秒）で延ばせる
MCP_TIMEOUT=60000 claude

シミュレータのペインが開かない

  • 「iOS Simulator でアプリを起動して、サインアップの流れをタップして確認して」のように、実行・確認が目的だと明示する
  • Xcode と iOS シミュレータが入っていて、推奨バージョンの Xcode か
  • 組織が管理設定 disableMobileSimulatorTools でシミュレータツールを止めていないか
  • HIPAA 構成が有効な Enterprise 組織ではペインを使えない
  • Claude Desktop が v1.24012.0 以降か。メニューの Claude から Check for Updates で更新して再起動する

ペインに no simulators were found と表示されるのは、Xcode は入っているが iOS シミュレータが1台もない状態だ。Xcode の設定から iOS シミュレータのランタイムを入れるか、次のコマンドで取得する。

xcodebuild -downloadPlatform iOS

CLI の /mcp に computer-use が出ない

  • macOS か（CLI 版は Linux と Windows では使えない）
  • Pro か Max か。/status でサブスクリプションを確認する
  • claude.ai で認証しているか。Amazon Bedrock などのサードパーティ経由だけでは使えない
  • -p ではなく対話セッションか

これらで原因が絞れないときの一般的な切り分けは Claude Code のエラー切り分けガイド を使ってほしい。

どの経路から始めればよいか？

Xcode から離れずに補助を受けたいなら Xcode 内蔵の Claude、ターミナル中心で作業しているなら MCP 接続、画面の動作確認まで任せたいなら Claude Code Desktop の iOS Simulator ペインが向いている。Xcode 内蔵で日々のコード支援を受けながら、確認作業だけ Desktop に任せるといった組み合わせ方も考えられる。

この記事は、2026年10月18日に取得した Anthropic のヘルプ記事、告知、Claude Code ドキュメントの本文をもとに整理したもので、実機での動作確認はしていない。Xcode 側で MCP を有効にする手順は本稿の確認範囲外なので、Apple の Xcode ドキュメントで確認してほしい。

Claude Code の設定や運用を学びたい場合は、月額1,980円から参加できるNO WAVE の学習コミュニティ「AI駆動ラボ」（lab.no-wave.jp）もある。

CONTINUE THE SESSION

関連記事