OpenAI Codex 사용법 총정리 - 설치, 플러그인, /goal·/plan 기능

핵심 메시지

• Codex는 OpenAI가 내놓은 코딩·자동화 도구로, 코드 작성뿐 아니라 컴퓨터와 브라우저를 직접 제어할 수 있다.
• 데스크톱 앱, IDE 확장, CLI, 클라우드 등 여러 방식으로 쓸 수 있으며 강의는 기능이 가장 많은 데스크톱 앱을 기준으로 한다.
• 플러그인(컴퓨터 사용, 크롬, 깃허브 등)을 켜면 앱 실행·검색·애플리케이션 조작 같은 작업을 위임할 수 있다.
• /goal은 목표가 달성될 때까지 계획-실행-검토를 반복하는 에이전트 루프이고, /plan은 실행 전에 계획을 세우는 모드다.
• Codex는 기본적으로 세션 간 기억을 유지하지 않으므로, 지속적인 규칙·설정은 agents.md 파일에 적어 두어야 한다.

쉽게 이해하기

Tech With Tim은 사전 지식이 없는 초보자도 따라올 수 있도록 OpenAI의 Codex를 처음부터 설명한다. Codex는 Claude Code 같은 도구에 대한 OpenAI의 대응이며, 강의자는 기능이 더 많다고 본다. 코드 작성은 물론, 컴퓨터를 제어해 반복 작업을 자동화하거나 브라우저를 조작하는 것까지 가능하다. Codex는 데스크톱 앱, 커서·VS Code·윈드서프용 IDE 확장, 명령줄(CLI), 브라우저에서 도는 클라우드 버전 등 여러 형태로 제공되는데, 강의는 기능이 가장 풍부한 데스크톱 앱을 사용한다. 로그인은 ChatGPT 구독 계정으로 하며, API 키 사용은 비용이 커 권장하지 않는다.

인터페이스에서는 모델 선택기, 승인 모드(승인 요청/자동 승인/전체 접근), 브라우저·터미널 토글, 프로젝트별 채팅 정리 기능을 소개한다. 모델 선택기에서는 추론 수준(light/medium/high/extra high)을 고를 수 있는데, 높은 추론일수록 결과 품질은 좋아지지만 시간이 몇 배로 늘어난다. 강의자는 대부분의 작업에는 최상위 코딩 모델을 medium 추론으로 두고, 복잡한 작업에서만 추론 수준을 올리라고 조언한다.

핵심은 플러그인이다. '컴퓨터 사용' 플러그인을 켜면 메모장을 열어 글을 쓰게 하거나, 스포티파이가 없으면 크롬으로 대신 노래를 찾아 재생하는 식으로 컴퓨터를 대신 조작한다. 크롬 확장으로 브라우저를 제어해 애플리케이션을 테스트·디버깅할 수 있고, 깃허브 플러그인으로 코드를 저장소에 자동 커밋·업로드할 수 있다. 강의자는 실제로 멀티플레이어 체스 게임을 프롬프트만으로 만들어, 백엔드(웹소켓·DB)와 프런트엔드를 생성하고 브라우저 두 개로 대국까지 시연한다.

명령과 워크플로도 다룬다. /status로 사용량과 컨텍스트를 확인하고, 컨텍스트가 커지면 /compact로 대화를 요약해 새로 시작한다. /plan은 실행 전 질문을 던지며 계획을 세우고, /goal은 목표가 충족될 때까지 계획-실행-검토를 반복하는 에이전트 루프다. /review는 커밋 전 변경 사항을 자동 코드 리뷰한다. 워크트리(work tree)는 저장소의 복제본을 만들어 여러 에이전트를 충돌 없이 병렬 실행하게 해 준다.

마지막으로 메모리를 강조한다. Codex는 기본적으로 이전 세션을 기억하지 못하고, 매 세션 저장소를 훑어 필요한 맥락만 새로 불러온다. 따라서 프로젝트 규칙·기술 스택·실행 방법처럼 항상 반영되길 원하는 정보는 agents.md 파일에 저장해야 하며, 이 파일은 새 대화가 시작될 때마다 자동으로 모델에 로드된다. 이 밖에 컴퓨터가 켜져 있을 때 자동 실행되는 예약 작업 기능도 소개한다.

주요 인사이트

• Codex는 '코딩 도구'를 넘어 컴퓨터·브라우저를 제어하는 자동화 에이전트에 가깝다 — 플러그인이 그 능력의 핵심이다.
• 추론 수준은 품질과 시간의 트레이드오프다. 빠른 질문엔 낮은 추론, 복잡한 작업엔 높은 추론이 합리적이다.
• /goal(에이전트 루프)은 강력하지만 목표와 종료 조건을 잘 정의해야 하며, 오래 돌면 사용량을 많이 소모한다.
• 컨텍스트가 가득 차면 성능이 떨어지므로, 70~90% 지점에서 /compact로 요약해 두는 편이 결과에 유리하다.
• LLM 기반 도구는 기본적으로 '기억이 없다'. agents.md 같은 영속 파일이 곧 프로젝트의 장기 기억 역할을 한다.

자주 묻는 질문

관련 AI 소식