Codex CLI 사용법: ChatGPT 기반 개발 터미널의 전환

AI 도구는 점점 많아지고 있지만, 개발 흐름 안에서 자연스럽게 쓰이는 도구는 아직 제한적입니다. Codex CLI는 브라우저나 별도의 UI를 오가지 않고, 터미널 환경에서 바로 AI를 호출해 코드 작업을 돕는 커맨드라인 기반 개발 도구입니다.

명령어 한 줄로 코드 생성, 수정, 분석을 요청할 수 있어, 구현 방법을 찾거나 오류 원인을 확인하는 과정이 개발 흐름과 분리되지 않습니다. 이 때문에 Codex CLI는 단순한 코드 생성기가 아니라, 개발 과정 안에 포함되는 보조 도구에 가깝습니다.

이 글에서는 Codex CLI가 어떤 방식으로 동작하는지, 어떤 작업 흐름에서 효과적인지, 그리고 실무에서 어떻게 활용할 수 있는지를 중심으로 정리해보겠습니다.

OpenAI의 Codex Cli란?

Codex CLI는 OpenAI의 코딩 특화 AI 모델을 터미널 환경에서 직접 활용할 수 있도록 제공되는 OpenAI의 터미널 기반 코딩 에이전트입니다. 

Rust로 구축되어 속도와 효율성을 갖췄고, GitHub에서 오픈소스로 공개되어 지속적으로 개선되고 있습니다. 

기존의 AI 코드 자동완성 도구가 특정 코드 조각을 생성하는 데 집중했다면, Codex CLI는 프로젝트 전체 맥락을 이해한 상태에서 파일 생성과 수정, 셸 명령 실행, Git을 통한 버전 관리까지 하나의 작업 흐름으로 통합합니다. 

단순히 코드를 제안하는 수준을 넘어, 실제 개발 과정에 필요한 작업들을 연속적으로 수행하는 AI 에이전트 형태로 설계되었습니다. 덕분에 개발자는 코드 에디터나 웹 UI를 오가지 않고도, 터미널 안에서 자연어로 지시해 코드를 생성하고 수정할 수 있습니다.

이러한 구조를 통해 Codex CLI는 개발자가 무엇을 만들고 싶은지를 자연어로 설명하면, 필요한 코드 작성부터 실행과 관리까지 이어지는 개발 과정을 자동화합니다.

터미널 중심의 개발 환경을 유지하면서도 AI의 판단과 실행 능력을 결합한 ‘채팅 기반 개발(Chat-driven development)’ 환경을 제공하는 것이 Codex CLI의 가장 큰 특징입니다.

Codex가 주목받는 이유 5가지

1. 프로젝트 전체 맥락을 이해하는 작업 방식

Codex CLI는 단일 코드 조각을 생성하는 도구가 아니라, 현재 프로젝트의 폴더 구조와 파일 내용을 함께 참고하며 작업을 수행합니다. 이전 대화 내용과 코드베이스를 연속적으로 인식한 상태에서 수정과 생성이 이루어지기 때문에, 요청이 바뀌더라도 일관된 구조를 유지할 수 있습니다.

이 방식은 매번 파일을 복사해 붙여 넣거나 별도로 설명해야 하는 과정을 줄여 줍니다. 개발자는 프로젝트 맥락을 유지한 채 자연어로 작업을 이어갈 수 있습니다.

2. 파일 생성 · 수정 · 명령 실행까지 연결된 에이전트형 구조

Codex CLI는 단순히 코드를 제안하는 수준을 넘어, 실제 파일을 생성하고 수정하며 셸 명령을 실행할 수 있는 구조로 설계되어 있습니다. 필요하다면 테스트 실행이나 빌드 명령을 수행하도록 안내하고, Git 기반 버전 관리 작업과 연계된 개발 흐름을 구성할 수 있습니다.

이로 인해 개발자는 “이 기능을 만들어줘”라는 요청만으로 코드 작성부터 실행과 결과 확인까지를 하나의 연속된 작업 흐름으로 경험할 수 있습니다. 

3. 자연어 중심의 명령 인터페이스

Codex CLI는 복잡한 옵션이나 스크립트를 직접 입력하지 않아도, 자연어로 의도를 전달하면 작업을 수행합니다. 개발자는 특정 언어의 문법이나 명령어 형식보다, 구현하고자 하는 기능 자체를 설명하는 데 집중할 수 있습니다.

이 방식은 반복적인 개발 패턴을 빠르게 처리하는 데 효과적이며, 코드 작성·수정·분석 과정을 하나의 대화 흐름으로 연결합니다. 터미널 환경을 유지하면서도 채팅하듯 개발할 수 있다는 점이 Codex CLI의 특징입니다.

