코드를 새로 짜거나 리팩터링할 때마다 반복 작업에 시간을 뺏기고 있다면, OpenAI의 코딩 에이전트를 업무에 끌어들이는 방법부터 알아둘 필요가 있습니다. 이 글에서는 GPT Codex 사용법을 처음 접하는 실무자를 기준으로, 접근 경로 3가지와 승인 모드, 프로젝트 규칙을 알려주는 법까지 순서대로 정리했습니다. Codex는 2025년 10월 정식 출시(GA)된 이후 빠르게 팀 워크플로우에 자리 잡고 있는 도구입니다.
📌 핵심 요약
- GPT Codex는 OpenAI가 만든 코딩 에이전트로, 작업 단위로 지시하면 코드 작성·수정·테스트까지 대신 처리합니다.
- 2025년 10월 정식 출시 이후 빠르게 팀 워크플로우에 자리 잡았습니다.
- GPT Codex 사용법을 접근 경로 3가지, 승인 모드, 프로젝트 규칙 설정 순서로 실무자 기준에서 정리했습니다.
이 글은 이런 분께 추천합니다: 반복적인 코드 작성·리팩터링에 시간을 뺏기는 개발자, 코딩 에이전트를 처음 도입하는 팀
GPT Codex란 무엇인가
Codex는 OpenAI가 만든 코딩 에이전트로, 사람이 한 줄씩 코드를 치는 대신 작업 단위로 지시하면 에이전트가 코드 작성·수정·테스트까지 대신 처리합니다. 2025년 10월 정식 출시된 뒤 지속적으로 업데이트되며 실무 도구로 자리 잡았습니다.
OpenAI는 Codex를 코드 작성부터 리팩터링, 버그 수정, 테스트 실행까지 한 번에 위임할 수 있는 에이전트로 소개하고 있습니다. 2026년 7월 9일 업데이트로 기반 모델이 GPT-5.6 계열로 바뀌면서 복잡한 멀티파일 작업에서도 정확도가 올라갔고, 스크린샷 같은 이미지를 첨부해 “이 화면과 똑같이 UI를 고쳐줘”처럼 시각적 지시를 내리는 것도 가능해졌습니다.
예를 들어 오래된 API 응답 형식을 새 스키마로 바꾸는 작업을 지시하면, Codex는 관련 파일을 모두 찾아 수정하고 테스트를 돌려본 뒤 결과를 요약해서 보고합니다. 사람은 그 결과만 검토하면 되므로, 파일을 하나씩 열어 수정하는 시간을 줄일 수 있습니다.
접근 경로 3가지: ChatGPT, 터미널, Slack
Codex는 하나의 도구가 아니라 세 가지 경로로 접근할 수 있는 서비스입니다. 업무 환경에 따라 어떤 경로가 맞는지 먼저 파악해두면 도입이 훨씬 수월합니다.
첫째, ChatGPT 사이드바의 “Code” 버튼을 누르면 클라우드 샌드박스에서 작업을 진행하도록 위임할 수 있습니다. 로컬 환경 설정 없이 브라우저에서 바로 시작할 수 있어 진입장벽이 가장 낮습니다. 둘째, 터미널에서 codex 명령어로 실행하는 CLI 방식입니다. ChatGPT Plus·Pro·Business·Enterprise 계정으로 로그인하면 별도 API 키 없이도 로컬 환경에서 바로 쓸 수 있습니다. 셋째, Slack에서 @Codex를 멘션하면 팀 채널 안에서 바로 작업을 맡길 수 있습니다.
빠르게 아이디어를 검증하고 싶다면 ChatGPT 사이드바로 시작하고, 실제 리포지토리를 다루는 반복 작업은 터미널 CLI로 넘어가고, 팀원과 진행 상황을 공유해야 한다면 Slack 경로를 쓰는 식으로 상황별로 나눠 쓰는 것이 효율적입니다.
터미널 CLI로 시작하기: 설치부터 승인 모드까지
GPT Codex 사용법 가운데 실제 리포지토리 작업에 가장 유용한 경로는 터미널 CLI입니다. 설치 후 로그인만 하면 바로 쓸 수 있고, 승인 모드를 상황에 맞게 고르는 것이 핵심입니다.
터미널에 codex 명령어를 설치한 뒤 ChatGPT 계정으로 로그인하면 준비가 끝납니다. 실행 후에는 세 가지 승인 모드 중 하나를 고를 수 있습니다. Suggest 모드는 Codex가 변경 사항을 제안만 하고 매번 사람이 승인해야 반영됩니다. Auto Edit 모드는 파일 수정은 자동으로 처리하되 셸 명령 실행 전에는 승인을 받습니다. Full Auto 모드는 샌드박스 안에서 네트워크를 차단한 채 완전히 자동으로 작업을 끝까지 진행합니다. 작업 중 자리를 비웠다가 다시 이어가고 싶다면 codex resume 명령으로 이전 세션을 그대로 불러올 수 있습니다.
처음 써본다면 Suggest 모드로 몇 차례 작업 흐름을 지켜본 뒤, 신뢰가 쌓이면 Auto Edit으로 넘어가는 순서를 권장합니다. 반복적이고 위험도가 낮은 작업(코드 스타일 통일, 테스트 코드 추가 등)에는 Full Auto 모드를 쓰면 사람 개입 없이 끝까지 진행됩니다.
AGENTS.md와 SDK로 프로젝트에 맞게 확장하기
Codex를 팀 전체 워크플로우에 붙이려면 리포지토리 규칙을 알려주는 AGENTS.md 파일과, 자체 파이프라인에 임베드할 수 있는 SDK·GitHub Action을 함께 알아둬야 합니다.
리포지토리 루트에 AGENTS.md 파일을 두면 Codex가 테스트 실행 명령어나 코딩 컨벤션 같은 프로젝트 고유 규칙을 참고해서 작업합니다. 매번 프롬프트에 같은 규칙을 반복해서 설명할 필요가 없어집니다. 더 나아가 TypeScript로 제공되는 Codex SDK를 쓰면 자체 CI/CD나 사내 도구 안에 Codex를 직접 임베드할 수 있고, GitHub Action을 등록하면 PR이 올라올 때마다 자동으로 리뷰나 수정 작업을 맡기는 것도 가능합니다.
신입 개발자가 프로젝트 컨벤션을 몰라도, AGENTS.md에 “테스트는 npm test로 실행하고 커밋 메시지는 이런 형식을 따른다”고 적어두면 Codex가 그 규칙을 그대로 지켜서 작업합니다. GitHub Action으로 등록해두면 PR을 열 때마다 자동으로 린트·테스트 결과를 확인하는 식으로 팀 리뷰 부담을 줄일 수 있습니다.
✅ 체크리스트
- 업무 성격에 맞는 승인 모드(자동/수동 확인)를 선택했다
- 프로젝트 규칙 파일을 등록해 에이전트가 팀 코딩 컨벤션을 따르게 했다
- 에이전트가 수정한 코드를 병합 전 사람이 리뷰하는 절차를 유지했다
마무리
GPT Codex 사용법의 핵심은 세 가지입니다. 접근 경로는 ChatGPT 사이드바·터미널 CLI·Slack 중 업무 환경에 맞는 것을 고르고, CLI에서는 Suggest부터 시작해 신뢰도에 따라 승인 모드를 올리고, 팀 단위로 쓸 계획이라면 AGENTS.md와 SDK·GitHub Action까지 챙겨두는 것입니다. 아직 Codex를 안 써봤다면 터미널에 codex 명령어를 설치하고 Suggest 모드로 첫 작업부터 맡겨보는 것을 추천합니다.
관련 글도 함께 참고하세요.
관련 글도 함께 참고해보세요.
댓글 남기기