OpenAI Codex CLI

OpenAI Codex CLI

OpenAI · 코딩

OpenAI Codex CLI는 OpenAI가 만든 로컬 코딩 에이전트다. 터미널에서 돌아가며 저장소를 읽고 파일을 고치고 명령을 실행한다. 주도권은 계속 사용자에게 있다.

OpenAI Codex CLI 미리보기

OpenAI Codex CLI 소개

What Is OpenAI Codex CLI

OpenAI Codex CLI는 자기 컴퓨터에 설치해서 쓰는 코딩 에이전트다. 작업 대상은 지금 열어 둔 저장소 그 자체다. 파일을 읽고, 손을 대고, 이미 설치된 도구를 그대로 실행한다. 조작은 터미널 창에서 한다. 작업을 시작하기 전에 무언가를 웹앱에 올릴 필요가 없다.

방향은 단순하다. 평소 개발 흐름은 그대로 두고, 시간을 잡아먹는 부분을 에이전트에 맡긴다. 기능이 어떻게 연결됐는지 따라가는 일, 리팩터링을 설계하는 일, 테스트가 왜 깨지는지 찾는 일이 여기 해당한다. Codex CLI는 평소 셸에서 살고, 에이전트를 다른 탭이 아니라 코드 옆에 두고 싶은 개발자에게 맞는다.

미리 알아 둘 제약이 둘 있다. 도구 자체는 Apache-2.0 라이선스의 오픈소스로 무료지만, 그 뒤의 모델을 쓰려면 유료 ChatGPT 요금제나 API 요금으로 과금되는 API 키가 필요하다. 게다가 단독 명령줄 도구는 Codex의 다른 형태에 있는 클라우드 기능을 쓰지 못한다. GitHub 코드 리뷰와 Slack 연동이 그렇다.

Getting Started

  1. macOS나 Linux에서는 한 줄짜리 셸 스크립트로, Windows에서는 PowerShell 버전으로 Codex CLI를 설치한다. npm install -g @openai/codex나 brew install --cask codex를 써도 된다.
  2. 프로젝트 폴더를 열고 codex를 실행한다. 처음 시작할 때 Sign in with ChatGPT를 고르고 Plus, Pro, Business, Edu, Enterprise 중 하나의 요금제에 묶인 계정을 연결한다.
  3. 하고 싶은 일을 평범한 말로 적는다. 프로젝트를 설명해 달라거나, 특정 부분을 고쳐 달라거나, 오류 원인을 찾아 달라고 하면 된다. 에이전트는 파일을 확인하면서 수정안을 내놓는다.
  4. 작업 전후로 Git 체크포인트를 만든다. 변경이 꼬이면 손으로 풀지 않고 체크포인트로 돌아가면 된다.
  5. Codex가 실행하려는 명령을 승인하거나 거절한다. /permissions와 /model로 그 세션의 경계와 추론 강도를 정한다.

제품 정보

OpenAI Codex CLI의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.

무료 플랜예
유료 플랜$0 - $500/mo
플랫폼macOS, Linux, Windows (terminal); also CLI, SDK, and IDE extension
개발사OpenAI
카테고리코딩
출시일Apr 2025
최근 업데이트Oct 2026
웹사이트 방문 수649.3M
웹사이트 글로벌 순위50
API 제공 여부예

추천 대상

이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.

사용자

  • 터미널 중심 개발자
  • 백엔드·시스템 엔지니어
  • CI와 자동화 담당자

작업

  • 낯선 코드 살펴보기
  • 표적이 분명한 리팩터링
  • 로컬 코드 리뷰

활용 상황

  • 매일 반복하는 편집과 실행 루프
  • 커밋 전 점검
  • 반복 작업 자동화

주요 기능

로컬 저장소에서 일하는 에이전트

Codex CLI가 다루는 건 지금 프로젝트의 파일 그 자체다. 어딘가로 올린 복사본이 아니다. 코드를 살피고, 고치고, 설치된 도구를 실행하므로 동작이 실제 환경과 맞는다. 비밀 정보도 의존성도 로컬 설정도 있던 자리에 남는다.

모델과 추론 강도 조절

