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

Codex use case

iOS 시뮬레이터에서 디버깅하기

Codex와 XcodeBuildMCP로 iOS 시뮬레이터에서 앱을 직접 조작해 버그의 단서를 모으고, 코드를 수정해 가며 결과를 확인하세요.

Difficulty Advanced
Time horizon 1h

Codex로 적절한 Xcode 스킴과 시뮬레이터를 찾아 앱을 실행하세요. Codex는 UI 트리를 확인하고 탭, 텍스트 입력, 스와이프로 버그를 재현합니다. 버그 보고서가 모호해도 스크린샷과 로그를 수집하고 필요하면 LLDB를 연결해 원인을 좁힌 뒤, 최소한의 코드 수정으로 문제가 해결됐는지 검증할 수 있습니다.

Best for

  • 시뮬레이터에서 특정 순서로 탭하거나 스크롤하거나 폼에 입력해야만 나타나는 UI 버그
  • Codex가 코드를 수정하기 전에 로그, 스크린샷, 뷰 계층 구조의 상태, 디버거 백트레이스를 확인해야 하는 앱 충돌, 멈춤 또는 화면 전환 오류
  • 사람이 일일이 클릭해 각 상태를 확인하는 대신 버그 재현부터 수정과 검증까지 Codex에 맡기고 싶은 팀

