2026 애플 AI 개발자 입문 가이드: Xcode 27 사용법, Foundation Models·온디바이스 AI·AI Agent 처음부터

읽고 나서 할 수 있는 일

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 설치’ 한 번에 섞지 마라.

Mac의 Xcode에서 Swift를 쓰며 Foundation Models를 호출할 준비를 하는 개발자 — Xcode 27 코딩 Agent는 프로젝트를 고친다. 앱이 모델과 말하는 입구는 Foundation Models다.

전제: 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 뉴스룸는 그날 developer.apple.com에 iOS 27, macOS 27, Xcode 27 개발자 베타가 올라왔다고 합니다. Apple Intelligence는 여전히 지역 제한입니다. 아래 목록은 착수 순서이지 ‘새로울수록 좋다’가 아닙니다.

Apple 실리콘 Mac. OS는 문서가 지명한 macOS로 올린다.
개발자 계정으로 사이트에서 Xcode 27을 설치한다. 남은 Xcode 26에 iOS 27 SDK를 겨냥하지 않는다.
시스템 설정에서 Apple Intelligence를 켠다. 미지원 지역에서는 온디바이스 세션이 바로 실패한다.
iOS 또는 macOS 앱을 만들거나 연다. 배포 대상은 실제로 호출할 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 사이드바가 아니라 편집기 탭으로 나타난다.
첫 문장을 ‘이 앱을 SwiftUI로 다시 써라’로 쓰지 않는다. 대상 파일, 건드리면 안 되는 모듈, 확인 방법(테스트 또는 시뮬레이터 화면)을 적는다.
/plan을 입력한다. Agent는 맥락을 모으고 필요하면 하위 Agent를 띄우며 계획은 쓰고 파일은 건드리지 않는다. 계획에 주석을 단 뒤 구현을 허용한다.
오른쪽 diff와 산출물(화면, 프리뷰)을 본다. 릴리스 노트는 시뮬레이터 기동, 앱 설치, 터치 합성을 허용한다. 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와 마지막 성공 응답만 가져갑니다. 공식 세션의 복구 경로이지 ‘앱 재시작’이 아닙니다.

로컬 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 세션이지 이 설치 절차가 아닙니다.

Private Cloud Compute로 전환(같은 Session API)

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 CLI와 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 설치 → /plan으로 코딩 Agent를 묶음 → LanguageModelSession 한 단 → 작업마다 온디바이스 / PCC / Core AI 교체 → Tool과 Dynamic Profile로 앱 안 Agent. 각 단계는 따로 검수합니다. 첫날에 제공자를 셋 붙이지 마세요.