Xcode 26 で使う Claude 完全ガイド：iOS/SwiftUI 開発を AI エージェントで自動化する

Apple のネイティブ開発環境 Xcode に、ついに Claude が正式に組み込まれました。Xcode 26 への Claude Sonnet 4 搭載、そして Xcode 26.3 での Claude Agent SDK 統合により、iOS・iPadOS・macOS・watchOS・visionOS アプリ開発のワークフローが根本から変わりつつあります。このガイドでは、Xcode で Claude を使う方法を基本セットアップから実践的な SwiftUI 開発まで徹底解説します。

Claude が Xcode に正式対応するまでの経緯

2025年9月の最初の発表では、Xcode 内で Claude に個別の質問をする「ターンバイターン方式」のみサポートでした。その後 Anthropic と Apple の協力により、Xcode 26 で Claude Sonnet 4 が一般提供（GA） となりました。さらに 2026 年に入り、Xcode 26.3 では Claude Agent SDK との本格統合が実現し、エージェントが自律的にタスクを完遂する仕組みへと進化しています。

VS Code や JetBrains での Claude Code 統合と並んで、Xcode ネイティブ連携は Apple プラットフォーム開発者に特化した強力な選択肢となっています。他の IDE との併用や使い分けについては Claude Code と Cursor・Windsurf を併用するハイブリッド開発ワークフローも参照してください。

Xcode 26 で Claude を使う基本セットアップ

必要な環境

Xcode 26（Mac App Store からダウンロード）
Claude アカウント（Pro・Max プラン、または Team・Enterprise のプレミアムシート）
macOS Sequoia 15 以降

セットアップ手順

Xcode 26 を起動し、Xcode → Settings（⌘,） を開く
Intelligence タブを選択
「Sign in with Claude」をクリックし、claude.ai アカウントでログイン
認証が完了すると、エディタ上部に Claude のアシスタントパネルが表示される

注意: Claude の使用量は他のプラットフォーム（claude.ai、Claude Code CLI など）と共有されます。大規模な開発作業を予定している場合は Max プランを推奨します。

Coding Assistant の主な機能と実践活用

Xcode 26 の Claude Coding Assistant は、単なるコード補完を超えた多様な機能を提供します。

自然言語でのコード生成

アシスタントパネルに日本語でプロンプトを入力するだけで、SwiftUI のコンポーネントや UIKit のコードを生成できます。

// プロンプト例: 「カスタムカードコンポーネントを作って。タイトル、サブタイトル、アイコン画像、
// シャドウ付き角丸カードにして。ダークモード対応で」
 
struct CustomCardView: View {
    let title: String
    let subtitle: String
    let iconName: String
 
    var body: some View {
        HStack(spacing: 16) {
            Image(systemName: iconName)
                .font(.title2)
                .foregroundStyle(.blue)
                .frame(width: 44, height: 44)
                .background(.blue.opacity(0.12), in: RoundedRectangle(cornerRadius: 10))
 
            VStack(alignment: .leading, spacing: 4) {
                Text(title)
                    .font(.headline)
                    .foregroundStyle(.primary)
                Text(subtitle)
                    .font(.subheadline)
                    .foregroundStyle(.secondary)
            }
            Spacer()
        }
        .padding(16)
        .background(.background, in: RoundedRectangle(cornerRadius: 16))
        .shadow(color: .black.opacity(0.08), radius: 8, x: 0, y: 2)
    }
}
 
// Xcode Preview で即確認可能
#Preview {
    CustomCardView(
        title: "Claude Lab",
        subtitle: "AI 開発の最前線",
        iconName: "brain.head.profile"
    )
    .padding()
}

エラーと警告の自動修正

Xcode のビルドエラーや警告が出た際、Claude がその原因を解析して修正案を提示します。エラーメッセージを選択してアシスタントパネルに貼り付けるか、エラー行の左にある「Fix with Claude」ボタンをクリックするだけです。

ドキュメント生成

関数やクラスを選択して「ドキュメントを生成して」と指示すると、Swift DocC 形式のドキュメントコメントが自動生成されます。

