[기타/AI] Codex CLI 설치와 사용법: 터미널에서 OpenAI 코딩 에이전트 시작하기
업데이트:
한눈에 고르기
| 상황 | 먼저 보기 |
|---|---|
| OpenAI 계열 워크플로를 터미널에서 쓰고 싶음 | Codex CLI 우선 |
| IDE 안에서 긴 세션으로 작업 | Cursor나 Copilot도 함께 비교 |
| 문서·설명 비중이 큰 협업형 수정 | Claude Code 계열과 비교 |
빠른 답
- Codex CLI는 OpenAI 코딩 에이전트를 터미널에서 바로 쓰는 공식 경로입니다.
- 대표 설치는
npm install -g @openai/codex이고, 이후 ChatGPT 로그인이나 API 키 인증으로 바로 시작할 수 있습니다. - 저장소 단위 수정과 실행 흐름에 강하고, 가벼운 자동완성 위주라면 Copilot이 더 단순하게 맞을 수 있습니다.
어떤 도구인가
Codex CLI는 터미널에서 바로 코딩 에이전트를 부른다는 감각이 핵심입니다. OpenAI 공식 문서 기준으로 ChatGPT 계정 로그인 또는
OPENAI_API_KEY 인증을 택할 수 있고, 저장소 안에서 수정·테스트·요약 흐름을 이어갈 수 있습니다.
개념이나 비교 관점이 먼저 필요하면 GPT Codex 앱 사용 가이드도 같이 보면 연결이 더 잘 됩니다. 브라우저와 IDE 표면, CLI 표면을 같이 비교하고 싶다면 이 글을 이어서 보면 좋습니다.
공식 사이트와 다운로드 경로
- 공식 사이트: Codex CLI 공식 문서
- 다운로드/접속 경로: Codex 개요 문서
- 공식 문서: Codex 앱 문서
지원 환경과 설치 방법
Windows
Windows도 공식 문서에서 지원 대상으로 다뤄집니다. Node와 npm이 준비되어 있으면 npm i -g @openai/codex로 설치하고, PowerShell이나
Windows Terminal에서 실행할 수 있습니다.
대표 경로는 npm 전역 설치 후 바로 실행하는 방식입니다.
npm i -g @openai/codex
codex
macOS
macOS에서는 npm 전역 설치 후 바로 쓸 수 있습니다. 터미널, Git, 테스트 명령과 붙여 쓰는 흐름이 자연스러워서 로컬 개발용으로 진입하기 좋습니다.
가장 흔한 설치법은 아래 한 줄입니다.
npm i -g @openai/codex
codex
Linux
Linux 역시 npm 전역 설치가 기본 경로입니다. 원격 개발 환경이나 컨테이너 안에서도 비교적 가볍게 올릴 수 있어 CLI형 코딩 에이전트와 잘 맞습니다.
Linux에서도 대표 경로는 npm 전역 설치입니다.
npm i -g @openai/codex
codex
기본 사용법
Codex CLI는 설치 직후 큰 리팩터링보다 작은 수정 요청으로 시작하는 편이 안전합니다. 로그인이나 API 키 인증이 끝나면, 우선 테스트 가능한 간단한 수정 과제를 맡기고 diff와 로그를 읽는 감각부터 익히는 게 좋습니다.
npm i -g @openai/codex로 CLI를 설치합니다.codex를 실행하고 ChatGPT 로그인 또는 API 키 인증을 마칩니다.- 프로젝트 폴더에서 수정 요청, 테스트 실행, diff 검토를 반복합니다.
npm i -g @openai/codex
codex
어떤 사람에게 잘 맞나
Codex CLI는 브라우저보다 터미널이 편하고, Git과 테스트 명령까지 한 흐름으로 엮고 싶은 개발자에게 잘 맞습니다. 기존 CLI 습관을 크게 바꾸지 않으면서 에이전트를 얹는 감각이 강합니다.
주의할 점
권한을 준 저장소에서 실제 명령이 돌아가는 만큼, 민감 파일과 실행 범위를 늘 체크해야 합니다. 특히 API 키 인증을 쓸 때는 로컬 셸 히스토리와 환경 변수 관리가 중요합니다.
요약
Codex CLI는 설치 자체는 간단하지만, 인증 방식과 작업 범위 설정이 사용성을 좌우합니다. 공식 CLI 문서 그대로 npm 설치 -> 로그인 -> 작은 작업부터
순서로 접근하면 시행착오가 적습니다.
참고 자료
이 글과 함께 보면 좋은 글
지금 읽은 내용을 바로 확장하거나, 실제 선택과 설치까지 이어질 만한 글들만 골랐습니다.
- GPT Codex란 무엇인가 Codex 제품군 전체 그림을 볼 때
- Cursor 설치와 사용법 IDE 기반 대안까지 비교할 때
- 2026 프론티어 모델 비교 모델 성향까지 같이 볼 때
이런 주제는 어떠신가요?
비교 글과 설치 가이드를 함께 보면 나에게 맞는 도구를 더 빨리 고르기 좋습니다.
댓글남기기