Codex CLI

터미널에서 도는 OpenAI 오픈소스 코딩 에이전트

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

OpenAI가 Rust로 다시 쓴 오픈소스 코딩 에이전트입니다. 터미널에서 코드를 자율로 읽고 고치며, 스크린샷이나 디자인 시안을 그대로 붙여 화면 구현을 시킬 수 있습니다. 웹 검색과 서브에이전트 병렬 실행을 기본으로 갖췄습니다.

판단

이럴 때 씁니다

GPT 계열 모델로 터미널에서 자율 코딩을 시키고 싶을 때. ChatGPT 구독만 있으면 API 키 없이 바로 붙습니다.
목업·스크린샷을 그대로 붙여 화면을 구현시키고 싶을 때. 이미지를 컨텍스트로 받습니다.
사내용으로 포크해 고쳐 쓰려는 경우. Apache-2.0 오픈소스라 라이선스 부담이 없습니다.
Rust 단일 바이너리라 Node 기반 CLI보다 가볍게 돌리고 싶을 때.

이럴 땐 쓰지 마세요

설정을 세밀하게 손보려면 TOML 형식이 낯설 수 있습니다. 한 사용기에서는 "JSON이 익숙한데 TOML이 뭐냐"는 불만이 나왔습니다.
이미 Claude 모델 기반 워크플로우에 맞춰 두었다면, 모델 계열이 달라 결과 성향도 달라집니다.
기본 인증이 ChatGPT 로그인이라, API 키 방식을 쓰려면 별도 설정이 필요합니다.

차별점

Rust 단일 바이너리라 Node 기반 CLI보다 메모리를 덜 쓰고 실행이 빠릅니다.
Apache-2.0 오픈소스입니다. 포크해 사내용으로 고쳐도 라이선스에 걸리지 않습니다.
이미지를 컨텍스트로 받습니다. 목업 한 장을 붙이면 그걸 보고 화면을 짭니다.
큰 작업은 서브에이전트로 나눠 동시에 굴립니다.

워크플로

01npm install -g @openai/codex로 전역 설치합니다.
02codex를 실행해 대화형 TUI를 띄우고 ChatGPT 계정으로 로그인합니다.
03구현할 화면이 있으면 목업 이미지를 붙여 컨텍스트로 넣습니다.
04자연어로 작업을 지시하면 코드를 자율로 읽고 고칩니다. 큰 작업은 서브에이전트로 나눠 병렬 실행합니다.
05필요하면 웹 검색을 켜 최신 정보를 함께 참고하게 합니다.

주요 명령

명령	설명
`codex`	대화형 TUI를 실행하고 ChatGPT 계정으로 로그인합니다
`npm install -g @openai/codex`	npm으로 전역 설치합니다

함정

설치 전에 확인하세요

기본 인증은 codex 실행 후 'Sign in with ChatGPT'입니다. API 키 방식은 따로 설정해야 합니다.

직접 써본 메모

Claude Code와 거의 같은 일을 하지만, 선택은 두 곳에서 갈립니다. ChatGPT 구독만으로 API 키 없이 붙고, 소스가 Apache-2.0으로 열려 있어 사내용으로 포크해 고쳐도 라이선스에 걸리지 않습니다. 공식 제품을 그대로 쓰기보다 도구를 손에 쥐고 주무르고 싶은 쪽이라면 이쪽입니다.

모델이 GPT 계열이라는 점은 호불호가 아니라 전제입니다. Claude의 코드 감각을 기대하고 왔다면 결과물의 결이 다를 수 있으니, 둘 다 깔아 같은 작업을 한 번씩 맡겨 보고 정하는 편이 빠릅니다.

설정에서 작은 마찰이 하나 있습니다. Claude Code가 JSON을 쓰는 것과 달리 Codex는 TOML을 쓰는데, 한 한국어 사용기는 “그냥 claude처럼 json으로 설정하게 해주지 toml이 뭐냐”고 적을 만큼 이 차이를 불편해했습니다.

비교

같은 터미널 에이전트인 Claude Code와는 두 곳에서 갈립니다. 모델이 GPT 계열이고, 소스가 Apache-2.0으로 열려 있어 ChatGPT 구독만 있으면 API 키 없이 붙습니다. 폐쇄형 공식 제품 대신 손볼 수 있는 도구를 원한다면 이쪽입니다.

최근 변경

0.145.0에서 스레드 기록·재개·검색, Cursor·Claude Code 설정 가져오기, Bedrock 로그인, 오디오와 Multi-agent V2가 추가·안정화됐다.

공식 변경 내역