/// Claude が自動生成するドキュメントコメント例
///
/// ユーザーの認証状態を管理するビューモデルです。
/// Apple の Sign in with Apple と Google OAuth に対応しています。
///
/// - Parameters:
///   - authService: 認証処理を担当するサービスオブジェクト
/// - Note: このクラスはメインスレッドで使用してください。
@MainActor
class AuthViewModel: ObservableObject {
    // ...
}

Xcode 26.3 × Claude Agent SDK：自律エージェント開発へ

Xcode 26.3 で導入された Claude Agent SDK 統合は、従来の「質問→回答」サイクルを超えた自律型開発を実現します。

エージェントが可能になったこと

Xcode Preview のビジュアル確認: エージェントが SwiftUI プレビューをキャプチャし、UI の問題を視覚的に検出・修正
プロジェクト全体の理解: 単一ファイルではなく、プロジェクト全体のアーキテクチャを把握した上でコーディング
自律的なタスク完遂: 「ログイン画面を実装して」と指示するだけで、ファイル作成・修正・テスト追加まで一連の作業を自動実行

Claude Code CLI から MCP 経由で Xcode を操作する

Claude Code を使っている開発者は、MCP（Model Context Protocol）経由で Xcode のビジュアルプレビューにアクセスできます。端末から Claude Code を動かしながら、Xcode のプレビュー結果をリアルタイムに確認できるため、ヘッドレス環境でも UI 品質を担保した開発が可能になります。

MCP の詳細な設定方法は MCP サーバー実践ガイド：Claude Code で外部ツールを連携するを参照してください。

# Claude Code から Xcode MCP サーバーに接続する設定例
# .claude/claude.json または ~/.claude.json に追加
 
{
  "mcpServers": {
    "xcode": {
      "command": "xcrun",
      "args": ["claude-mcp-server"],
      "env": {
        "XCODE_PROJECT": "/path/to/YourApp.xcodeproj"
      }
    }
  }
}

利用できるプランと使用量の管理

Claude in Xcode は Pro・Max・Team・Enterprise のプレミアムシート向けに提供されています。無料プランでは利用できません。

プラン	Xcode での利用	推奨用途
Pro（$20/月）	✅（共有制限内）	個人開発・副業
Max $100（$100/月）	✅（5倍の使用量）	本格的な iOS 開発
Max $200（$200/月）	✅（20倍の使用量）	大規模プロジェクト
Team	✅（プレミアムシート）	チーム開発

使用量は 5 時間ごとにリセットされます。大量のコード生成や自律エージェントタスクを計画している場合は、オフピーク時間帯（平日 8AM〜2PM ET 以外）の利用も検討してください。

よくある問題と解決方法

Q: Intelligence タブに「Sign in with Claude」が表示されない → Xcode のバージョンを確認してください。Claude 統合は Xcode 26 以降が必要です。Xcode → About Xcode でバージョンを確認し、必要であれば App Store からアップデートしてください。

Q: Claude の回答が途中で止まる → 使用量制限に達した可能性があります。プランの使用量リセットを待つか、次の 5 時間ウィンドウをお待ちください。Max プランへのアップグレードで大幅に制限が緩和されます。

Q: Xcode Preview のキャプチャが機能しない（エージェントモード） → Xcode 26.3 以降が必要です。Xcode → Settings → Intelligence → Enable Preview Capture が有効になっているか確認してください。

ターミナル側の選択肢 — Claude Code CLI で Xcode 開発を回す

エディタ内の Intelligence パネルが Xcode 開発の唯一の入り口ではありません。ターミナルで動く Claude Code CLI は、プロジェクト全体を読み込んだうえで複数ファイルにまたがる実装や xcodebuild の実行までこなします。Intelligence のインライン補完が「いま開いているファイル」を見るのに対し、CLI は「リポジトリ全体」を見て動く、と捉えると使い分けが整理しやすいでしょう。

インストールと iOS 向け CLAUDE.md

Claude Code は npm からグローバルにインストールできます。プロジェクトのルートに CLAUDE.md を置いておくと、毎回プロジェクトの前提を説明し直す手間がなくなります。

npm install -g @anthropic-ai/claude-code
claude --version
 
