Apple 개발자 문서는 사용할 수 없는 이유를 기기 자격, Apple Intelligence 설정, 모델 준비 상태의 세 가지로 설명합니다. 따라서 이번 주에는 Xcode를 다시 설치하기보다 먼저 SystemLanguageModel의 상태를 읽고, 표시된 이유에 맞춰 점검하세요. 상태가 available인데 호출이 실패할 때만 세션과 요청 내용을 살펴보면 됩니다. 사용 불가 이유에 관한 Apple 개발자 문서
이 글은 SwiftUI 수업을 따라 하다가 첫 호출에서 막힌 학생을 위한 점검 안내입니다. Windows나 학교 컴퓨터, 오래된 Mac을 쓰고 있다면 현재 환경으로 실습할 수 있는지도 판단할 수 있습니다. 원격 Mac을 사용 중이라면 연결된 기기 자체의 자격과 모델 상태를 확인한 뒤 다음 단계를 선택하세요.
마지막 업데이트: 2026년 9월 27일. 상태 이름과 지원 범위는 Apple의 현재 기기 요구 사항 및 Apple 개발자 문서의 가용성 정의를 기준으로 확인했습니다. 시스템과 지원 범위는 바뀔 수 있으므로 실제 환경에서는 최신 공식 안내도 다시 확인하세요.
SECTION 01 먼저 확인할 것은 코드가 아니라 모델 상태입니다
SystemLanguageModel은 앱이 쓸 수 있는 시스템 언어 모델을 나타내는 API입니다. 쉽게 말해, 수업에서 실습 도구를 꺼내기 전에 지금 그 도구를 쓸 수 있는지 확인하는 단계입니다. availability는 사용 가능 여부와 사용할 수 없는 이유를 알려줍니다. SystemLanguageModel 문서에 나온 상태를 먼저 확인하면, 기기 문제와 호출 문제를 섞지 않을 수 있습니다.
unavailable은 “앱 코드가 틀렸다”는 뜻으로 단정할 수 없습니다. 기기가 지원 대상이 아니거나, Apple Intelligence가 켜져 있지 않거나, 모델이 아직 준비되지 않은 경우가 서로 다른 이유로 표시됩니다. 반대로 available이어도 모든 요청이 성공한다는 뜻은 아닙니다. 이때는 세션 생성이나 입력 내용에서 원인을 찾아야 합니다.
Apple Foundation Models에서 deviceNotEligible이 나오면 어떻게 하나요?
이 상태는 현재 기기가 Apple Intelligence를 지원하지 않는다는 뜻입니다. 일시적인 다운로드 문제로 보고 계속 기다리거나 Xcode를 다시 설치하기보다, Apple의 지원 기기 및 시스템 요구 사항과 사용 중인 기기를 대조하세요. 지원 대상이 아니라면 해당 모델을 쓰지 않는 수업 내용을 먼저 진행하는 편이 낫습니다.
원격 Mac도 자동으로 지원되는 것은 아닙니다. 접속 방식이 원격이라는 사실만으로 기기 자격이나 지역 관련 조건이 바뀌지는 않습니다. 원격 호스트의 실제 환경과 표시된 상태를 따로 확인하세요.
SECTION 02 이유별로 무엇을 확인해야 하나요?
| 화면이나 코드에서 확인한 상태 | 의미 | 다음에 할 일 |
|---|---|---|
deviceNotEligible |
기기가 지원 대상이 아님 | 공식 기기 요구 사항을 확인하고, 미지원이면 다른 수업 단계로 이동 |
appleIntelligenceNotEnabled |
시스템 기능이 활성화되지 않음 | 시스템 설정과 공식 안내를 확인한 뒤 상태를 다시 읽기 |
modelNotReady |
모델을 아직 사용할 준비가 되지 않음 | 준비가 끝났는지 확인하고, 반복 재시도 대신 시스템 상태를 점검 |
available인데 호출 실패 |
모델은 사용 가능하지만 요청 과정에서 실패 | 세션 생성, 입력 내용, 오류 유형을 차례로 확인 |
Apple Intelligence를 켰는데도 사용할 수 없다면 무엇을 확인하나요?
먼저 시스템 설정에서 Apple Intelligence가 실제로 켜져 있는지, 사용하는 기기와 지역이 현재 공식 지원 조건에 맞는지 확인하세요. 설정 화면에 기능이 보인다는 사실만으로 앱의 API도 준비됐다고 판단하면 안 됩니다. 설정을 바꾼 뒤에는 availability를 다시 읽어 상태가 달라졌는지 확인해야 합니다. 지원 조건을 우회하는 방법은 이 점검의 대안이 아닙니다.
modelNotReady는 얼마나 기다려야 하나요?
Apple 문서는 modelNotReady를 모델을 사용할 준비가 되지 않은 상태로 안내하지만, 모든 기기에 적용되는 고정 대기 시간을 제시하지 않습니다. 따라서 특정 분량을 기다리면 해결된다고 가정하지 마세요. 해당 상태의 설명을 확인하고, 시스템 준비가 끝날 여지를 둔 뒤 상태를 다시 읽으세요. 계속 같다면 네트워크 연결, 전원 상태, 시스템 업데이트나 기기 조건을 확인하고 무작정 재호출하는 것을 멈추세요.
SECTION 03 상태를 확인한 뒤에는 이 순서로 진행하세요
아래 항목을 위에서부터 확인하면 불필요한 재설치와 반복 호출을 줄일 수 있습니다.
- [ ] 현재 환경을 기록합니다. 사용 중인 기기가 내 Mac인지 원격 Mac인지, 학교 컴퓨터인지 확인하고 운영체제와 Xcode 버전을 적어 둡니다.
- [ ]
availability를 읽습니다.SystemLanguageModel의 현재 상태를 확인합니다. 화면의 문구만 보고 원인을 추측하지 말고, 코드에서 얻은 상태를 기준으로 분기하세요. - [ ]
unavailable이면 이유를 확인합니다.deviceNotEligible,appleIntelligenceNotEnabled,modelNotReady중 무엇인지 확인하고 표의 조치만 먼저 적용합니다. - [ ] 설정을 바꿨다면 상태를 다시 읽습니다. Apple Intelligence 설정을 확인했거나 시스템 준비를 기다렸다면, 이전 결과를 재사용하지 말고 새 상태를 확인합니다.
- [ ]
available이면 세션 생성을 점검합니다. 세션은 모델에 작업을 전달하는 대화 단위입니다. LanguageModelSession 문서의 사용 방식과 비교해 생성 단계에서 오류가 나는지 확인하세요. - [ ] 입력과 오류를 나눠 봅니다. 짧고 범위가 분명한 요청으로 먼저 확인하고, 실제 오류 유형을 기록합니다. Foundation Models 오류 문서와 생성 및 작업 안내를 참고하세요.
SECTION 04
available인데 실패하면 요청과 세션을 확인하세요
모델을 사용할 수 있다는 확인과 특정 작업의 성공은 별개입니다. 세션을 만드는 단계에서 실패했는지, 세션은 만들어졌지만 요청이 거부됐는지 구분하면 점검 범위가 좁아집니다. 오류 메시지와 발생한 단계를 함께 기록하고, 공식 오류 정의와 대조하세요.
요청 내용도 살펴야 합니다. Foundation Models가 모든 종류의 작업에 적합한 것은 아니므로, 생성 코드나 복잡한 작업을 처음부터 맡긴 뒤 실패했다고 해서 기기 환경이 손상됐다고 판단하지 마세요. 먼저 공식 생성 안내에 맞는 간단한 작업으로 확인하고, 그 결과와 원래 요청의 차이를 비교하세요.
원격 Mac에서 사용할 수 없으면 기기 문제인가요, 코드 문제인가요?
먼저 원격 호스트에서 availability를 읽으세요. unavailable과 이유가 나오면 그 상태에 맞춰 호스트의 자격과 설정을 확인하고, available이면 세션과 요청 오류를 살펴보면 됩니다. 원격 접속 자체가 지원 조건을 보장하지는 않으므로, 호스트 정보를 확인하지 않은 채 코드를 고치거나 환경을 바꾸지 마세요.
SECTION 05 지금 환경으로 계속할지 바꿀지 판단하세요
학교 컴퓨터에 설치 권한이 없거나, 현재 기기가 지원 대상이 아니면 같은 해결책을 반복해도 진도가 나가지 않을 수 있습니다. 반대로 modelNotReady처럼 준비 상태를 가리키는 경우라면 기기를 바로 바꾸기보다 조건을 확인하고 다시 읽는 것이 먼저입니다. 우선 수업에서 모델을 쓰지 않는 부분을 계속 진행하고, 실습에 필요한 조건이 실제로 부족한지 확인한 뒤 환경 변경을 결정하세요.
현재 컴퓨터를 계속 쓰는 방법은 추가 설정이나 권한 없이 가능한 수업을 이어갈 수 있다는 장점이 있습니다. 다만 학교 장비의 설치 제한, 오래된 기기의 지원 여부, 개인 컴퓨터와 실습 환경이 달라 생기는 재현 문제는 남을 수 있습니다. Mac을 새로 구매하는 선택도 있지만, 수업에 필요한 조건을 확인하기 전에 비용을 들이면 활용하지 못하는 사양을 고를 위험이 있습니다.
환경을 바꿔야 한다면 VPSNIX의 도움말 안내에서 접속과 사용 조건을 확인하고, 요금 및 이용 선택지를 살펴보세요. 대여한 원격 Mac도 호스트가 Apple Foundation Models 요구 조건을 만족해야 하므로, 결제 전에 필요한 기기 조건을 확인하는 것이 우선입니다. 수업이 잠깐 요구하는 테스트 환경이라면 대여가 구매보다 부담을 줄일 수 있지만, 장기간 계속 사용하거나 특정 물리 기기가 필요한 경우에는 내 Mac이나 학교의 지원 환경이 더 적합할 수 있습니다.