코덱스 툴 사용법 01: 작업 에이전트로 시작하기 | DAKER 커뮤니티

코덱스 툴 사용법 01: 작업 에이전트로 시작하기

코덱스는 단순히 코드 질문에 답하는 도구가 아니라, 저장소를 읽고, 파일을 수정하고, 명령을 실행하고, 결과를 검증하는 작업 에이전트다. OpenAI 공식 도움말 기준으로 Codex는 코드를 작성, 리뷰, 배포하도록 돕는 에이전트이며, 로컬 사용은 CLI, IDE 확장, 앱 로컬 워크플로우에 연결되고 클라우드 사용은 위임된 작업 실행에 연결된다.

아래 흐름만 잡아도 코덱스를 “대답하는 챗봇”이 아니라 “검증 가능한 개발 동료”처럼 쓸 수 있다.

1. 처음 요청은 작업 단위로 쓴다

나쁜 요청은 “이 프로젝트 고쳐줘”처럼 넓다. 좋은 요청은 목표, 위치, 성공 기준이 있다.

로그인 화면에서 모바일 폭일 때 버튼이 잘리는 문제를 찾아서 수정해줘.   3. 승인 모드는 위험도에 맞춘다  Codex CLI 공식 문서는 기본 제안 모드, 자동 편집, 완전 자동 같은 승인 흐름을 설명한다. 처음 보는 저장소는 읽기와 제안 중심이 낫다. 반복 리팩터링은 자동 편집이 맞고, 긴 빌드 수리나 프로토타입은 격리된 완전 자동 환경이 맞다.  중요한 기준은 “되돌릴 수 있는가”다. 데이터 삭제, 배포, 결제, 외부 메시지 발송은 자동으로 넘기지 않는다.  4. 검증 명령까지 같이 맡긴다  코덱스에게 수정만 맡기면 결과가 감으로 끝난다. 테스트 명령, 타입 검사, 린트, 브라우저 확인까지 함께 요청한다.   pnpm test
pnpm typecheck
pnpm lint   명령이 실패하면 바로 두 번째 패치를 시키지 말고, 새 로그 기준으로 원인 후보를 다시 줄이게 한다. 이 한 박자가 AI 코딩의 품질을 크게 올린다.  5. 마지막 출력은 리뷰 메모로 닫는다  작업이 끝나면 “무엇을 바꿨는지”보다 “무엇을 확인했는지”를 받아야 한다.   변경 파일, 원인, 실행한 검증, 남은 위험, 리뷰어가 먼저 볼 지점을 다섯 줄로 정리해줘.   Senior takeaway: 코덱스 사용법의 핵심은 큰 지시가 아니라 작은 작업, 근거 있는 탐색, 제한된 수정, 반복 가능한 검증이다. 이 순서가 잡히면 코덱스는 바이브코딩을 실제 개발 생산성으로 바꾸는 작업 에이전트가 된다.  참고: OpenAI Help Center의 Codex 개요와 Codex CLI 시작하기 문서. 
관련 파일을 먼저 확인하고, 가장 작은 변경만 적용해.
수정 후에는 가능한 테스트나 화면 확인 방법을 실행하고 결과를 요약해줘.

이렇게 쓰면 코덱스가 어디까지 탐색하고 어디서 멈춰야 하는지 분명해진다.

2. 저장소 탐색은 먼저 읽기 중심으로 맡긴다

처음부터 수정하게 하지 말고, 먼저 관련 파일과 흐름을 찾게 한다.

아직 파일을 수정하지 마.
결제 완료 후 알림이 발송되는 흐름을 찾아서 핵심 파일, 함수, 위험 지점을 정리해줘.

이 단계는 코드 리뷰와 같다. 코덱스가 근거 파일을 짚지 못하면 아직 수정할 준비가 안 된 것이다.