Codex 앱 사용 매뉴얼: 설정부터 작업 맡기기까지 | DAKER 커뮤니티

Codex 앱 사용 매뉴얼: 설정부터 작업 맡기기까지

Codex 앱은 ChatGPT처럼 대화만 하는 도구가 아니라, 파일을 읽고 수정하고 명령을 실행하면서 실제 작업을 진행하는 코딩 에이전트입니다. 처음 사용할 때 가장 중요한 것은 모든 기능을 한 번에 익히는 것이 아니라, 안전한 설정으로 시작하고 작은 일을 정확히 맡기는 습관을 만드는 것입니다.

아래 매뉴얼은 초보 바이브코더가 Codex 앱을 처음 켤 때 바로 따라 할 수 있는 흐름으로 정리했습니다.

1. 처음에는 설정 네 가지만 봅니다

Codex 앱의 설정은 왼쪽 아래 메뉴에서 열 수 있습니다. 처음에는 General, Detail level, Personalization, Appearance만 확인해도 충분합니다.

설정을 많이 만지는 것보다 중요한 것은 작업이 끝났는지 확인할 수 있게 만드는 것입니다.

2. 권한은 보수적으로 시작합니다

Codex는 파일을 수정하고 테스트 명령을 실행할 수 있습니다. 그래서 처음부터 모든 권한을 자동 승인하는 방식은 추천하지 않습니다. 처음에는 읽기와 로컬 수정 중심으로 쓰고, 네트워크 접근, 패키지 설치, 배포, DB 작업처럼 영향이 큰 일은 목적을 확인한 뒤 승인하는 편이 안전합니다.

좋은 기준은 간단합니다.

반복적으로 안전하다고 확인된 명령만 프로젝트 규칙으로 자동 승인하면 됩니다. 처음부터 크게 여는 것보다, 검증된 반복 작업만 조금씩 넓히는 방식이 오래 갑니다.

3. 작업 요청은 네 줄이면 됩니다

Codex에게 일을 맡길 때는 긴 설명보다 구조가 중요합니다. 아래 네 줄을 넣으면 대부분의 작업이 훨씬 안정적입니다.

목표: 무엇을 끝내고 싶은지 한 문장으로 말합니다.
범위: 바꿔도 되는 파일과 건드리면 안 되는 파일을 적습니다.
검증: 완료를 확인할 명령이나 체크리스트를 적습니다.
보고: 변경 파일, 테스트 결과, 남은 위험만 짧게 알려달라고 합니다.

예시는 이렇게 쓸 수 있습니다.

목표: 커뮤니티 글 등록 스크립트가 Markdown 문법 노출을 막게 해줘.
범위: scripts와 HARNESS.md만 수정해줘.
검증: node --check와 공개 API 검사 스크립트를 실행해줘.
보고: 바뀐 파일, 통과한 검사, 남은 위험만 정리해줘.

이렇게 쓰면 Codex가 해야 할 일과 하지 말아야 할 일이 분명해집니다. 특히 "검증"을 적어두면 결과가 말뿐인지, 실제로 확인된 것인지 구분하기 쉬워집니다.

4. 여러 작업은 한 채팅에 몰아넣지 않습니다

Codex 앱의 장점은 여러 에이전트 작업을 프로젝트별, 스레드별로 나누어 관리할 수 있다는 점입니다. 큰 작업 하나를 한 번에 던지기보다, 서로 독립적인 일은 나누어 맡기는 편이 좋습니다.

예를 들어 "블로그 글 등록 자동화"라는 큰 목표가 있다면 다음처럼 쪼갤 수 있습니다.

각 작업은 별도 스레드나 별도 단계로 나누면 추적하기 쉽습니다. 실패했을 때도 어느 단계가 문제였는지 바로 보입니다.

5. Skills와 Automations는 두 번째 단계에서 씁니다

처음부터 Skills와 Automations를 많이 만들 필요는 없습니다. 먼저 같은 작업을 여러 번 반복해 보고, 정말 반복 패턴이 생기면 그때 Skill로 묶는 것이 좋습니다.

Skill로 만들기 좋은 작업은 다음과 같습니다.

Automations는 정기적으로 돌아야 하는 일에 어울립니다. 예를 들어 매일 아침 이슈를 정리하거나, 실패한 CI를 확인하거나, 커뮤니티 초안을 준비하는 식입니다.

6. 완료 보고를 받을 때 확인할 것

Codex가 "완료"라고 말해도 바로 믿기보다 아래 네 가지를 확인하세요.

이 네 가지가 보이면 작업을 이어받기 쉽습니다. 반대로 검증 없이 "수정했습니다"만 있다면 아직 완료가 아닙니다.

바로 쓰는 추천 프롬프트

아래 문장을 Codex 앱 첫 메시지로 저장해두면 좋습니다.

이 작업을 바로 크게 고치지 말고 먼저 관련 파일과 현재 동작을 확인해줘.
수정은 내가 지정한 범위 안에서 최소한으로 해줘.
완료 후에는 실행한 검증 명령과 결과를 짧게 정리해줘.
추측한 내용은 추측이라고 표시하고, 코드나 문서에서 확인한 내용과 분리해줘.

정리

Codex 앱은 많이 시키는 도구가 아니라, 잘 나누어 맡기는 도구입니다. 처음에는 설정을 단순하게 두고, 권한은 보수적으로 열고, 요청은 목표와 검증 기준 중심으로 작성하세요. 그 습관이 잡히면 Codex는 단순 코드 생성기를 넘어, 반복 업무와 개발 흐름을 함께 밀어주는 작업 파트너가 됩니다.

참고한 공식 자료:

Redirecting to Codex 앱 사용 매뉴얼: 설정부터 작업 맡기기까지 | DAKER 커뮤니티...