Codex로 앱 만들기: 초보자를 위한 시작 가이드

Codex로 모바일 앱을 만들 수 있나요?

네, 만들 수 있어요. OpenAI의 프로그래밍 에이전트인 Codex는 프로젝트를 읽고, 파일을 수정하고, 명령어를 실행하면서 앱 개발을 도와줘요. iPhone 앱이라면 React Native와 Expo 프로젝트에서 Codex를 쓰고, 결과를 내 휴대폰에서 테스트할 수 있어요.

Codex가 하는 일은 코드 작업이에요. iPhone에서 화면이 제대로 보이는지, 배포 가능한 버전으로 빌드되는지, Apple 제출이 되는지는 따로 확인해야 해요. 이 가이드에서는 계정이나 결제를 붙이기 전에, 간단한 기능 하나로 첫 흐름을 따라가 볼게요.

1. 시작하기 좋게 아이디어를 작게 줄이기

뭔가 설치하기 전에 세 줄을 먼저 써 보세요.

• 사용자: 이 앱이 누구에게 도움이 되는지.
• 행동: 첫 버전에서 사용자가 할 수 있어야 하는 것.
• 확인 방법: 그 행동이 제대로 작동하는지 어떻게 알 수 있는지.

여기서 쓰는 가상의 예시: 등산객이 배낭에 넣을 물건을 목록에 추가하고 체크해요. 첫 버전에는 지도도 소셜 네트워크도 없어요.

아직 설명이 "AI가 들어간 멋진 앱" 수준이라면, 앱 아이디어 찾기 가이드에서 더 구체적인 출발점을 잡을 수 있어요. 그다음에 한 페이지 기획서를 활용하면 돼요.

2. 모바일 프로젝트를 만들고 첫 화면 띄우기

이 과정을 따라 하려면 Expo가 권장하는 버전의 Node.js, 코드 에디터, 테스트 환경을 준비하세요. Expo 공식 프로젝트 생성 가이드를 따라가면 돼요. 현재 명령어와 Expo Go 호환성 관련 주의사항이 나와 있어요.

Codex에게 기능을 요청하기 전에 기본 프로젝트부터 화면에 띄워 보세요. 빈 프로젝트조차 실행되지 않으면, 나중에 오류가 났을 때 설치 문제인지 생성된 코드 문제인지 구분하기 어려워요.

Expo Go에서는 그 환경이 지원하는 기능을 테스트할 수 있어요. Expo Go에 포함되지 않은 네이티브 코드를 추가하면 다른 테스트 환경이 필요할 수 있고, 그 코드는 업로드할 때 Apple의 검사를 거쳐요. 비공개 API에 대한 ITMS-90338이 그 예예요. 이 미리보기를 App Store용 최종 버전과 헷갈리지 마세요. 이 도구들의 역할은 React Native와 Expo 가이드에서 설명해요.

3. Codex에게 올바른 폴더 열어 주기

데스크톱 앱, 터미널, 에디터 확장 중 편한 걸 고르세요. 사용 가능한 옵션과 로그인 방법은 OpenAI 공식 시작 가이드에 나와 있어요.

데스크톱 앱에서는 앱 폴더를 열고 개발 작업용으로 Codex를 선택하세요. 터미널에서는 공식 문서에 따라 CLI를 설치한 뒤, 같은 폴더로 이동해서 에이전트를 실행하세요.

cd mon-app
codex

여기서 mon-app은 내 폴더 이름을 뜻해요. 아무 디렉터리에서나 명령어를 복사해 실행하지 말고 폴더 이름을 확인하세요. 프로젝트 폴더만으로 충분하다면 컴퓨터 전체를 열어 주지 마세요.

첫 요청은 읽기 전용으로 해도 돼요.

파일은 수정하지 말고 이 프로젝트를 읽어 줘.
화면, 내비게이션, 데이터가 어디에
있는지 설명해 줘.
앱을 실행하고 검사할 때 쓸 수 있는
명령어를 알려 줘.
나는 초보자야. 네가 쓰는 기술 용어도
설명해 줘.

4. 기능 하나를 만들고 결과 확인하기

범위를 좁혀서 변경을 요청하세요.

