OPENAI / CODEX
Codex 실전
저장소를 함께 읽고, 수정하고, 검증하는 코딩 동료와 첫 결과물을 완성하세요.
8개 단원 · 실습 약 4시간
Codex 작성 · 공식 OpenAI 문서 확인 2026-09-12
예상 시간은 학습 안내용입니다. 명령과 기능 제공 범위는 자신의 프로젝트·계정에서 확인하세요.
1첫 작업: 코드 지도로 시작하기
학습 목표
수정하기 전에 프로젝트의 진입점과 검증 방법을 파악합니다.
핵심 개념
Codex와 작업할 때는 저장소에 담긴 실제 정보를 출발점으로 삼으세요. 처음에는 화면이나 기능 하나를 정하고 요청이 어떤 파일을 거치는지 읽도록 합니다. 언어나 프레임워크 이름만으로 구조를 추측하지 않게 하고, 찾은 파일과 근거를 요구하세요. 이 실습에서는 실행 가능한 작은 프로젝트를 사용합니다.
직접 해 보기
자신의 프로젝트를 열고 주요 진입점, 요청 처리 흐름, 테스트 명령을 확인하세요. 모르는 항목은 확인할 파일을 기록하세요.
실습 요청 예시
이 저장소에서 로그인 요청이 처리되는 흐름을 읽어 줘. 진입점, 주요 파일, 데이터 접근, 검증 명령을 근거 파일과 함께 설명해 줘. 아직 코드는 수정하지 마.
완료 기준
파일 경로로 확인 가능한 코드 지도와 실행할 검증 명령을 확보했습니다.
공식 참고 자료
2작은 버그 하나를 끝까지 고치기
학습 목표
재현 조건, 수정, 검증을 하나의 작업으로 연결합니다.
핵심 개념
좋은 첫 과제는 실패를 관찰할 수 있고 범위가 작은 버그입니다. 현재 동작과 기대 동작, 재현 입력을 주고 수정 이유와 검증 결과까지 요청하세요. 변경된 파일을 직접 읽고 요구하지 않은 동작이 달라졌는지 확인합니다. 도구가 실행되지 않았으면 실제 테스트와 추론에 의한 검토를 구분해야 합니다.
직접 해 보기
빈 입력 처리나 경계값 문제 하나를 골라 재현한 뒤 Codex와 수정하세요. 실패했던 입력이 통과하는지 확인하세요.
실습 요청 예시
입력이 공백뿐일 때 저장 버튼이 성공을 표시하는 버그를 고쳐 줘. 먼저 재현 경로를 확인하고, 빈 문자열과 공백 입력을 모두 처리해 줘. 변경 이유와 실제 실행한 검증 결과를 보고해 줘.
완료 기준
수정 전 실패 조건과 수정 후 검증 결과, 변경 diff를 남겼습니다.
3AGENTS.md로 팀의 기준 전달하기
학습 목표
프로젝트에 지속적으로 적용할 지침을 간결하게 작성합니다.
핵심 개념
AGENTS.md에는 저장소 작업에 필요한 명령과 규칙을 정리합니다. 공식 문서는 전역 지침과 프로젝트 경로의 지침이 합쳐지는 구조를 설명합니다. 실습에서는 프로젝트 루트에 실제로 유효한 빌드 명령, 확인할 문서, 수정 시 지켜야 할 규칙을 적으세요. 모호하거나 서로 충돌하는 규칙은 줄입니다.
직접 해 보기
프로젝트용 AGENTS.md 초안을 만들고 새 작업에서 읽힌 지침과 검증 명령이 맞는지 확인하세요.
실습 요청 예시
이 프로젝트의 실제 스크립트와 문서를 읽고 AGENTS.md 초안을 작성해 줘. 설치·실행·검증 명령, 코드 관례, 수정 전 확인할 파일을 포함하되 확인되지 않은 명령은 넣지 마.
완료 기준
실제 저장소와 맞는 지침 파일을 만들고 적용 범위를 확인했습니다.
4리뷰를 실행 가능한 피드백으로
학습 목표
스타일 의견보다 동작 오류와 회귀 위험을 먼저 검토합니다.
핵심 개념
리뷰 요청에는 변경 목적과 확인하고 싶은 위험을 함께 제공하세요. 재현 조건이 있는 오류, 데이터 접근 범위, 예외 처리, 기존 동작의 회귀를 먼저 확인하도록 합니다. 지적을 받으면 근거 파일과 입력 사례를 읽고 실제로 문제가 되는지 검증합니다. 수정이 필요 없는 취향 차이는 분리해 판단하세요.
직접 해 보기
앞서 만든 변경 diff를 리뷰하고, 발견 사항 하나를 재현하거나 근거가 부족함을 확인하세요.
실습 요청 예시
이 diff가 목적을 충족하는지 리뷰해 줘. 동작 오류와 회귀 가능성을 우선하고, 각 발견에 파일 위치, 발생 조건, 영향과 확인 방법을 적어 줘. 문제가 없으면 검토한 범위와 남은 불확실성을 알려 줘.
완료 기준
재현 가능성이 확인된 발견 사항과 수정·보류 판단을 기록했습니다.
5스킬로 반복 작업 묶기
학습 목표
반복 절차를 재사용 가능한 스킬로 정리합니다.
핵심 개념
스킬은 특정 작업의 지침과 자료, 필요한 경우 스크립트를 묶는 방식입니다. 공식 문서는 SKILL.md를 포함한 스킬 구성을 설명합니다. 모든 작업에 적용되는 거대한 스킬보다 명확한 입력과 결과를 가진 작은 절차로 시작하세요. 이 단원에서는 릴리스 노트 초안 작성 절차를 설계합니다.
직접 해 보기
변경 목록에서 릴리스 노트 초안을 만드는 스킬을 작성하고 두 가지 다른 변경 목록으로 확인하세요.
실습 요청 예시
릴리스 노트 초안을 만드는 스킬을 만들어 줘. 입력은 diff와 변경 목적이고, 출력은 사용자에게 달라진 동작과 검증 내용이야. 실행 조건과 제외할 작업을 명확하게 적고, 실제 배포는 포함하지 마.
완료 기준
언제 쓰는지 분명하고 두 입력 사례로 확인한 스킬을 만들었습니다.
공식 참고 자료
6작업을 나누고 Worktree로 분리하기
학습 목표
독립적으로 진행할 작업과 함께 수정해야 할 작업을 구분합니다.
핵심 개념
Git worktree는 같은 저장소의 별도 체크아웃에서 작업하는 방법입니다. 공식 문서는 여러 독립 작업을 서로 간섭하지 않게 진행하는 용도를 설명합니다. 분리된 작업이라도 같은 인터페이스를 바꾸면 통합 시 충돌할 수 있습니다. 맡길 범위와 수정할 파일, 산출물, 합칠 순서를 먼저 정하세요.
직접 해 보기
문서 개선과 버그 수정을 별도 작업으로 나누고, 공유하는 파일이 있는지 확인하세요. Git 프로젝트에서 별도 작업 공간을 사용해 diff를 각각 검토하세요.
실습 요청 예시
이 두 작업을 독립적으로 진행할 수 있는지 판단해 줘. 공유 파일과 의존성을 확인하고, 분리 가능한 경우 작업 범위와 통합 검증 순서를 제안해 줘.
완료 기준
각 작업의 경계와 결과를 합친 뒤 실행할 검증 항목을 기록했습니다.
공식 참고 자료
7반복 점검을 예약 작업으로 준비하기
학습 목표
자동화하기 전에 수동 실행으로 결과와 권한을 검증합니다.
핵심 개념
공식 문서는 예약 작업을 통해 반복 점검을 실행하고 결과를 검토하는 흐름을 안내합니다. 로컬 파일을 쓰는 데스크톱 작업은 컴퓨터와 앱의 실행 상태가 필요하며, 실행 환경에 따라 사용할 수 있는 기능이 다릅니다. 먼저 수동으로 유용한 결과가 나오는지 확인한 뒤 대상, 주기, 권한과 종료 조건을 정하세요.
직접 해 보기
최근 변경의 문서 누락을 찾는 읽기 전용 점검 요청을 수동 실행하고, 결과 형식과 주기를 문서화하세요. 이 실습만으로 예약 작업이 생성되지는 않습니다.
실습 요청 예시
최근 변경과 문서를 비교해 문서 업데이트가 필요한 항목의 초안을 만들어 줘. 파일을 수정하거나 외부에 게시하지 말고, 근거 경로와 제안할 변경을 정리해 줘.
완료 기준
수동 실행 결과를 확인하고 예약 실행에 필요한 환경과 권한을 기록했습니다.
공식 참고 자료
8최종 프로젝트: 작은 기능을 출시 가능한 상태로
학습 목표
명세, 구현, 검증, 리뷰와 인계를 하나로 완성합니다.
핵심 개념
마지막 과제는 도구 하나의 기능 개선입니다. 예를 들어 색상 복사, 입력 검증, 작은 화면 대응을 함께 다룹니다. 요구사항을 먼저 적고 단계별로 변경을 확인하세요. 결과 보고에는 바뀐 사용자 동작, 실행한 검증, 미완료 범위를 명시합니다. 코드 완성과 실제 배포는 각각 확인해야 합니다.
직접 해 보기
자신의 프로젝트에서 작은 개선 하나를 완성하고, LLM 라운지에 제품·모델·확인 날짜·재현 절차를 포함한 활용기를 작성하세요.
실습 요청 예시
이 기능을 요구사항부터 검증까지 완성해 줘. 완료 기준은 정상 입력, 잘못된 입력 안내, 키보드 사용, 모바일 화면이야. 최종 보고에 실제 수정과 검사 결과, 남은 작업을 구분해 줘.
완료 기준
검토 가능한 diff, 실제 검증 결과, 사용자 관점의 변경 설명을 완성했습니다.
사용한 제품·모델과 실습 결과를 라운지에 기록해 보세요.
실습 후기 작성하기 →