For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색
Codex

Codex use case

iOS 앱 빌드하기

Codex로 iPhone 및 iPad용 SwiftUI 앱을 스캐폴딩하고 빌드하며 디버그하세요.

Difficulty 고급
Time horizon 1시간

Codex로 iOS SwiftUI 프로젝트를 스캐폴딩하고, xcodebuild 또는 Tuist를 사용해 빌드 루프를 CLI 중심으로 유지하며, 작업이 심화되면 XcodeBuildMCP나 특화된 SwiftUI 스킬을 추가하세요.

적합한 대상

  • Codex로 앱과 빌드 루프를 처음부터 스캐폴딩하려는 그린필드 iOS SwiftUI 앱
  • 작업을 완료하기 전에 Codex가 스킴, 시뮬레이터 출력, 스크린샷 또는 UI 자동화를 확인해야 하는 기존 iPhone 및 iPad 프로젝트
  • Xcode GUI에 의존하지 않고 장시간 실행되는 iOS UI 작업을 에이전트 방식과 CLI 중심으로 유지하려는 팀

Contents

    ← 모든 사용 사례

    iOS 앱 빌드하기

    Codex로 iPhone 및 iPad용 SwiftUI 앱을 스캐폴딩하고 빌드하며 디버그하세요.

    Codex로 iOS SwiftUI 프로젝트를 스캐폴딩하고, xcodebuild 또는 Tuist를 사용해 빌드 루프를 CLI 중심으로 유지하며, 작업이 심화되면 XcodeBuildMCP나 특화된 SwiftUI 스킬을 추가하세요.

    고급
    1시간

    Codex로 iOS SwiftUI 프로젝트를 스캐폴딩하고, xcodebuild 또는 Tuist를 사용해 빌드 루프를 CLI 중심으로 유지하며, 작업이 심화되면 XcodeBuildMCP나 특화된 SwiftUI 스킬을 추가하세요.

    고급
    1시간

    적합한 대상

    • Codex로 앱과 빌드 루프를 처음부터 스캐폴딩하려는 그린필드 iOS SwiftUI 앱
    • 작업을 완료하기 전에 Codex가 스킴, 시뮬레이터 출력, 스크린샷 또는 UI 자동화를 확인해야 하는 기존 iPhone 및 iPad 프로젝트
    • Xcode GUI에 의존하지 않고 장시간 실행되는 iOS UI 작업을 에이전트 방식과 CLI 중심으로 유지하려는 팀

    스킬 및 플러그인

    • SwiftUI 기반 UI를 구축하거나 리팩터링하고, Liquid Glass 같은 최신 iOS 패턴을 도입하며, 런타임 성능을 점검하고, XcodeBuildMCP 기반 워크플로우로 시뮬레이터에서 앱을 디버그합니다.
    Skill Why use it
    Build iOS Apps SwiftUI 기반 UI를 구축하거나 리팩터링하고, Liquid Glass 같은 최신 iOS 패턴을 도입하며, 런타임 성능을 점검하고, XcodeBuildMCP 기반 워크플로우로 시뮬레이터에서 앱을 디버그합니다.

    시작 프롬프트

    스타터 SwiftUI 앱을 스캐폴딩하고 로컬 환경의 `Build` 작업에 연결할 수 있는 빌드 및 실행 스크립트를 추가해 주세요. 제약 조건: - CLI 중심으로 작업하세요. Apple의 `xcodebuild`를 우선 사용하고, 구성을 더 깔끔하게 만드는 데 도움이 된다면 Tuist를 사용해도 됩니다. - 이 레포지토리에 완전한 Xcode 프로젝트가 이미 있다면 XcodeBuildMCP를 사용해 타깃을 나열하고, 올바른 스킴을 선택하고, 앱을 빌드 및 실행하며, 반복 개선하면서 스크린샷을 캡처하세요. - 기존 모델, 내비게이션 패턴 및 공유 유틸리티가 이미 있다면 재사용하세요. - 공유 Apple 플랫폼 구현을 명시적으로 요청하지 않는 한 앱의 범위를 iPhone과 iPad로 제한하세요. - 각 변경 후에는 범위가 작고 신뢰할 수 있는 검증 루프를 사용하고, 좁은 범위의 검사를 통과한 경우에만 더 광범위한 빌드로 확장하세요. - 그린필드 스캐폴딩으로 처리했는지, 기존 프로젝트 변경으로 처리했는지 알려 주세요. 제공할 결과: - 앱 스캐폴드 또는 요청한 기능 단위 - 정확한 명령이 포함된 간단한 빌드 및 실행 스크립트 - 실행한 최소 범위의 관련 검증 단계 - 사용한 정확한 스킴, 시뮬레이터 및 검사 항목
    스타터 SwiftUI 앱을 스캐폴딩하고 로컬 환경의 `Build` 작업에 연결할 수 있는 빌드 및 실행 스크립트를 추가해 주세요. 제약 조건: - CLI 중심으로 작업하세요. Apple의 `xcodebuild`를 우선 사용하고, 구성을 더 깔끔하게 만드는 데 도움이 된다면 Tuist를 사용해도 됩니다. - 이 레포지토리에 완전한 Xcode 프로젝트가 이미 있다면 XcodeBuildMCP를 사용해 타깃을 나열하고, 올바른 스킴을 선택하고, 앱을 빌드 및 실행하며, 반복 개선하면서 스크린샷을 캡처하세요. - 기존 모델, 내비게이션 패턴 및 공유 유틸리티가 이미 있다면 재사용하세요. - 공유 Apple 플랫폼 구현을 명시적으로 요청하지 않는 한 앱의 범위를 iPhone과 iPad로 제한하세요. - 각 변경 후에는 범위가 작고 신뢰할 수 있는 검증 루프를 사용하고, 좁은 범위의 검사를 통과한 경우에만 더 광범위한 빌드로 확장하세요. - 그린필드 스캐폴딩으로 처리했는지, 기존 프로젝트 변경으로 처리했는지 알려 주세요. 제공할 결과: - 앱 스캐폴드 또는 요청한 기능 단위 - 정확한 명령이 포함된 간단한 빌드 및 실행 스크립트 - 실행한 최소 범위의 관련 검증 단계 - 사용한 정확한 스킴, 시뮬레이터 및 검사 항목

    앱과 빌드 루프 스캐폴딩

    그린필드 작업은 일반 프롬프팅으로 시작하세요. Codex에 스타터 iOS SwiftUI 앱을 스캐폴딩하고 로컬 환경Build 작업에 연결할 수 있는 간단한 빌드 및 실행 스크립트를 작성하도록 요청하세요.

    루프를 CLI 중심으로 유지하세요. Apple의 xcodebuild를 사용하면 터미널에서 스킴을 나열하고 빌드, 테스트, 아카이브, build-for-testing, test-without-building 작업을 처리할 수 있으므로 Codex가 Xcode GUI를 오가지 않고 에이전트 루프 안에서 계속 작업할 수 있습니다.

    더 깔끔한 프로젝트 생성기를 원하고 서드 파티 도구를 사용해도 괜찮다면 다음 단계로 Tuist를 사용하는 것이 좋습니다. GUI 없이 Xcode 프로젝트를 생성하고 빌드할 수 있으며, Codex는 터미널에서 계속 앱을 빌드하고 실행할 수 있습니다.

    완전한 Xcode 프로젝트에서 더 심층적인 자동화가 필요해지면 XcodeBuildMCP를 사용하세요. 스킴, 타깃, 시뮬레이터 제어, 스크린샷, 로그 및 UI 상호작용이 중요해져 단순한 셸 명령만으로는 충분하지 않은 시점입니다.

    스킬 활용하기

    첫 단계에서는 스킬이나 MCP 서버가 필요하지 않은 경우가 많습니다. 작업이 전문화되거나 실행 과정에 더 탄탄한 SwiftUI 규칙을 반영하려는 경우 스킬을 추가하세요.

    • SwiftUI expert는 다양한 모범 사례가 이미 반영된 강력한 범용 SwiftUI 스킬입니다.

    • SwiftUI Pro는 최신 API, 유지보수성, 접근성 및 성능을 폭넓게 검토하는 SwiftUI 스킬입니다.

    • Liquid Glass expert는 Codex가 새로운 iOS 26 Liquid Glass API를 도입하고 최신 시스템 디자인에 맞게 사용자 지정 컴포넌트를 조정하도록 돕습니다.

    • SwiftUI performance는 기능이 느리게 느껴지거나 SwiftUI 뷰 업데이트 경로가 의심스러울 때 유용합니다. 일반적인 SwiftUI 실수를 검사하고 수정할 항목과 성능 향상 폭이 가장 큰 지점을 우선순위별 보고서로 제공합니다.

    • Swift concurrency expert는 이해하기 어려운 오류와 컴파일러 경고가 원하는 변경을 가로막을 때 유용합니다. GPT-5.6 Terra에서는 필요성이 줄어들 수 있지만 Swift 동시성 진단 메시지가 복잡해질 때는 여전히 유용합니다.

    • SwiftUI view refactor는 파일 크기를 줄이고 레포지토리 전반에서 SwiftUI 코드의 일관성을 높이는 데 도움이 됩니다.

    • SwiftUI patterns 스킬을 활용하면 앱이 커져도 예측 가능한 @Observable@Environment 아키텍처 패턴을 적용할 수 있습니다.

    스킬 설치 및 사용 방법에 대한 자세한 내용은 스킬 문서를 참고하세요.

    반복 개선하기

    초기 구현이 작동하기 시작했거나 기존 프로젝트에서 시작한다면 UI 또는 동작을 반복해서 개선할 수 있습니다.

    이 단계에서는 무엇을 어떻게 변경할지 구체적으로 설명하세요.

    프롬프트에 이런 정보를 명시하세요. Codex가 그린필드 레포지토리와 기존 Xcode 프로젝트 중 어디에서 작업하는지, 계속 작동해야 할 iOS 기기 또는 배포 대상이 무엇인지, 어떤 검증 루프를 기대하는지 알려 주세요.

    예시 프롬프트

    예를 들어 기존 앱에 기능을 추가하려면 Codex에 다음과 같은 변경을 요청할 수 있습니다:

    이 SwiftUI 앱에 온보딩 플로우를 추가해 주세요. 제약 조건: - 기존 모델, 내비게이션 패턴 및 공유 유틸리티를 재사용하세요. - XcodeBuildMCP를 사용해 올바른 타깃이나 스킴을 나열하고 앱을 빌드 및 실행하며, 시각적 검증이 필요하면 스크린샷을 캡처하세요. - 공유 iOS/macOS 추상화를 명시적으로 요청하지 않는 한 구현 범위를 iPhone과 iPad로 제한하세요. - 사용한 정확한 스킴, 시뮬레이터 및 검사 항목을 알려 주세요. 해당 기능 단위를 구현하고 관련성이 가장 높은 최소 범위의 빌드 또는 실행 루프로 검증한 다음, 변경 사항을 요약해 주세요.

    실용적인 팁

    기본부터 시작하기

    그린필드 작업은 일반 프롬프팅으로 시작하세요. Codex에 스타터 SwiftUI 앱을 스캐폴딩하고 로컬 환경Build 작업에 연결할 수 있는 간단한 빌드 및 실행 스크립트를 작성하도록 요청하세요. 이 첫 단계에서는 스킬이나 MCP 서버가 필요하지 않은 경우가 많습니다.

    작고 신뢰할 수 있는 검증 루프 사용하기

    각 변경 후에는 변경한 계약을 실제로 검증할 수 있는 가장 좁은 범위의 명령을 실행하도록 Codex에 지시하세요. 더 광범위한 빌드는 나중에 실행하세요. 이렇게 하면 모든 수정에 전체 앱 빌드가 필요한 것처럼 가정하지 않으면서도 Codex의 작업 속도를 유지할 수 있습니다.

    루프를 CLI 중심으로 유지하기

    루프는 CLI 중심으로 유지하세요. Apple의 xcodebuild 도구를 사용하면 스킴 목록을 확인하고 터미널에서 빌드, 테스트, 아카이브, build-for-testing, test-without-building 작업을 실행할 수 있습니다. 이를 통해 Codex는 Xcode GUI를 오가지 않고 에이전트 루프 안에서 계속 작업할 수 있습니다.

    XcodeBuildMCP 활용하기

    전체 Xcode 프로젝트에서 작업하면서 더 심층적인 자동화가 필요해지면 바로 XcodeBuildMCP를 사용하세요. 스킴, 타깃, 시뮬레이터 제어, 스크린샷, 로그, UI 조작이 중요해져 단순한 셸 명령만으로는 충분하지 않게 되는 시점입니다.

    Tech stack

    Need

    UI 프레임워크

    Default options

    SwiftUI

    Why it's needed

    UI 코드를 읽기 쉽게 유지하면서 iPhone과 iPad용 뷰, 내비게이션 및 공유 상태를 프로토타이핑하는 가장 빠른 방법입니다.

    Need

    빌드 도구

    Default options

    xcodebuild 또는 Tuist

    Why it's needed

    둘 다 Xcode GUI에 의존하지 않고 터미널에서 네이티브 빌드 루프를 유지합니다.

    Need

    프로젝트 자동화

    Default options

    XcodeBuildMCP

    Why it's needed

    Codex가 스킴과 타깃을 검사하고, 앱을 실행하고, 스크린샷을 캡처하며, 에이전트 루프를 벗어나지 않고 반복 개선해야 할 때 효과적인 선택입니다.

    Need

    배포 도구

    Default options

    App Store Connect CLI

    Why it's needed

    에이전트가 전체 과정에 계속 참여하도록 하고 앱 빌드를 App Store로 직접 전송합니다.

    Need Default options Why it's needed
    UI 프레임워크 SwiftUI UI 코드를 읽기 쉽게 유지하면서 iPhone과 iPad용 뷰, 내비게이션 및 공유 상태를 프로토타이핑하는 가장 빠른 방법입니다.
    빌드 도구 xcodebuild 또는 Tuist 둘 다 Xcode GUI에 의존하지 않고 터미널에서 네이티브 빌드 루프를 유지합니다.
    프로젝트 자동화 XcodeBuildMCP Codex가 스킴과 타깃을 검사하고, 앱을 실행하고, 스크린샷을 캡처하며, 에이전트 루프를 벗어나지 않고 반복 개선해야 할 때 효과적인 선택입니다.
    배포 도구 App Store Connect CLI 에이전트가 전체 과정에 계속 참여하도록 하고 앱 빌드를 App Store로 직접 전송합니다.

    관련 사용 사례