4. 반복 업무를 줄이는 개발 자동화 효과

CRUD 화면 생성, API 연동 코드 작성, 테스트 코드 추가, 설정 파일 구성과 같은 작업은 대부분 비슷한 구조를 반복합니다. 

Codex CLI는 이러한 반복 업무를 한 번의 요청으로 처리할 수 있어, 개발자가 구조를 설계하고 연결하는 데 드는 시간을 크게 줄여 줍니다.

기존에는 여러 파일을 오가며 수동으로 작업해야 했던 과정이, 요구사항 정의와 승인 중심의 흐름으로 정리됩니다. 이를 통해 개발자는 구현보다 판단과 검증에 더 많은 시간을 사용할 수 있습니다.

5. 개발자의 역할 변화를 반영한 도구 설계

Codex CLI는 개발자를 대체하기 위한 도구가 아니라, 개발자의 역할을 보조하고 확장하는 방향으로 설계되었습니다. 

AI가 코드를 생성하고 실행을 지원하는 동안, 개발자는 전체 구조를 검토하고 보안 · 성능 · 확장성을 판단하는 역할에 집중할 수 있습니다. 이를 통해 개발자는 구조를 '설계하고 검증하는 일에 집중할 수 있습니다.

Codex CLI 사용법

Codex CLI의 설치 및 초기 설정

Codex CLI는 별도의 복잡한 설정 없이 바로 사용할 수 있도록 설계된 명령줄 도구입니다. 기본적으로 터미널 환경에서 실행되며, Node.js 18 이상 버전이 설치된 개발 환경이 필요합니다. ChatGPT Plus, Pro, Business, Enterprise 중 하나의 구독이 필요합니다.

터미널을 열고 다음과 같은 방식으로 Codex CLI를 설치할 수 있습니다.

npm을 사용하는 경우

macOS 환경에서는 Homebrew를 통해 설치할 수도 있습니다.

Windows 환경에서는 WSL(Windows Subsystem for Linux) 기반 사용이 권장되며, 이후 업데이트를 통해 네이티브 환경에서도 사용할 수 있도록 지원 범위가 확대되고 있습니다.

설치가 완료된 후 codex 명령어를 처음 실행하면 인증 절차가 자동으로 진행됩니다. 

Codex 실행 명령어

‘Sign in with ChatGPT’를 선택하면 브라우저가 열리고 로그인 과정이 이어지며, 별도의 API 키 설정 없이 계정 연동만으로 사용 준비가 완료됩니다.

이 화면은 Codex CLI에 처음 접속했을 때 표시되는 초기 안내 화면으로 ChatGPT 계정으로 로그인이 완료되었음을 알려줍니다. 

Codex는 파일 수정과 명령 실행까지 수행할 수 있는 도구이므로, 사용자가 권한 수준을 직접 관리하고 결과를 반드시 검토해야 한다는 점을 안내합니다.

Enter를 누르면 본격적인 대화형 개발 모드로 진입합니다.

Codex CLI가 프로젝트 폴더(codex-test)를 작업 디렉터리로 인식하고 실행된 화면입니다. 

이제 하단 프롬프트에 자연어로 기능 구현이나 코드 수정 요청을 입력하면 Codex가 프로젝트 작업을 수행합니다.

VS Code에서 Codex 사용하는 기본 방법

VS Code에서 프로젝트 폴더 열기

VS Code 메뉴:

VS Code 터미널 열기

단축키:

(또는 Terminal → New Terminal)

터미널에서 Codex 실행

VS Code 터미널에 그대로 입력:

그러면 지금 봤던 화면이 VS Code 안에서 그대로 뜹니다.

이제 자연어로 명령하면 Codex CLI를 사용할 수 있습니다.

멀티모달을 지원하는 Codex CLI

Codex CLI는 이미지, 텍스트, 프로젝트 파일 구조를 동시에 참조하며 작업을 수행하는 에이전트형 도구로 멀티모달이 가능합니다.

터미널 환경에서 스크린샷이나 UI 시안 이미지를 붙여 넣으면, 해당 화면을 분석해 코드 수정이나 기능 구현 작업을 수행합니다. 

오류 화면 분석, UI 구조 해석, 디자인 시안의 코드 변환까지 하나의 대화 흐름 안에서 진행할 수 있습니다.

Gemini CLI와 Claude Code 역시 멀티모달 입력을 지원합니다. Gemini CLI는 이미지 분석과 시각 정보 처리에 강점을 가진 반면, Claude Code는 텍스트와 코드 중심의 분석 작업에 더 최적화되어 있습니다. 

