codex 사용법

Codex를 한 줄로 설명하면, 터미널에서 쓰는 AI 코딩 도우미입니다. ChatGPT 브라우저 창이 아니라, 명령 프롬프트(터미널) 안에서 GPT-5.5 모델에게 바로 지시를 내릴 수 있어요. “이 파일 리팩토링해줘”, “버그 찾아서 고쳐줘”, “테스트 코드 작성해줘” — 이런 지시를 한국어로 입력하면 AI가 코드를 분석하고 수정까지 해줍니다.

이 글은 Codex 사용법을 처음 접하시는 분들을 위한 한국어 입문 가이드입니다. 설치부터 기본 사용법, 3가지 모드, 실전 예시, Claude Code와의 차이까지 정리했어요. 설치와 실전 활용 중심의 심화 내용은 자매 글 Codex CLI 사용법, 설치부터 실전 활용까지도 함께 참고해 보세요.

Codex가 뭔가요? (한 줄 요약)

Codex(Codex CLI)는 OpenAI가 만든 터미널 AI 코딩 에이전트입니다. Claude Code(Anthropic), Gemini CLI(Google)와 같은 계열의 도구인데, OpenAI 생태계 안에 있어요.

핵심 특징만 짚으면 이렇습니다.

• ChatGPT 계정으로 사용 — 별도 API 키 발급 없이, ChatGPT 계정으로 바로 로그인합니다
• 기본 모델 GPT-5.5 — 현재 기본값은 GPT-5.5이며, 설정으로 다른 모델도 선택할 수 있어요
• 한국어 지시 가능 — “이 코드 설명해줘”, “버그 찾아줘” 등 한국어로 지시해도 잘 동작합니다
• 오픈소스(Apache 2.0) — GitHub에 소스코드가 공개돼 있어요
• 샌드박스 기본 내장 — AI가 파일을 수정하거나 명령을 실행할 때 격리 환경에서 동작합니다

설치하기 (3분이면 충분해요)

사전 준비

npm으로 설치할 경우 Node.js 22 이상이 필요합니다. nodejs.org에서 LTS 버전을 먼저 설치해 두세요. Windows 사전 빌드 바이너리나 Mac Homebrew 방식으로는 Node.js 없이도 설치할 수 있어요.

Windows

PowerShell을 열고 아래 명령어를 실행합니다.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

또는 npm으로 설치할 수도 있어요.

npm install -g @openai/codex

주의: npm i -g codex로 치면 안 됩니다. 이건 전혀 다른 구형 패키지예요. 반드시 @openai/codex로 설치하세요.

Mac / Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Mac은 Homebrew로도 간단하게 설치할 수 있습니다.

brew install --cask codex

설치 확인 및 로그인

codex --version

버전 번호가 표시되면 설치가 완료된 겁니다. 이제 처음으로 codex를 실행하면 로그인 화면이 나와요. “Sign in with ChatGPT”를 선택하면 브라우저가 열리고, ChatGPT 계정으로 로그인하면 인증이 자동으로 완료됩니다.

기본 사용법 — 이렇게 시키면 됩니다

Codex의 기본 사용법은 간단합니다. 터미널에서 codex 다음에 원하는 작업을 따옴표로 감싸서 입력하면 돼요.

codex "파이썬으로 CSV 파일을 읽어서 날짜별로 정렬하는 스크립트 만들어줘"

한국어로 지시해도 잘 동작합니다. 영어로 쓰면 좀 더 정확하게 받아들이는 경우도 있지만, 일상적인 작업은 한국어로도 충분해요.

옵션 없이 codex만 입력하면 대화형 모드로 진입합니다. 터미널 안에서 AI와 대화하듯이 지시를 주고받을 수 있어요.

codex

대화형 모드에서는 /help를 입력하면 사용 가능한 명령어 목록을 확인할 수 있습니다.

3가지 모드 이해하기 (suggest / auto-edit / full-auto)

Codex에는 AI에게 얼마나 자유를 줄지를 정하는 두 가지 축이 있습니다. 승인 정책과 샌드박스 범위인데, 이 둘을 조합해서 3가지 대표 모드로 구분해서 이해하면 편해요.

1. Suggest 모드 (제안만, 수정은 사람이)

기본값입니다. AI가 코드나 명령어를 제안만 하고, 실제로 적용할지는 사용자가 하나씩 승인합니다. 가장 안전한 방식이에요.

codex "이 함수 리팩토링해줘"

실행하면 AI가 변경안을 보여주고, 적용 여부를 물어봅니다. 처음 사용하거나 중요한 파일을 다룰 때 권장합니다.

2. Auto-edit 모드 (파일 수정 자동)

작업 디렉토리 안에서 파일 읽기·수정·명령 실행을 자동으로 합니다. 매번 승인을 누르지 않아도 돼서 편리해요.

codex -a never "테스트 코드 작성해줘"

-a never는 승인 프롬프트를 끄는 옵션입니다. 반복 작업이 많을 때 속도가 빨라집니다.

3. Full-auto 모드 (명령어까지 자동)

파일 수정은 물론 명령어 실행까지 자동으로 처리합니다. 아래 단축 옵션 하나로 full-auto 모드를 켤 수 있어요.

codex --full-auto "이 프로젝트 빌드 오류 전부 고쳐줘"

작업 속도가 가장 빠르지만, 작업 디렉토리 파일이 자동으로 수정됩니다. 중요한 코드는 git commit 상태를 확인한 뒤 쓰는 게 좋아요.

