Codex CLI

코덱스 CLI

터미널에서 코드베이스를 읽고 파일 수정·명령 실행을 돕는 OpenAI 로컬 코딩 에이전트

약간의 설정 필요 Desktop · API · Web

coding assistant #코딩 에이전트#터미널 CLI#코드베이스 편집

소개

npm 또는 Homebrew로 설치해 터미널에서 codex를 실행하면 로컬에서 코딩 에이전트를 구동합니다. VS Code·Cursor·Windsurf 안에서도 작동해 프로젝트 문서를 읽고 작업을 실행하며 낯선 프레임워크로도 기능을 구현할 수 있습니다. 클라우드 전용 에이전트와 달리 내 기기에서 동작하고 ChatGPT 플랜 또는 API 키로 인증할 수 있습니다.

에디터 한마디

Codex CLI는 프로젝트 문서를 읽고 작업 정의를 실행하는 로컬 에이전트를 원하는 개발자에게 적합합니다. CLI 설치와 ChatGPT 플랜 또는 API 키로 인증할 수 있는 엔지니어에게 권장합니다.

주요 기능

로컬에서 codex 실행 → 프로젝트용 로컬 코딩 에이전트 구동
작업 정의 붙여넣기 → 에이전트가 단계 실행하고 작동하는 프로젝트 생성
프레임워크 문서 지정(GitMCP) → API를 학습해 올바르게 적용
VS Code/Cursor/Windsurf 설치 → 선호 에디터 내부에서 사용
ChatGPT 플랜 또는 API 키로 로그인 → 기존 OpenAI 접근권으로 인증

이런 상황에 추천

풀스택 엔지니어가 새로운 웹 프레임워크의 문서와 작업 브리프만으로 CSV 뷰어를 구현할 때
VS Code 사용자가 TypeScript 프로젝트에 기능을 연결하면서 에이전트를 로컬로 유지하고 ChatGPT Plus로 인증해 작업할 때

이렇게 써보세요

1
낯선 웹 프레임워크로 CSV 뷰어 만들기
UI·내보내기·밸리데이션 요구를 담은 작업 정의서를 작성합니다 → 프로젝트 루트에서 codex를 실행하고 작업 정의서를 붙여 에이전트가 GitMCP를 통해 프레임워크 문서를 읽게 합니다 → 생성된 파일을 점검하고 개발 서버를 켜서 동작을 확인한 뒤 UX 개선이나 버그 수정을 요청합니다.
2
VS Code에서 TypeScript 기능 추가하기
npm 또는 Homebrew로 codex를 설치하고 ChatGPT 플랜으로 로그인하거나 API 키를 제공합니다 → VS Code에서 레포를 열고 '아이템 리스트에 검색 추가' 같은 작업을 붙여넣습니다 → 제안된 수정(diff)을 검토해 적용하고 프로젝트 규약을 유지하면서 변경을 반영합니다.
3
Django 프로젝트에서 필드 일괄 리네임 및 리팩터링
레포 루트에서 codex를 실행하고 '필드 X를 Y로 변경하고 마이그레이션 업데이트'라는 작업을 줍니다 → codex가 코드베이스를 분석해 모델·마이그레이션·사용처 변경사항을 diff로 제시합니다 → 테스트를 실행해 실패하면 codex에 테스트 수정을 지시합니다.
4
문서만 보고 서드파티 API 연동하기
API 작업 브리프를 붙여넣고 API 문서의 GitMCP 엔드포인트나 로컬 문서를 지정합니다 → codex가 문서를 읽고 인증·요청 헬퍼·예제 사용법과 오류 처리를 스캐폴딩합니다 → 로컬에서 테스트하고 재시도·백오프 로직을 강건하게 만들어 달라고 요청합니다.
5
대규모 레포 온보딩 후 소규모 기능 추가
codex를 레포에서 실행하고 핵심 모듈과 원하는 기능을 한 문단으로 설명한 온보딩 노트를 제공합니다 → README·CONTRIBUTING·주요 모듈을 탐색해 컨텍스트를 구축합니다 → 소규모 기능 구현을 요청하고 diff를 검토한 뒤 디자인 선택에 대해 추가 질문합니다.

장단점

장점

npm 또는 Homebrew로 로컬에서 실행되어 코드와 컨텍스트를 로컬에 유지하는 에이전트로 동작합니다.
기존 ChatGPT 플랜이나 API 키로 로그인할 수 있어 별도 서비스 프로비저닝 없이 OpenAI 접근을 재사용할 수 있습니다.
GitMCP로 제공한 문서를 통해 낯선 프레임워크를 학습하고 테스트에서 작동하는 CSV 뷰어를 생성한 사례가 있습니다.

단점

CLI 설치(npm/Homebrew)와 로그인 등 개발자 설정이 필요해 비개발자에게는 즉시 사용하기 어려울 수 있습니다.
공식 자료에서 한국어 지원을 확인할 수 없습니다.
기능 사용은 ChatGPT 플랜 또는 API 키 같은 외부 모델 접근에 의존합니다.

시작하는 법

1 npm i -g @openai/codex 또는 brew install --cask codex로 설치하거나 GitHub 릴리스에서 바이너리 다운로드
2 터미널에서 codex 실행 후 'Sign in with ChatGPT' 선택하거나 API 키 구성
3 짧은 작업 정의를 붙여넣으면 Codex가 프로젝트 파일과 구현 단계를 생성하기 시작