# Xcode プロジェクトのルートで起動
cd ~/Developer/MyiOSApp
claude

# MyiOSApp — CLAUDE.md
 
## アーキテクチャ
- Swift / SwiftUI, MVVM + async/await（Combine は使わない）
- 最小デプロイターゲット: iOS 17.0
 
## よく使うコマンド
- ビルド: xcodebuild -scheme MyiOSApp -destination 'platform=iOS Simulator,name=iPhone 16'
- テスト: swift test
- Lint: swiftlint lint

アーキテクチャと使用ライブラリを明記しておくほど、生成されるコードが既存のスタイルに馴染みます。

Hooks で保存ごとに自動ビルドする

CLI ならではの強みが、ファイル編集をトリガーにした自動ビルドです。.claude/settings.json を置くと、Claude がコードを書き換えるたびに xcodebuild を走らせ、コンパイルエラーをその場で拾えます。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "xcodebuild -scheme MyiOSApp -destination 'platform=iOS Simulator,name=iPhone 16' build 2>&1 | tail -20"
      }
    ]
  }
}

エラーが出たらそのままエージェントが修正に入るため、「生成 → ビルド → 修正」のループが手を離れます。Hooks の組み方は Claude Code Hooks 完全ガイドで詳しく扱っています。

Swift Testing までまとめて生成する

Swift で導入された Testing フレームワークのテスト作成も、対象クラスを読ませて頼むだけで済みます。モックを含めて、正常系・異常系・境界値を一通り書いてくれるのが助かるところです。

import Testing
@testable import MyiOSApp
 
@Suite("ProfileViewModel Tests")
struct ProfileViewModelTests {
    @Test("読み込み成功時に名前とメールが設定される")
    func loadProfileSuccess() async {
        let service = MockProfileService(
            result: .success(Profile(name: "田中太郎", email: "tanaka@example.com"))
        )
        let viewModel = ProfileViewModel(service: service)
        await viewModel.loadProfile()
        #expect(viewModel.displayName == "田中太郎")
        #expect(viewModel.errorMessage == nil)
    }
 
    @Test("空文字の名前はデフォルト名に置き換わる", arguments: ["", "   "])
    func emptyNameFallback(name: String) async {
        let service = MockProfileService(
            result: .success(Profile(name: name, email: "test@example.com"))
        )
        let viewModel = ProfileViewModel(service: service)
        await viewModel.loadProfile()
        #expect(viewModel.displayName == "ゲスト")
    }
}

arguments: でパラメータ化したテストを一度に書けるので、境界値の取りこぼしが減ります。Core Data のモデル定義から NSManagedObject サブクラスと Repository パターンまでをまとめて起こす、といった広い単位の作業も同じ流儀で頼めます。

現場で効く小さな自動化

日々の開発では、こうした細かい依頼が積み重なって効いてきます。Localizable.strings の日英対訳を一括で埋める、Apple のプライバシー要件に沿って PrivacyInfo.xcprivacy を点検する、swiftlint lint の出力を丸ごと渡して規約違反をまとめて直す。どれも単独では数分の作業ですが、私自身、個人開発で iOS アプリを作っていると、この数分が一日に何度も挟まります。CLI に渡しておくと、その分の集中を実装そのものに残せます。リリース工程まで自動化したい場合は Claude Code × App Store Connect API でリリースを自動化するガイドもあわせてどうぞ。

全体を振り返って

Xcode 26 への Claude 統合は、iOS/macOS 開発者にとって大きな転換点になりました。エディタ内の Intelligence パネルで SwiftUI を自然言語から起こし、Xcode 26.3 の Claude Agent SDK で自律的にタスクを片づけ、行き詰まったらターミナルの Claude Code CLI でプロジェクト全体を見渡す。場面ごとに最適な入り口を選べるようになっています。

まずは Intelligence 設定で Claude にサインインし、小さなコンポーネントをひとつ生成するところから始めてみてください。手応えがつかめたら、CLAUDE.md と Hooks を整えてターミナル側のワークフローへ広げていくと、生成からビルド・テストまでが一筆書きでつながります。

Xcode 26 で使う Claude ：iOS/SwiftUI 開発を AI エージェントで自動化する