Codex CLI는 여기에 파일 수정과 명령 실행 기능을 결합해, 멀티모달 입력을 실제 개발 작업으로 연결하는 통합형 CLI 환경을 제공합니다.

Codex CLI의 

생산성을 높여주는 사용 노하우

Codex CLI 주요 제어 명령어(Slash Commands)

대화형 모드에서는 /로 시작하는 명령어를 통해 Codex CLI의 동작 방식을 제어할 수 있습니다.

/model
 사용할 모델과 추론 수준을 선택합니다.

/review
 코드 리뷰 모드로 전환되어 버그, 보안 문제, 테스트 누락 항목을 중심으로 분석합니다.

/approvals
 Codex CLI의 권한 범위를 설정합니다. 읽기 전용, 자동 파일 수정, 전체 접근 권한 등을 단계적으로 조절할 수 있습니다.

/undo
 마지막으로 수행한 파일 변경 작업을 되돌립니다.

/compact
 누적된 대화 내용을 요약해 컨텍스트 토큰 사용량을 줄입니다.

/mention
 특정 파일을 대화 컨텍스트에 명시적으로 포함시킵니다.

/diff
 현재 변경된 코드 내용을 Git diff 형태로 확인합니다.

이 명령어들은 Codex CLI의 자동화 수준을 조절하고, 작업 흐름을 안정적으로 관리하는 데 사용됩니다.

고급 기능과 워크플로 통합

Codex CLI는 코드 생성뿐 아니라 다양한 개발 환경과 연계된 작업을 지원합니다.

이미지 입력을 활용하면 화면 설계나 UI 시안을 코드로 변환할 수 있습니다. API 개발 과정에서는 OpenAI의 API 사양을 생성해 외부 도구와 연동하는 방식도 가능합니다.

Git 환경과 함께 사용할 경우, 현재 작업 트리 상태를 인식하고 변경 내용을 기반으로 코드 리뷰나 수정 작업을 수행할 수 있습니다. CI/CD 환경과 연결하면 Pull Request 생성 시 자동 리뷰 흐름을 구성하는 것도 가능합니다.

기본적으로 격리된 환경에서 작업이 이루어지며, 네트워크 접근이나 위험한 명령 실행 시에는 사용자 승인을 거치도록 설정할 수 있습니다.

Git 환경에서 Codex CLI 연동하는 방법

Codex CLI는 별도 Git 플러그인을 설치하는 방식이 아니라, Git이 이미 설정된 프로젝트 폴더에서 실행하면 자동으로 Git 상태를 인식하는 구조입니다.

1. Git 저장소 폴더에서 Codex 실행

2. Git 기준으로 작업 지시하기

아래처럼 요청하면 Codex가 변경 파일과 diff를 기준으로 작업을 진행합니다.

변경 사항 확인

: 지금 변경된 파일과 diff를 요약해줘.

커밋 메시지 작성

: 현재 변경 내용을 바탕으로 커밋 메시지를 Conventional Commits 형식으로 추천해줘.

PR 설명문 작성

: 이 변경사항을 기반으로 PR 제목/설명/테스트 방법을 작성해줘.

코드 리뷰

: 변경된 코드에서 잠재 버그나 리팩토링 포인트를 리뷰해줘.

Codex는 프로젝트 폴더와 Git 상태를 컨텍스트로 인식하기 때문에, Git 연동은 별도 설치가 아니라 실행 위치(저장소 내부)가 중요합니다.

3. 안전하게 사용하기 위한 승인 설정

Codex는 명령 실행과 파일 수정에 대해 승인 단계를 설정할 수 있습니다.

• "승인 단계가 필요할 때만 물어보게 설정해줘"
• "위험한 명령은 항상 승인받게 해줘"

자세한 내용은 /approvals 명령어를 참고하세요.

CI/CD 환경에서 Codex를 연결하는 방법

CI/CD에서 Codex를 직접 실행하기보다는, PR 단계에서 자동 체크(리뷰/요약/린트/테스트)를 강화하는 방식으로 활용하는 것이 안전합니다. 

가장 흔한 두 가지 패턴을 소개합니다.

패턴 1: PR 템플릿 + Codex로 PR 설명 자동 생성

1. 로컬에서 Codex로 PR 설명문 생성

: 이번 변경사항을 PR 템플릿에 맞춰 요약해줘. (배경/변경점/테스트/리스크 포함)

2. 생성된 내용을 PR 본문에 붙여넣기

: CI/CD는 기존처럼 테스트/린트/빌드를 실행하고, Codex는 PR 작성 품질을 높이는 역할을 담당합니다.

패턴 2: CI에서 자동 리뷰 연동