모드	파일 수정	명령 실행	승인 필요	추천 상황
Suggest (기본)	승인 후	승인 후	O	처음 사용, 중요 코드
Auto-edit	자동	자동	X	반복 편집, 빠른 작업
Full-auto	자동	자동	X	대규모 리팩토링, 빌드 자동화

처음 사용하는 분이라면 옵션 없이 기본값(Suggest)으로 시작하는 걸 권장합니다. 모드별 정확한 옵션은 codex --help로 확인하세요.

실전 활용 예시

실제로 어떤 상황에서 Codex를 쓸 수 있는지, 대표 예시를 정리했습니다.

코드 작성

codex "users 테이블에서 가입일 기준 최근 7일 신규 가입자를 조회하는 SQL 쿼리 작성해줘"

새로운 파일을 만들거나 기존 파일에 코드를 추가해줍니다.

버그 수정

codex "이 프로젝트에서 KeyError가 나는 원인 찾아서 고쳐줘"

프로젝트 폴더 전체를 읽고 에러 원인을 분석해서 수정 사항을 제안합니다.

코드 설명 (이해 안 가는 코드 파악)

codex "이 폴더 코드가 뭘 하는 건지 한국어로 설명해줘"

팀 동료가 짠 코드나 오래된 레거시 코드를 파악할 때 유용합니다.

테스트 코드 자동 작성

codex "src/utils.py에 대한 pytest 유닛 테스트 작성해줘"

기존 코드를 분석해서 테스트 케이스를 자동으로 만들어줘요.

리팩토링

codex "이 함수 가독성 높이게 리팩토링해줘. 로직은 바꾸지 마"

원하는 제약 조건을 함께 입력하면 그에 맞춰 수정 사항을 제안합니다.

파일 분석 (읽기 전용)

codex --sandbox read-only "이 디렉토리 구조 분석해줘"

--sandbox read-only 옵션을 붙이면 파일 수정 없이 읽기만 합니다. 코드베이스를 파악할 때 안전하게 쓸 수 있어요.

Codex vs Claude Code, 뭐가 다른가요?

둘 다 터미널에서 쓰는 AI 코딩 도구인데, 어떤 차이가 있는지 헷갈리는 분이 많습니다. 핵심만 정리하면 이렇습니다.

	Codex (OpenAI)	Claude Code (Anthropic)
생태계	ChatGPT / OpenAI	Claude / Anthropic
기본 모델	GPT-5.5	Claude Sonnet / Opus
로그인	ChatGPT 계정	Claude 계정
요금	ChatGPT Free~Pro $200/월	Claude Pro $20~Max $200/월
오픈소스	O (Apache 2.0)	X
샌드박스	기본 내장 (3단계)	있음 (/sandbox)
웹 검색	제한적	가능 (WebSearch 도구)
강점	속도, OpenAI 생태계 연동	복잡한 코드 정확도, 긴 작업 맥락 유지

어느 쪽이 낫다고 단정 짓기보다는, 이미 ChatGPT를 주로 쓴다면 Codex가 자연스럽고, Claude를 주로 쓴다면 Claude Code가 연속성이 있어요. 둘 다 무료·제한 버전이 있으니 직접 써보고 손에 맞는 걸 쓰면 됩니다.

일부 개발자들은 두 가지를 함께 씁니다. Codex로 빠른 코드 작성, Claude Code로 복잡한 리팩토링이나 교차 검증을 하는 식이에요.

요금제 정리

Codex는 ChatGPT 구독에 포함돼 있어서 별도 결제가 필요 없습니다.

플랜	가격	Codex 사용
ChatGPT Free	무료	체험 수준 (매우 제한적)
ChatGPT Go	$8/월	입문용 (제한 있음)
ChatGPT Plus	$20/월	기본 사용량 — 실용적으로 쓸 수 있는 최소 선
ChatGPT Pro (5x)	$100/월	Plus 대비 약 5배 사용량
ChatGPT Pro (20x)	$200/월	Plus 대비 약 20배 사용량

이미 ChatGPT Plus를 구독 중이라면 추가 비용 없이 바로 사용할 수 있어요. 무료 플랜으로도 설치 후 체험해볼 수 있지만, 사용량 한도가 낮아서 실용적으로 쓰기는 어렵습니다. 플랜별 정확한 사용량 한도는 공식 가격 페이지에서 확인하세요.

참고로, ChatGPT 구독 외에 OpenAI API 키로도 연결할 수 있습니다. 조직 단위로 쓴다면 Business·Enterprise 플랜도 지원해요.

정리

Codex 사용법을 간단히 다시 정리하면 이렇습니다.

• Codex = ChatGPT 계정으로 쓰는 터미널 AI 코딩 에이전트. 한국어로 지시해도 잘 동작합니다
• 설치는 npm 한 줄 또는 공식 스크립트로 3분이면 끝. Node.js 22 이상이 필요한 건 npm 방식뿐이에요
• 모드는 3가지. 처음이라면 기본값(Suggest)으로 시작하고, 익숙해지면 auto-edit / full-auto로 올리면 됩니다
• ChatGPT Plus($20/월) 이상이면 실용적으로 쓸 수 있어요. 이미 구독 중이라면 추가 비용 없이 바로 사용 가능합니다
• Claude Code와 경쟁 도구지만, 함께 써도 됩니다. 생태계(OpenAI vs Anthropic)가 다를 뿐이고, 성격이 조금씩 달라요

터미널 AI 코딩 도구가 처음이라면, ChatGPT Free 플랜으로 Codex를 설치해서 체험해보는 게 가장 빠른 방법입니다.

※ 이 글의 내용은 2026년 6월 기준입니다. 요금제·기능은 변동될 수 있으니 OpenAI 공식 문서에서 최신 정보를 확인하세요.