読み終わるとできること
- Apple シリコンの Mac に Xcode 27 を入れ、ツールバーからコーディング Agent を開き、リポジトリを触る前に
/planを使う。 - Foundation Models の
LanguageModelSessionで、最初のオンデバイス要約を書く。 - 作業ごとにオンデバイスのシステムモデル、Private Cloud Compute、Core AI / MLX、Claude / Gemini パッケージを選ぶ。
- Tool と Dynamic Profile で、チャット窓を増やさずにアプリ内 Agent にする。
- 地域制限、コンテキスト超過、メモリ圧は公式ドキュメントに照らす。手順は文書と WWDC であり、当サイトの実測ではない。
先に Xcode 27 に工程を触らせ、同じ Swift API でモデルをアプリへ入れる。二つの作業を「AI を入れる」一クリックにまとめてはいけない。
前提:Xcode 27 が入ってから Apple AI の話をする
Apple の Xcode のシステム条件 では、Xcode 27 に macOS Tahoe 26.6 以降と、iOS 27 から macOS 27 までの SDK が必要です。Xcode 27 リリースノート は、Xcode 27 が Apple シリコンにしか入らず動かないと書いています。Intel Mac は利用者の機械にはなれますが、この教程の開発機にはなれません。
2026年6月の Apple ニュースリリース は、iOS 27、macOS 27、Xcode 27 の開発者ベータがその日に developer.apple.com へ出たと書いています。Apple Intelligence は地域制限のままです。次のリストは着手の順であり、「新しいほどよい」ではありません。
- Apple シリコンの Mac。OS はドキュメントが名指しする macOS にする。
- 開発者アカウントでサイトから Xcode 27 を入れる。残り物の Xcode 26 に iOS 27 SDK を当てない。
- システム設定で Apple Intelligence をオンにする。非対応地域ではオンデバイスセッションがすぐ失敗する。
- iOS か macOS の App を新規または既存で開く。デプロイ先は実際に呼ぶ API に合わせ、古い gist の iOS 18 をコピーしない。
- Cmd+R でシミュレータに入ってから、コーディング Agent を開き、FoundationModels を import する。
メモリの段は別記事です。アシスタントがシミュレータを自分で上げるとき、16GB と 24GB の差は圧力の曲線です。Xcode 27 の AI コーディングに必要な Mac 構成 を見てください。このページが求めるのは、Xcode 27 が入ることと、Mac を起こしたままにできることだけです。
Xcode 27 の使い方:コーディング Agent から最初の計画まで
What’s new in Xcode 27 はコーディング Agent をサイドバーのチャットからエディタの会話へ移します。分割もタブも並列タスクもできます。ツールバーが新しい会話を始めます。ファイルを触る前に考えたいときはスラッシュコマンド /plan です。
- 工程を開き、ツールバーからコーディング Agent の会話を始める。古い Assistant サイドバーではなく、エディタのタブとして出る。
- 最初の文を「この App を SwiftUI に書き直せ」にしない。対象ファイル、動かしてはいけないモジュール、確認方法(テストかシミュレータの画面)を書く。
/planを入れる。Agent は文脈を集め、必要ならサブ Agent を出し、計画を書いてファイルは触らない。計画に注釈を付けてから実装を許す。- 右側の diff と成果物(画面、プレビュー)を見る。リリースノートでは、シミュレータ起動、App のインストール、タッチの合成ができる。Build と Submit はあなたが持つ。
- 並列の会話はコーディングアシスタントのサイドバーで未読を見る。二つの Agent に同じファイルを触らせない。一度に承認する計画は一つ。
Xcode 27 の Agent は Swift と Apple の枠組みを知っています。Foundation Models ではありません。触るのはソースです。次の節の Swift API が、利用者にモデルを渡します。両方を同時に開けます。左で Agent が書き、シミュレータで今書いた respond(to:) を走らせます。
ターミナルの Claude Code は別ホストのコーディング Agent です。App Store に出すなら Xcode に残ります。並列の Agent に同じファイルを触らせない境界は AI Agent のファイル分離の実践 です。
Foundation Models:最初に通る Swift
Foundation Models フレームワークのページ は、アプリ内の任意の大規模言語モデル向けのネイティブ Swift API だと定義しています。オンデバイスのシステムモデル、Private Cloud Compute、Language Model プロトコルに従う第三者パッケージは、同じ Session を使います。WWDC26 の Apple Intelligence ガイド は、画像を挟むマルチモーダルなプロンプトと、モデルが直接呼べる Vision の OCR とバーコードを足しています。
import FoundationModels
let session = LanguageModelSession(
instructions: "You summarize travel notes in three short sentences."
)
let response = try await session.respond(
to: "Notes: fly to Tokyo at 09:00, then Asakusa."
)
print(response.content)
同期の init ではなく、ボタンか非同期タスクに置く。モジュールが見つからないときは、ターゲットで FoundationModels をリンクし、デプロイ版をドキュメントの条件まで上げる。
Session は状態を持ちます。毎回の respond(to:) は transcript に残ります。コンテキストが埋まるとエラーになります。無限チャットは想定しません。iOS 26.4 からコンテキストサイズとトークン数を調べられます。超えたら新しい Session を開き、必要なら instructions と最後の成功応答だけを持ち越します。公式セッションの回復手順であり、「App を再起動」ではありません。
ローカル AI の選び方:オンデバイス、Core AI、MLX、PCC
What’s new in the Foundation Models framework は選択肢を並べます。オンデバイスのシステムモデルは作り直され、指示追従がよく、プロンプトに画像を直接入れられます。より大きなモデルが要るときは PrivateCloudComputeLanguageModel です。文脈はおよそ 32K トークンで、推論の段があります。自分の重みを端末に載せるなら、オープンソースの Core AI か MLX です。Claude と Gemini は同じプロトコルの Swift パッケージです。
| 経路 | 向いている作業 | 払うもの |
|---|---|---|
| SystemLanguageModel(オンデバイス) | 要約、分類、短い会話、オフライン、プライバシー | 端末の計算と電池。クラウド API の請求はない |
| Private Cloud Compute | 推論、長い文脈、watchOS 27 でも Apple のモデル | 中小企業プログラムで初回ダウンロードが 200 万未満なら、ニュースリリースはクラウド API 費用なしと書く。entitlement は文書どおり申請する |
| Core AI | 自分の LLM をユニファイドメモリと Neural Engine で動かす | バイナリ、メモリ、熱。トークン請求はないが端末の上限がある |
| MLX Language Model | Hugging Face の MLX-Community のオープンモデルを試す | 入手とライセンス。GPU/ANE の占有 |
| Claude / Gemini パッケージ | 最前線のクラウドモデル、同じ Tool と guided generation | トークン課金。鍵は Keychain / OAuth。バイナリに書かない |
PCC の呼び方はオンデバイスと同じで、モデルの実体を入れ替えるだけです。推論の深さは遅延と交換します。「プロンプトを保存しない」主張は独立研究者が検証できます。詳細は PCC のセッションであり、この導入手順では展開しません。
import FoundationModels
let model = PrivateCloudComputeLanguageModel()
let session = LanguageModelSession(model: model)
let response = try await session.respond(
to: "Propose three origami projects from this journal.",
options: GenerationOptions()
)
print(response.content)
macOS 27 は端末や PCC を叩く fm コマンドと Python SDK も出します。スクリプト向きであり、アプリ内の Swift Session の代わりではありません。ローカルモデルが Xcode とシミュレータとユニファイドメモリを奪い合うときは、先に Apple Silicon クラウド Mac Runner のメモリ急増と swap を見て、重みを残すか Session だけ PCC にするかを決めます。
アプリ内の AI Agent:Tool と Dynamic Profile
Xcode のコーディング Agent はリポジトリを直します。アプリ内 Agent はモデルとツールと差し替え可能な指示です。What’s new in the Foundation Models framework は手芸日記の例です。写真をオンデバイスで分析し、日記へ書き戻す Tool を呼び、次に PCC でブレストします。以前は Session を複数抱える作業でした。今は Dynamic Profile が、一つの Session の中で今の instructions、tools、モデルを条件で選びます。
ゼロから一気に多 Agent 編成をしない。この順で受け入れる。
- Session 一つ、instructions 固定、
respondが通る。 - 自分で書いた Tool を一つ(例:構造化結果を SwiftData に残す)。呼ぶタイミングはモデル、副作用を取り消せるかはあなた。
- 必要ならシステムツール。Vision の OCR / バーコード、Spotlight 上のローカル検索。
- 二つのモードを Dynamic Profile にする。分析はオンデバイス、計画は PCC。同時に有効な Profile は一つ。
システム全体の発見は別線です。App Intents が内容と動作を Siri と Spotlight に渡します。範囲は WWDC 2026:iOS 27 と Siri / Apple Intelligence です。この教程の Agent はあなたのプロセスの中に留まります。感覚で品質を測らない。Evaluations はプロンプト変更の統計です。単体テストの代わりではなく、Tool の副作用の断言の代わりでもありません。
エラー、地域、機械:止まったらどの層か
失敗を四層に分ける。「Apple Intelligence がオフ」を「モデルを替える」で直さない。
- Xcode 27 が入らない:OS の版か Intel チップ。条件とノートを見る。掲示板の古いビルドをコピーしない。
- Session がすぐ失敗:地域、モデル資産のダウンロード途中、デプロイ先が低い。設定のスイッチを見てから可用性 API。
- 会話の途中でエラー:コンテキスト。超過を捉え、transcript を縮めて新しい Session。
- 機械が粘る:コーディング Agent とシミュレータとローカルモデルが同じユニファイドメモリ。先に大きなローカルモデルを閉じ、SSD を足す前に 24GB を検討する。
第三者のクラウドモデルには請求と鍵が付きます。Session と応答の usage で入力、キャッシュヒット、推論トークンが見えます。鍵を Git に入れない。Foundation Models の不具合ではなく、トークン課金の提供者を選んだ結果です。
FAQ
Swift がほぼ書けなくてもこの教程についていけるか
コーディング Agent は Swift を下書きできます。それでも diff を読み、テストを走らせ、権限とキーチェーンを触る Tool を拒否する必要があります。Swift が読めないなら、ファイル書きや課金の Tool を繋がないでください。
Foundation Models はネット必須か
オンデバイスのシステムモデルはオフラインで動く設計です。PCC と Claude / Gemini はネットが要ります。ニュースリリースの「クラウド API 費用なし」は条件を満たす PCC であり、すべてのモデルではありません。
Xcode のコーディング Agent とアプリ内 Agent は同じか
違います。前者はソースと作業領域を直します。後者は利用者の端末でモデルと Tool を呼びます。検索がどちらも「Apple AI」と呼ぶので、この教程は両方を書きます。
小さな会社の PCC は本当に無料か
ニュースリリースとフレームワークのページは、App Store 中小企業プログラムに入り、累計の初回ダウンロードが 200 万未満なら、PCC 上の次世代 Apple Foundation Models にクラウド API 費用がないと書きます。資格、枠、iCloud+ 利用者の上乗せは開発者ドキュメントと entitlement が正です。利用者向けの価格ページにその文を貼らないでください。
ローカル AI のために新しい Mac が必要か
Xcode 27 が動く Apple シリコンが必要です。初日に新品を買う必要はありません。16GB で着手できます。アシスタントがシミュレータを占有し続けるなら 24GB を評価します。段を変えられるクラウド Mac で同じ工程を走らせてから、本機の注文でユニファイドメモリを固定できます。
まとめ
順は固定です。Xcode 27 が入る → コーディング Agent を /plan で抑える → LanguageModelSession を一段 → 作業ごとにオンデバイス / PCC / Core AI を替える → Tool と Dynamic Profile でアプリ内 Agent。各段は単独で受け入れできます。初日に提供者を三つ繋がないでください。
コーディング Agent には蓋を閉じない Apple シリコン Mac が要る
Xcode 27 の Agent はシミュレータとプレビューを上げます。Foundation Models のオンデバイスと Core AI は同じユニファイドメモリを食べます。ノートの蓋や睡眠は長い計画を切ります。kvmboot のクラウド Mac mini は起きっぱなしの Apple シリコンで、Xcode 27 の工程と最初の Session を SSH できる環境で確かめられます。メモリの段は Xcode 27 の AI コーディングに必要な Mac 構成。