CI/CD에서 PR 생성 시 아래 자동 작업을 구성할 수 있습니다.

• 단위 테스트 실행
• 린트/포맷 검사
• 보안 스캐너 실행
• 코드 변경 요약 생성(릴리즈 노트 형태)

Codex는 이 결과(로그/리포트)를 바탕으로 다음 작업을 수행합니다.

• 실패한 테스트 원인 설명
• 수정 방향 제안
• PR 코멘트 형태로 정리

Codex는 CI를 대체하는 것이 아니라, CI 결과를 빠르게 해석하고 수정 방향을 제안하는 보조 도구로 활용됩니다.

트러블슈팅 및 활용 팁

인증 오류 해결 로그인 문제가 발생하면 로컬 인증 파일을 초기화한 후 다시 로그인하세요.

복잡한 작업에는 고급 모델 사용 

대규모 리팩토링이나 복잡한 구조 변경 작업에는 추론 수준이 높은 모델을 선택하는 것이 안정적입니다. /model 명령어로 모델과 추론 수준을 변경할 수 있습니다.

장시간 세션 최적화 

대화가 길어지면 /compact 명령을 사용해 내용을 요약하세요. 컨텍스트 토큰 사용량과 비용을 효율적으로 관리할 수 있습니다.

파일 검색 속도 향상 

특정 파일을 찾아야 할 때는 Codex CLI의 내장 검색 도구를 활용하도록 요청하세요.

• "프로젝트에서 'UserService' 관련 파일을 찾아줘"
• "@filename 문법으로 특정 파일을 명시적으로 지정할 수도 있습니다"

Codex CLI 요금제 및 사용 방식

Codex CLI는 ChatGPT 모델을 기반으로 사용할 수 있으며, 필요에 따라 OpenAI API를 별도로 연동해 자동화 환경에서도 활용할 수 있습니다.

Codex CLI 사용 시 주의사항

Codex CLI는 강력한 자동화 도구이지만, 모든 개발 작업을 완전히 대체할 수는 없습니다. 다음과 같은 한계를 이해하고 사용하는 것이 중요합니다.

프로젝트 맥락 이해의 한계

Codex는 코드 구조와 일반적인 개발 패턴을 잘 이해하지만, 서비스의 비즈니스 규칙이나 조직 내부 정책까지 정확히 반영하지는 못합니다. 중요한 설계 결정은 반드시 개발자가 직접 검토해야 합니다.

자동 수정에 따른 위험성

파일을 직접 수정하거나 명령을 실행할 수 있기 때문에, 승인 없이 사용하면 의도하지 않은 코드 변경이 발생할 수 있습니다. 주요 작업에는 변경 사항(diff) 확인과 코드 리뷰 과정이 필수입니다.

테스트를 완전히 대체할 수 없음

Codex가 생성하거나 수정한 코드는 논리적으로 타당해 보이더라도 실제 실행 환경에서 오류가 발생할 수 있습니다. 자동 테스트와 수동 검증을 병행해야 안정적인 개발이 가능합니다.

대규모 작업 시 비용 증가 가능성

프로젝트 전체 분석이나 장시간 추론 작업은 토큰 사용량이 크게 늘어날 수 있습니다. 장기 세션에서는 /compact 명령으로 컨텍스트를 정리해 비용을 관리하세요.

개발 생산성을 올리는 CLI 사용방법, 아래 콘텐츠를 참고하세요.

제미나이 CLI 사용법, 개발자의 역할이 완전달라집니다.

Cursor AI(커서 AI) 사용법 가이드, 개발할 때 바로 써먹는 활용 팁 3가지

Claude Code 사용법: 클로드 코드를 사용하지 않았던 게 가장 큰 실수였습니다

AI 에이전트 시대,

Codex CLI와 같은 자동화 개발 도구를 제대로 활용할 수 있는 개발자,

대한민국 최대 IT 프리랜서 매칭 플랫폼 이랜서에서 만나보세요.

이랜서는 27년간 8만 건 이상의 IT 프로젝트를 매칭해온 대한민국 최대 IT 프리랜서 매칭 플랫폼입니다.

단순히 코드를 생성하는 개발자가 아니라, AI 도구를 활용하면서도 보안과 아키텍처, 서비스 품질까지 함께 책임질 수 있는 개발자를 연결합니다.

✓  검증된 기업만 연결하는 선별 구조

✓  장기 커리어 흐름을 반영한 프로젝트 추천

✓  프로젝트 성격과 개발자 경험을 함께 고려한 매칭

AI 시대, 시스템 구조와 확장성을 설계하고 운영까지 책임질 수 있는 개발자가 필요하다면
 이랜서와 함께하세요.