LeanX

코덱스(Codex) 실전 입문

OpenAI의 AI 코딩 에이전트 — 설치, 클라우드 위임, GitHub PR 워크플로우까지

코덱스란? Claude Code와 뭐가 다른가

코덱스(Codex)는 OpenAI가 만든 AI 코딩 에이전트로, 터미널 CLI·IDE 확장·클라우드 위임·GitHub 연동까지 하나의 계정으로 이어지는 것이 특징이며, 특히 작업을 맡기고 다른 일을 하는 비동기 위임에 강합니다. 약 7분.

설치와 설정 — 5분 만에 준비 끝내기

코덱스 CLI는 npm install -g @openai/codex 한 줄로 설치하고, codex 명령을 실행해 ChatGPT 계정으로 로그인하면 바로 사용할 수 있으며, IDE 확장과 클라우드는 같은 계정으로 자동 연결됩니다. 약 6분.

첫 작업 시키기 — 승인 모드와 좋은 프롬프트

코덱스의 승인 모드는 Read Only(읽기만), Auto(작업 폴더 안에서 자동), Full Access(모두 허용) 세 가지이며, 처음에는 기본값인 Auto 모드에서 목표·범위·완료 조건이 들어간 구체적인 프롬프트로 시작하는 것이 안전합니다. 약 8분.

클라우드 위임과 병렬 작업 — 맡기고 다른 일 하기

코덱스 클라우드는 작업을 OpenAI의 격리된 샌드박스에 맡겨 코드 수정과 테스트까지 대신 실행하는 기능으로, 여러 작업을 동시에 병렬로 돌려 두고 나는 다른 일을 하다가 결과만 검토하면 됩니다. 약 8분.

GitHub 연동과 PR 워크플로우

코덱스를 GitHub 저장소에 연결하면 이슈나 PR에서 @codex 멘션만으로 작업을 시킬 수 있고, 결과는 항상 PR로 만들어지기 때문에 사람이 리뷰하고 머지하는 안전한 검토 관문이 자동으로 생깁니다. 약 8분.

AGENTS.md — 프로젝트 규칙 파일 만들기

AGENTS.md는 저장소에 두는 코덱스용 업무 매뉴얼 파일로, 프로젝트 소개·실행 명령어·코딩 규칙·금지 사항을 적어 두면 코덱스가 매 작업 전에 읽고 따르기 때문에 프롬프트마다 같은 설명을 반복할 필요가 없어집니다. 약 7분.

실전: 작은 버그 수정을 처음부터 끝까지

실전 버그 수정은 브랜치 생성 → 버그 재현 확인 → 구체적 프롬프트로 코덱스에게 수정 위임 → 테스트와 diff 검토 → PR 생성 → 사람 리뷰 후 머지의 순서로 진행하며, 이 사이클을 그대로 반복하는 것이 코덱스 실무의 기본기입니다. 약 10분.

코드 리뷰에 활용 — diff 분석과 교차 검증

코덱스는 코드를 작성하는 것 외에도 다른 사람이나 AI가 만든 변경분(diff)을 독립적인 시각으로 검토하는 데 탁월하며, git diff를 직접 넘기거나 PR 링크를 주는 것만으로 버그, 보안 위험, 스타일 위반을 빠르게 짚어 줍니다. 약 7분.

실전 베스트 프랙티스 — 더 잘 쓰기 위한 핵심 원칙

코덱스를 잘 쓰는 개발자와 그렇지 않은 개발자의 차이는 도구가 아니라 일하는 방식에 있으며, 작업을 잘게 쪼개고 명세를 정확히 쓰고 결과를 꼼꼼히 검토하는 세 가지 습관이 AI 코딩 에이전트의 효과를 결정합니다. 약 8분.

모델 선택과 추론 강도 — /model 과 /fast

코덱스는 항상 최신 최상위 모델을 쓰고(mini 금지) 추론 강도는 High를 일상 기본값으로, 아주 어려운 버그나 위험한 대규모 개편에만 Extra High를 쓰며, 상위 요금제라면 /fast(속도 약 2배)를 켜 두는 것이 좋습니다. 약 8분.

맥락을 먹이는 4가지 방법 — 이미지·웹검색·XML·세션

코덱스에는 스크린샷을 붙여넣고(Ctrl+V) 웹 검색을 시키고 긴 텍스트를 <text> 태그로 감싸 넣을 수 있으며, /resume로 지난 대화를 잇거나 /new·/clear로 새로 시작할 수 있는데, 이런 입력 통로들은 대부분의 초보가 거의 안 쓰는 숨은 무기입니다. 약 10분.

미드위트 곡선 — 짧지만 명확하게 시키는 법

좋은 프롬프트는 길고 화려한 게 아니라 '충분한 맥락'과 '명확함' 두 기둥을 갖춘 짧고 정확한 지시이며, 초보는 너무 막연하고 중간 실력자는 과하게 꾸미느라 시간을 낭비하지만 고수는 원하는 것을 정확히 알고 간결하게 빠르게 보냅니다. 약 8분.

2계층 안전 모델과 플랜 모드 — 샌드박스 × 승인

코덱스의 안전은 '무엇을 만질 수 있나'를 정하는 샌드박스 계층(Read Only→Workspace Write→Full Access)과 '언제 멈춰 물어보나'를 정하는 승인 계층(Untrusted→On Request→Never→Granular)이라는 독립된 두 손잡이로 결정되며, 기본은 Workspace Write+On Request, 가장 공격적인 --yolo는 반드시 Git과 함께 써야 하고, 큰 변경 전에는 /plan으로 계획부터 받는 것이 안전합니다. 약 11분.

코덱스 데스크톱 앱 — 여러 에이전트를 동시에 부리는 관제탑

코덱스 데스크톱 앱(맥·윈도우)은 여러 에이전트를 각자의 git worktree에서 충돌 없이 병렬로 돌리고, $로 부르는 스킬로 능력을 확장하며, 크론 같은 자동화와 값싼 모델의 서브에이전트까지 한 화면에서 관리하는, 다중 에이전트 운영을 위한 OpenAI의 답입니다. 약 10분.

Git·GitHub·배포 — 코덱스로 저장하고 세상에 내보내기

Git은 내 컴퓨터의 버전관리 도구이고 GitHub는 그 기록을 올려두는 온라인 창고로 서로 다르며, 10~15분마다 코덱스에게 커밋을 맡기고 GitHub에 푸시한 뒤 Next.js 앱이면 Vercel로 배포하면 이후 푸시마다 자동 재배포되는데, 코덱스는 코딩뿐 아니라 배포·리서치·마케팅 등 사람이 컴퓨터로 하는 일이면 무엇이든 도울 수 있습니다. 약 9분.