Codex 소개

Codex란 무엇인가

Codex는 OpenAI의 코딩 에이전트입니다. 개발자가 자연어로 목표를 설명하면 Codex는 현재 프로젝트의 구조와 파일을 살펴보고, 필요한 변경 사항을 제안하거나 직접 수정할 수 있습니다. 단순히 코드 조각을 만들어 주는 것이 아니라, 기존 코드베이스의 규칙과 맥락을 반영해 작업을 진행하는 것이 핵심입니다.

Codex는 Codex 앱, IDE 확장, CLI, Codex Cloud에서 사용할 수 있습니다. 처음 시작할 때는 빠른 시작을 참고하면 됩니다.

자동완성과 에이전트의 차이

기존의 코드 자동완성 도구는 주로 현재 작성 중인 파일과 커서 주변의 맥락을 바탕으로 다음 코드를 제안합니다. 반면 Codex 같은 에이전트형 도구는 작업 목표를 기준으로 프로젝트 전체를 탐색하고, 필요한 파일을 찾아 수정하고, 명령을 실행해 결과를 확인할 수 있습니다.

따라서 Codex를 사용할 때는 "이 함수를 완성해 줘"처럼 짧은 코드 단위로 요청할 수도 있지만, "이 오류를 재현하고 원인을 찾아 최소한의 변경으로 고쳐 줘"처럼 개발 작업 전체를 맡기는 방식이 더 중요합니다. 좋은 결과를 얻으려면 원하는 결과, 제한 사항, 검증 방법을 함께 알려 주는 것이 좋습니다. 자세한 요청 패턴은 프롬프트 작성을 참고하십시오.

할 수 있는 것

Codex를 사용할 수 있는 대표적인 방법은 다음과 같습니다.

계속 미루고 있는 작업 자동화

Codex는 테스트 추가, 린트 오류 수정, 반복적인 리팩터링, 설정 파일 정리, 문서 업데이트처럼 시간을 많이 쓰지만 규칙이 분명한 작업을 처리할 수 있습니다.

codex "auth 모듈의 테스트를 작성하고, 실행한 뒤, 실패하면 수정해줘"

반복 작업을 백그라운드에서 실행하려면 앱 자동화를 사용합니다. CI나 스크립트 안에서 실행하려면 비대화형 모드와 GitHub Action을 사용할 수 있습니다.

기능 구축 및 버그 수정

원하는 기능이나 고쳐야 할 증상을 일반 언어로 설명하면 Codex는 관련 파일을 찾고, 접근 방식을 세우고, 변경을 구현한 뒤 테스트나 빌드로 확인할 수 있습니다. 오류 메시지, 재현 방법, 기대 동작을 함께 제공하면 더 정확하게 원인을 좁힐 수 있습니다.

기능 구현, 버그 수정, 테스트 작성, 문서 업데이트 같은 예시는 워크플로에 정리되어 있습니다.

코드 리뷰와 pull request 처리

Codex는 변경 사항을 읽고 버그 가능성, 예외 처리 누락, 테스트 공백을 코드 리뷰 관점에서 찾을 수 있습니다. 로컬 변경은 Codex 앱의 리뷰 기능으로 확인할 수 있고, GitHub에서는 Codex 코드 리뷰를 사용해 pull request 리뷰를 요청하거나 자동화할 수 있습니다.

Codex는 git 명령을 실행할 수 있으므로 변경 요약, 커밋 메시지 작성, 브랜치 정리, pull request 준비 같은 작업도 맡길 수 있습니다.

codex "현재 변경 사항을 검토하고, 커밋 메시지 초안을 작성해줘"

MCP로 도구 연결

MCP를 사용하면 Codex를 외부 도구와 데이터 소스에 연결할 수 있습니다. 예를 들어 문서 검색, 디자인 파일 확인, 브라우저 검사, 이슈 트래커 조회처럼 코드베이스 밖의 컨텍스트가 필요한 작업을 Codex 흐름 안에 포함할 수 있습니다.

Codex 앱에서는 로컬 웹 앱을 확인할 때 앱 내 브라우저를 사용할 수 있고, 데스크톱 앱 조작이 필요한 경우에는 컴퓨터 사용을 사용할 수 있습니다.

지침, 메모리, 스킬, 훅으로 사용자화

프로젝트의 코딩 규칙, 빌드 명령, 리뷰 기준처럼 항상 적용되어야 하는 지침은 AGENTS.md에 적어 둘 수 있습니다. 이전 작업에서 얻은 개인 맥락을 재사용하려면 메모리를 사용할 수 있습니다.

반복 가능한 작업 절차는 스킬로 패키징할 수 있고, Codex 작업 전후에 명령을 실행해야 한다면 훅을 구성할 수 있습니다. 팀이나 조직 차원의 동작 제어가 필요하면 규칙과 구성을 함께 사용합니다.

여러 에이전트와 확장 워크플로 실행

큰 작업을 여러 갈래로 나눠 병렬로 진행해야 할 때는 서브에이전트를 사용할 수 있습니다. 예를 들어 한 에이전트는 원인을 조사하고, 다른 에이전트는 테스트를 추가하고, 또 다른 에이전트는 문서를 정리하게 할 수 있습니다.

Codex의 기능을 자체 애플리케이션이나 파이프라인에 더 깊게 연결하려면 SDK 또는 Agents SDK를 사용할 수 있습니다.

CLI로 파이프, 스크립트, 자동화

Codex CLI는 터미널 워크플로에 자연스럽게 연결됩니다. 로그나 명령 출력을 Codex에 넘기고, 결과를 파일이나 다른 도구로 전달할 수 있습니다.

git diff --name-only | codex exec "변경된 파일에서 보안 위험과 테스트 공백을 요약해줘"

전체 명령과 플래그는 CLI 참조를 참고하십시오.

어디서나 작업

작업 성격에 따라 적합한 Codex 표면을 고를 수 있습니다.

Codex를 사용할 때의 주의점

Codex가 코드를 수정하고 명령을 실행할 수 있다는 점은 장점이지만, 동시에 주의가 필요한 부분입니다. Codex의 결과는 항상 개발자가 검토해야 합니다. 특히 보안, 데이터 삭제, 외부 서비스 접근, 비용이 발생하는 작업, 대규모 리팩터링은 사람이 의도를 명확히 확인해야 하는 영역입니다.

작업 범위와 권한을 제어하려면 샌드박스, 승인과 보안 설정, 규칙을 확인하십시오. Codex가 제안한 변경이 문법적으로 맞더라도 실제 요구사항과 다를 수 있으므로, 테스트가 통과했는지뿐 아니라 사용자 경험과 비즈니스 규칙을 만족하는지도 검토해야 합니다.