등산 배낭을 준비하는 화면을 추가해 줘.
사용자는 물건 이름을 입력하고,
목록에 추가하고, 체크할 수 있어.
프로젝트의 기존 규칙을 따르고
로컬 데이터를 사용해 줘.
계정, 서버, 결제는 만들지 마.
먼저 계획을 설명하고, 그다음 수정한
파일 목록을 알려 줘.
프로젝트에 있는 기존 명령어로
검사해 줘.
내 휴대폰에서 테스트할 동작을
알려 줘.

변경이 끝나면 수정된 파일을 보고 앱을 띄워 보세요. 에이전트가 왜 서비스를 추가했는지, 왜 프로젝트의 큰 부분을 갈아엎었는지 이해가 안 되면 설명을 요청하세요.

물건 추가, 빈 입력, 체크, 키보드 열림을 테스트하세요. 작은 화면에서도 버튼에 손이 닿아야 해요. 기술 명령어가 성공했다고 해서 이 흐름을 실제로 쓸 수 있다는 증거가 되지는 않아요.

5. 구체적인 관찰로 수정하기

"안 돼요"라고만 하면 가능성이 너무 많아요. 내가 한 행동, 기대한 결과, 실제로 일어난 일을 설명하세요.

iPhone에서 "물병"을 추가한 다음 앱을
닫았다가 다시 열었어.
목록이 비어 있어. 앱을 다시 열어도
물건이 남아 있으면 좋겠어.
이 프로젝트에서 가장 간단한 수정 방법을
제안해 줘.
저장과 물건 삭제를 어떻게 확인하는지
알려 줘.

도움이 되는 스크린샷이나 오류 메시지를 첨부하되, 개인 정보나 비밀 키는 빼세요. 수정이 여러 번 실패하면 다시 시도하기 전에 Codex에게 관찰된 원인을 설명해 달라고 하세요. 작동하는 버전은 저장해 두고 언제든 되돌아갈 수 있게 하세요.

6. 프로토타입에서 배포 가능한 앱으로 넘어가기

핵심 기능이 쓸 만해지면, 다음 선택은 필요에 따라 달라져요. 로컬 데이터냐 동기화냐, 로그인 필수냐 선택이냐, 무료냐 구독이냐.

뭔가 추가할 때마다 확인할 게 새로 생겨요. 계정을 넣으면 사용자마다 자기 데이터에만 접근하는지 테스트해야 해요. 구독을 넣으면 구매, 복원, 만료 후 접근을 테스트해야 해요. 유료 API를 쓰는 기능이라면 호출이 어디서 실행되는지, 사용료를 누가 내는지 이해해야 해요.

이 단계로 가기 전에 AI로 만든 iOS 앱의 함정을 읽어 보세요. 테스트 버전을 배포하려면 TestFlight 가이드를 참고하세요. 출시는 App Store 가이드를 따라가면 돼요.

자주 묻는 질문

Codex가 내 앱에 AI 기능을 자동으로 넣나요?

아니요. AI로 코드를 작성한다고 해서 최종 앱에 챗봇이 들어가거나 모델을 호출하는 건 아니에요. 이 예시도 제품 안에 AI 없이 로컬 목록만으로 작동해요.

모든 도구를 구독하지 않고 시작할 수 있나요?

현재 OpenAI 요금제에서 내 계정의 이용 범위와 한도를 확인하세요. 서비스를 늘리기 전에 기능 하나로 시작하세요. 무료로 앱 만들기 가이드에서 프로토타입 비용과 출시 비용을 구분해 설명해요.

처음 시작한다면 Codex와 Claude Code 중 뭐가 좋을까요?

속도에 대한 약속보다는 내가 실제로 따라갈 수 있는 흐름을 비교해 보세요. Codex와 Claude Code 비교에서 둘 다 똑같이 해 볼 수 있는 과제를 제안해요.

다음에 뭘 만들지 알고 싶나요?

무료 진단은 내 프로젝트가 어디쯤 와 있는지 파악하고 다음 단계를 고르도록 도와주고, 제 Apple 리젝 방지 체크리스트도 보내 드려요. iOS Kit에는 제 앱들의 시작 코드와 아이디어부터 App Store까지 이어지는 4단계 과정이 들어 있어요. 전체 방법이 궁금하다면 iOS 앱 개발 교육 과정을 확인해 보세요. AI로 개발하고 있다면 바이브 코딩 교육 페이지도 같은 과정을 따라가요.