Contents

    ← All use cases

    iOS 시뮬레이터에서 디버깅하기

    Codex와 XcodeBuildMCP로 iOS 시뮬레이터에서 앱을 직접 조작해 버그의 단서를 모으고, 코드를 수정해 가며 결과를 확인하세요.

    Codex로 적절한 Xcode 스킴과 시뮬레이터를 찾아 앱을 실행하세요. Codex는 UI 트리를 확인하고 탭, 텍스트 입력, 스와이프로 버그를 재현합니다. 버그 보고서가 모호해도 스크린샷과 로그를 수집하고 필요하면 LLDB를 연결해 원인을 좁힌 뒤, 최소한의 코드 수정으로 문제가 해결됐는지 검증할 수 있습니다.

    Advanced
    1h

    Codex로 적절한 Xcode 스킴과 시뮬레이터를 찾아 앱을 실행하세요. Codex는 UI 트리를 확인하고 탭, 텍스트 입력, 스와이프로 버그를 재현합니다. 버그 보고서가 모호해도 스크린샷과 로그를 수집하고 필요하면 LLDB를 연결해 원인을 좁힌 뒤, 최소한의 코드 수정으로 문제가 해결됐는지 검증할 수 있습니다.

    Advanced
    1h

    Best for

    • 시뮬레이터에서 특정 순서로 탭하거나 스크롤하거나 폼에 입력해야만 나타나는 UI 버그
    • Codex가 코드를 수정하기 전에 로그, 스크린샷, 뷰 계층 구조의 상태, 디버거 백트레이스를 확인해야 하는 앱 충돌, 멈춤 또는 화면 전환 오류
    • 사람이 일일이 클릭해 각 상태를 확인하는 대신 버그 재현부터 수정과 검증까지 Codex에 맡기고 싶은 팀

    Skills & Plugins

    • iOS 디버거 에이전트와 XcodeBuildMCP로 시뮬레이터에서 앱을 빌드하고 실행한 뒤, 앱 상태를 확인하고 직접 조작하세요. Codex가 버그의 원인을 좁혀 가는 동안 로그, 스크린샷, 스택 트레이스를 수집하세요.
    Skill Why use it
    Build iOS Apps iOS 디버거 에이전트와 XcodeBuildMCP로 시뮬레이터에서 앱을 빌드하고 실행한 뒤, 앱 상태를 확인하고 직접 조작하세요. Codex가 버그의 원인을 좁혀 가는 동안 로그, 스크린샷, 스택 트레이스를 수집하세요.

    Starter prompt

    Build iOS Apps 플러그인과 XcodeBuildMCP를 사용해 시뮬레이터에서 이 버그를 직접 재현하고, 근본 원인을 찾아 최소한의 코드 수정으로 해결해 주세요. 버그 보고서 [기대한 동작과 실제로 발생한 문제를 설명하고, 재현에 필요한 화면이나 계정 설정을 알고 있다면 함께 적어 주세요.] 제약 조건 - 먼저 프로젝트, 스킴, 시뮬레이터가 이미 선택되어 있는지 확인해 주세요. 아직 설정되지 않았다면 적절한 Xcode 프로젝트나 워크스페이스를 찾고 앱 스킴과 시뮬레이터를 선택해 주세요. 이후 세션 내내 같은 설정을 사용해 주세요. - 앱을 빌드해 시뮬레이터에서 실행한 뒤, 조작을 시작하기 전에 UI 스냅샷이나 스크린샷으로 원하는 화면이 표시되는지 확인해 주세요. - 시뮬레이터에서 직접 탭, 텍스트 입력, 스크롤, 스와이프로 재현 절차를 정확히 따라 주세요. 좌표를 직접 지정하기보다는 접근성 레이블이나 ID를 우선 사용하고, 레이아웃이 바뀌면 다음 조작 전에 UI 계층 구조를 다시 확인해 주세요. - 디버깅하면서 화면 상태를 보여 주는 스크린샷과 문제가 발생한 시점 전후의 시뮬레이터 로그를 수집해 주세요. 앱이 충돌하거나 멈춘 것으로 보이면 LLDB에서 스택 프레임이나 변수 값도 기록해 주세요. - 시뮬레이터가 아직 부팅되지 않았다면 하나를 부팅하고 어떤 기기와 OS를 선택했는지 알려 주세요. 인증 정보나 특정 테스트 픽스처가 필요하면 잠시 멈추고 빠진 항목만 요청해 주세요. - 버그를 해결하는 데 필요한 만큼만 코드를 수정해 주세요. 그런 다음 시뮬레이터에서 같은 플로우를 다시 실행하고 수정 사항을 어떻게 검증했는지 구체적으로 알려 주세요. 결과에 포함할 내용 - Codex가 직접 수행한 재현 단계 - 버그의 원인을 파악하는 데 도움이 된 주요 스크린샷, 로그 또는 스택 정보 - 수정한 코드와 그 수정으로 문제가 해결되는 이유 - 최종 검증에 사용한 시뮬레이터와 스킴
    Build iOS Apps 플러그인과 XcodeBuildMCP를 사용해 시뮬레이터에서 이 버그를 직접 재현하고, 근본 원인을 찾아 최소한의 코드 수정으로 해결해 주세요. 버그 보고서 [기대한 동작과 실제로 발생한 문제를 설명하고, 재현에 필요한 화면이나 계정 설정을 알고 있다면 함께 적어 주세요.] 제약 조건 - 먼저 프로젝트, 스킴, 시뮬레이터가 이미 선택되어 있는지 확인해 주세요. 아직 설정되지 않았다면 적절한 Xcode 프로젝트나 워크스페이스를 찾고 앱 스킴과 시뮬레이터를 선택해 주세요. 이후 세션 내내 같은 설정을 사용해 주세요. - 앱을 빌드해 시뮬레이터에서 실행한 뒤, 조작을 시작하기 전에 UI 스냅샷이나 스크린샷으로 원하는 화면이 표시되는지 확인해 주세요. - 시뮬레이터에서 직접 탭, 텍스트 입력, 스크롤, 스와이프로 재현 절차를 정확히 따라 주세요. 좌표를 직접 지정하기보다는 접근성 레이블이나 ID를 우선 사용하고, 레이아웃이 바뀌면 다음 조작 전에 UI 계층 구조를 다시 확인해 주세요. - 디버깅하면서 화면 상태를 보여 주는 스크린샷과 문제가 발생한 시점 전후의 시뮬레이터 로그를 수집해 주세요. 앱이 충돌하거나 멈춘 것으로 보이면 LLDB에서 스택 프레임이나 변수 값도 기록해 주세요. - 시뮬레이터가 아직 부팅되지 않았다면 하나를 부팅하고 어떤 기기와 OS를 선택했는지 알려 주세요. 인증 정보나 특정 테스트 픽스처가 필요하면 잠시 멈추고 빠진 항목만 요청해 주세요. - 버그를 해결하는 데 필요한 만큼만 코드를 수정해 주세요. 그런 다음 시뮬레이터에서 같은 플로우를 다시 실행하고 수정 사항을 어떻게 검증했는지 구체적으로 알려 주세요. 결과에 포함할 내용 - Codex가 직접 수행한 재현 단계 - 버그의 원인을 파악하는 데 도움이 된 주요 스크린샷, 로그 또는 스택 정보 - 수정한 코드와 그 수정으로 문제가 해결되는 이유 - 최종 검증에 사용한 시뮬레이터와 스킴

    시뮬레이터 디버깅의 전 과정을 Codex에 맡기기

    시뮬레이터에서 버그를 디버깅할 때는 전 과정을 Codex에 맡기는 것이 가장 효과적입니다. Codex는 적절한 앱 타깃을 선택하고 Simulator에서 앱을 실행한 뒤, 현재 화면을 확인하고 재현 절차를 따릅니다. 이어서 로그와 스크린샷을 수집하고 필요하면 스택 트레이스를 살펴봅니다. 코드를 수정한 뒤에는 같은 절차를 반복해 버그가 더 이상 발생하지 않는지 확인합니다.

    Codex가 이 과정을 자율적으로 수행하도록 하려면 Build iOS Apps 플러그인을 사용하세요. 이 플러그인의 iOS 디버거 워크플로우는 XcodeBuildMCP를 기반으로 합니다. 덕분에 Codex가 부팅된 시뮬레이터를 직접 조작하고 개발자가 평소 수동으로 수집하는 자료를 확보할 수 있습니다.

    XcodeBuildMCP에 시뮬레이터 자동화, UI 자동화, 디버깅, 로깅 워크플로우를 구성하면 Codex가 버그 재현부터 디버깅과 검증까지 맡을 수 있습니다. Codex가 아직 프로젝트, 스킴, 시뮬레이터를 선택하지 않았다면 먼저 사용할 항목을 찾아 선택하고 세션이 끝날 때까지 같은 설정을 사용하도록 요청하세요.

    XcodeBuildMCP의 기능 활용하기

    Codex에 다음 기능을 활용하도록 요청할 수 있습니다.

    • 프로젝트 및 시뮬레이터 탐색: 사용할 앱 타깃과 시뮬레이터를 Codex가 이미 파악했는지 확인합니다. Xcode 프로젝트나 워크스페이스를 찾고, 사용 가능한 스킴을 나열하고, 시뮬레이터를 찾거나 부팅합니다. 이후 빌드와 실행에도 같은 설정을 사용합니다.
    • 빌드 및 실행 제어: 현재 선택한 앱 타깃을 빌드하고 시뮬레이터용 빌드를 설치해 실행합니다. 필요하면 앱을 다시 실행하면서 로그를 수집합니다. 특정 앱의 런타임 로그를 살펴봐야 할 때는 해당 앱의 번들 ID를 확인합니다.
    • UI 검사 및 조작: 현재 화면의 접근성 계층 구조를 확인하고 스크린샷을 찍습니다. 컨트롤을 탭하고 입력 필드에 텍스트를 입력하거나 목록을 스크롤합니다. 화면 가장자리에서 스와이프하는 등 시뮬레이터에서 제스처를 수행합니다.
    • 로그 및 디버거 상태 확인: 시뮬레이터 로그를 실시간으로 확인하고 실행 중인 앱에 LLDB를 연결합니다. 중단점을 설정하고 스택 프레임과 지역 변수를 확인합니다. 앱이 비정상 종료되거나 응답하지 않아 더 자세한 조사가 필요하면 디버거 명령어를 실행합니다.

    Codex가 화면을 탭하기 전에 먼저 뷰 트리를 확인하도록 요청하는 습관을 들이세요. XcodeBuildMCP는 접근성 계층 구조와 좌표를 함께 제공합니다. 따라서 Codex는 화면 좌표를 추측할 필요 없이 안정적인 레이블이나 요소 ID를 우선 사용해 탭할 대상을 찾을 수 있습니다.

    모호한 버그 설명을 재현 스크립트로 구체화하기

    iOS 디버거 스킬을 효과적으로 활용하려면 프롬프트에 구체적인 버그 하나와 기대 결과 하나를 명시하세요. 그런 다음 Codex가 직접 앱을 조작하고 근거 자료를 수집하도록 맡기세요. 로그인, 딥 링크, 테스트 픽스처가 필요하다면 그 조건을 처음에 한 번 알려주세요. 필요한 입력이 없어 더 이상 진행할 수 없을 때만 멈추도록 요청하세요.

    실전 팁

    수정 사항과 함께 근거 요청하기

    Codex에 어떤 시뮬레이터와 스킴을 사용했는지 정확히 밝히고, 버그를 설명하는 근거로 삼은 스크린샷, 로그 발췌문, 스택 세부 정보를 보여 달라고 요청하세요. 이렇게 하면 “이렇게 수정하면 해결될 것 같습니다”라는 설명만 있을 때보다 최종 패치를 훨씬 쉽게 검토할 수 있습니다.

    좌표보다 접근성 레이블을 우선 사용하기

    컨트롤에 안정적인 레이블이나 접근성 식별자가 없어 Codex가 좌표를 기준으로 탭해야 한다면 그 사실을 명시하도록 요청하세요. 이는 버그를 수정하면서 UI도 조금 손봐 테스트하기 쉽게 만들 필요가 있다는 신호일 때가 많습니다.

    한 번에 버그 하나씩 다루기

    시뮬레이터를 활용한 디버깅은 강력한 방법이지만, 프롬프트 하나로 한 가지 오류에 집중할 때 결과를 더 신뢰하기 쉽습니다. 관련 문제로 범위를 넓히기 전에 Codex가 버그 하나를 재현하고 수정한 뒤 검증까지 마치도록 요청하세요.

    Tech stack

    Need

    시뮬레이터 자동화

    Default options

    XcodeBuildMCP

    Why it's needed

    현재 제공되는 도구로 시뮬레이터를 설정하고 앱을 빌드해 실행할 수 있습니다. UI 스냅샷 확인, 탭, 텍스트 입력, 제스처, 스크린샷 촬영, 로그 수집, 디버거 연결도 지원합니다.

    Need

    에이전트 워크플로우

    Why it's needed

    플러그인의 iOS 디버거 에이전트는 Codex가 시뮬레이터에서 먼저 버그를 재현하고 진단에 필요한 자료를 수집한 뒤, 코드를 수정할 때마다 결과를 검증하도록 안내합니다.

    Need

    앱 관측 가능성

    Default options

    Logger, OSLog, LLDB, 시뮬레이터 스크린샷

    Why it's needed

    Codex는 로그와 디버거에서 확인한 실행 상태를 바탕으로 어떤 문제가 발생했는지 설명하고, 수정 전후의 정확한 UI 상태를 스크린샷으로 남길 수 있습니다.

    Need Default options Why it's needed
    시뮬레이터 자동화 XcodeBuildMCP 현재 제공되는 도구로 시뮬레이터를 설정하고 앱을 빌드해 실행할 수 있습니다. UI 스냅샷 확인, 탭, 텍스트 입력, 제스처, 스크린샷 촬영, 로그 수집, 디버거 연결도 지원합니다.
    에이전트 워크플로우 Build iOS Apps 플러그인 플러그인의 iOS 디버거 에이전트는 Codex가 시뮬레이터에서 먼저 버그를 재현하고 진단에 필요한 자료를 수집한 뒤, 코드를 수정할 때마다 결과를 검증하도록 안내합니다.
    앱 관측 가능성 Logger , OSLog , LLDB, 시뮬레이터 스크린샷 Codex는 로그와 디버거에서 확인한 실행 상태를 바탕으로 어떤 문제가 발생했는지 설명하고, 수정 전후의 정확한 UI 상태를 스크린샷으로 남길 수 있습니다.

    Related use cases