모델과 추론 강도는 세션마다 /model로 고른다. 작업이 무거워지거나 가벼워지면 대화 도중에 바꿀 수 있다. ChatGPT 요금제에서는 코딩용 기본이 GPT-6.1 Sol이고, 가벼운 작업에는 GPT-6 Luna를 쓸 수 있다. 전용 /model 명령이 있어 설정이 파일에 묻히지 않고 눈앞에 보인다.

권한과 샌드박스 제어

/permissions 명령은 Codex가 묻지 않고 파일을 고치거나 명령을 실행해도 되는 시점을 정한다. 계속하기 전에 유효한 샌드박스와 쓰기 가능한 루트를 확인할 수 있다. 망가뜨리면 곤란한 저장소에 에이전트를 붙일 때 이게 중요하다.

로컬 코드 리뷰

/review는 커밋하지 않은 변경, 커밋 하나, 또는 베이스 브랜치를 집중해서 훑고 우선순위 순으로 지적을 돌려준다. 작업 트리는 고치지 않으므로 커밋이나 pull request 전에 위험을 볼 수 있다. 점검이지 자동 수정이 아니다.

codex exec로 하는 스크립트와 CI

비대화형 모드에서는 스크립트와 파이프라인에서 Codex를 부를 수 있다. 빌드 단계나 반복 워크플로에서 같은 에이전트 로직을 띄울 수 있다는 점이, 팀이 구독보다 API 키 쪽을 택하는 주된 이유다.

이미지와 웹 맥락

codex --image는 스크린샷, 구조도, 디자인 참고를 첫 프롬프트에 넘긴다. 에이전트가 나와 같은 시각 정보를 본다. codex --search는 최신 릴리스나 문서에 달린 작업일 때 실행을 실시간 웹 검색으로 바꾼다. 검색 과정은 기록에 남는다.

세션, 이어가기, 서브에이전트

codex resume는 지금 저장소의 최근 대화를 다시 연다. 예전 작업으로 돌아가고 싶으면 로컬 대화를 가로질러 찾는다. 규모가 큰 조사에서는 Codex에 표적 작업을 서브에이전트로 넘기게 하고, 그 결과를 메인 세션으로 끌어올 수 있다.

MCP 연결

Codex는 로컬이나 원격 MCP 서버에 붙고, 필요하면 인증하고, 쓰기 전에 그 세션에서 쓸 수 있는 도구를 나열한다. 팀 데이터와 외부 서비스에 터미널을 벗어나지 않고 닿는 경로가 이것이다.

장단점

장점

  • 평소 쓰던 터미널에서 돌아간다. 편집기나 웹앱을 먼저 들일 필요가 없다.
  • Apache-2.0으로 오픈소스라서 무슨 일을 하는지 직접 읽을 수 있다.
  • 권한과 샌드박스 제어로 에이전트가 무엇을 바꾸고 실행할지 스스로 정한다.
  • `codex exec` 덕분에 대화형 세션뿐 아니라 스크립트와 CI에서도 쓸 수 있다.
  • 리뷰 모드는 작업 트리를 건드리지 않고 문제를 짚어 준다.

단점

  • 모델 접근은 무료가 아니다. ChatGPT 요금제나 API 요금으로 과금되는 API 키가 필요하고, 많이 쓰면 비용이 금방 불어난다.
  • 단독 명령줄 도구에서는 GitHub 코드 리뷰, Slack 연동, 더 큰 클라우드 VM 같은 클라우드 기능을 쓸 수 없다.
  • 그래픽 화면이 없다. 명령줄을 피하는 사람에게는 진입 장벽이 높다.
  • API 키 경로는 설정 손이 더 간다. 쓸 수 있는 모델은 키가 닿는 범위에 달려 있다.

자주 묻는 질문

도구 자체는 Apache-2.0 라이선스의 오픈소스로 무료다. 하지만 사용은 무료가 아니다. 뒤의 모델에는 유료 ChatGPT 요금제(Plus는 $20/mo, Pro는 $100/mo부터, Business는 사용자당 월 $20)나 API 요금으로 과금되는 API 키가 필요하다.