OpenAI의 Codex CLI는 매주 빠른 속도로 업데이트되며, 버전 0.138.0은 터미널 에이전트를 데스크탑이나 자동화 워크플로에 연결하려는 사람에게 작지만 실용적인 변화를 담은 릴리스입니다. 이번 빌드에서 달라진 점, 그리고 최신 버전이라 가정하지 말고 의도적으로 이 버전에 고정해야 하는 이유를 살펴봅니다.
0.138.0의 변경 사항
Codex CLI 0.138.0은 새 모델도, 요금 변경도, 문서화된 호환성 파괴도 없는 점진적인 품질·통합 릴리스입니다. 커밋 c18e9f4에서 rust-v0.138.0 태그가 붙어 GitHub에 141개의 릴리스 에셋과 함께 배포됩니다 . 최신 빌드가 아닌 고정 버전 참조용으로 활용하세요. 이 버전은 한 주 안에 출시된 세 릴리스 중 중간에 위치합니다.
| 버전 | 출시일 | 상태 |
|---|---|---|
| 0.137.0 | 2026년 6월 4일 | 이전 빌드 |
| 0.138.0 | 2026년 6월 8일 | 이 가이드 |
| 0.139.0 | 2026년 6월 9일 | 작성 시점 최신 |
위 날짜는 GitHub 릴리스 타임라인과 변경 이력을 기반으로 합니다 . 핵심은 데스크탑 통합입니다. 새로운 /app 명령어는 활성 TUI 스레드를 macOS 및 네이티브 Windows의 Codex Desktop으로 넘기며, Windows 워크스페이스 실행 시 수동 프롬프트에서 멈추지 않고 Desktop으로 바로 열 수 있습니다 .
일상 작업에 영향을 주는 소소한 변경도 세 가지 있습니다. 첨부 파일과 단독 생성 이미지 모두 로컬 이미지 파일 경로가 이제 모델에 노출되어, 재업로드 없이 후속 편집과 참조가 가능해집니다. 인증 측면에서는 v2 개인 액세스 토큰이 CLI와 앱 서버 흐름 모두에서 허용되며, 앱 서버 통합 시 계정 수준 토큰 사용량도 읽을 수 있습니다. 마지막으로, Alt 키 단축키를 지원하지 않는 터미널을 위한 대체 바인딩이 추론 노력(reasoning-effort) 선택기에 추가되었습니다 .
시작 전 확인 사항
설치 전 세 가지를 확인하면 시간을 아낄 수 있습니다. 첫째, 접근 권한을 확인하세요. Codex CLI는 ChatGPT Plus, Pro, Business, Edu, Enterprise 플랜 또는 유효한 OpenAI API 키가 필요합니다 . API 키 모드는 사용량 기반의 로컬 중심 방식으로, GitHub 코드 리뷰나 Slack 연동 같은 클라우드 기능은 제외됩니다. CI 형태의 워크플로에만 선택하세요 .
둘째, 현재 빌드를 확인하세요. codex --version을 실행하여 0.138.0 미만이면 업그레이드할 수 있습니다. 설치 프로그램은 항상 최신 릴리스를 가져옵니다. 2026년 6월 9일 기준으로 이미 0.139.0이 최신이었으므로 , 정확히 0.138.0이 필요하다면 GitHub 릴리스 에셋에서 특정 바이너리를 고정하세요 .
셋째, 플랫폼을 파악하세요. macOS와 Linux는 curl 설치 방식을 사용하며, Windows는 PowerShell(Windows 샌드박스)로 네이티브 실행하거나 WSL2(Linux 샌드박스)를 통해 실행합니다. 두 Windows 경로는 서로 다른 샌드박스 동작을 만들어냅니다. 자세한 내용은 아래에서 설명합니다 .
0.138.0 설치 방법
설치는 네 단계로 이루어집니다. OS에 맞게 설치하고, 버전을 확인한 다음 인증합니다. macOS와 Linux에서는 독립형 설치 프로그램을 권장하며, Windows는 PowerShell로 네이티브 실행하거나 올바른 스코프로 npm을 사용합니다 . 릴리스 주기가 매주이므로, 새 /app 핸드오프에 의존하기 전에 실제로 0.138.0에 설치되었는지 반드시 확인하세요.
- macOS / Linux:
curl -fsSL https://chatgpt.com/codex/install.sh | sh를 실행하세요. 같은 명령을 다시 실행하면 제자리 업그레이드가 됩니다. 무인 환경에서는CODEX_NON_INTERACTIVE=1을 설정하세요 . - Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"를 실행하거나, 스코프를 지정해 npm으로 설치하세요:npm install -g @openai/codex.npm install -g codex만 입력하면 관련 없는 패키지가 설치됩니다. 다음 섹션에서 설명합니다 . - 버전 확인:
codex --version이 0.138.0을 출력하는지,codex login status가 유효한 자격 증명 존재 시 0으로 종료되는지 확인하세요 . - 헤드리스 인증:
printenv OPENAI_API_KEY | codex login --with-api-key로 키를 파이프하거나, OAuth 디바이스 코드 흐름에는codex login --device-auth를 사용하거나,printenv CODEX_ACCESS_TOKEN | codex login --with-access-token으로 액세스 토큰을 전달하세요 .
흔히 걸리는 문제들
0.138.0의 설치·실행 오류 대부분은 네 가지 예측 가능한 원인으로 귀결됩니다 — npm 스코프 함정, AGENTS.md 경로 해석, Linux 프록시 소켓 길이, 그리고 이번 버전에서 처음으로 근본 원인이 표시되는 설정 쓰기 오류입니다. 각각에 명확한 확인 방법이 있습니다.
- npm 스코프 함정. 패키지 이름만 설치하면 OpenAI CLI가 아닌 무관한
codex프로젝트가 자동으로 설치됩니다 . 항상 전체 스코프 형식을 사용하세요:npm install -g @openai/codex. - AGENTS.md가 로드되지 않는 경우. 원격 또는 심볼릭 링크된 워크스페이스에서의 로드는 0.138.0 이전에 버그가 있었으며 이번 릴리스에서 수정되었습니다 . 업그레이드 후에도 문제가 지속된다면, 워크스페이스 루트가 프로젝트 디렉터리 밖으로 해석되는 깊은 심볼릭 링크 체인 안에 있지 않은지 확인하세요.
- Linux 프록시 소켓 경로 오류. 0.138.0에서 Linux의 소켓 경로가 단축되었습니다 . 오류가 계속된다면 결합된 경로 길이가 약 108자(macOS 한도는 약 104자) 이내인지 확인하세요.
- 설정 쓰기 실패. 0.138.0에서 처음으로 근본 원인이 표면에 드러납니다 . 처음 보는 오류처럼 보이더라도 실제 문제는 이 버전 이전부터 존재했을 가능성이 높습니다 — 새로 생긴 것은 버그가 아니라 진단 메시지입니다.
0.138.0 더 활용하기
설치가 정상적으로 완료되었다면 먼저 사용해볼 만한 기능은 데스크톱 전환입니다. 터미널에서 세션을 열어 파일을 읽고, 계획을 큐에 올리고, 몇 가지 편집을 실행한 뒤 /app을 입력하세요. 현재 스레드가 컨텍스트 손실 없이 macOS 또는 네이티브 Windows의 Codex Desktop으로 이전됩니다 . 작업 성격에 따라 터미널과 GUI를 오가는 팀에 특히 유용합니다 — 트리아지와 스크립팅은 셸에서, 시각적 diff 검토는 앱에서. CI 환경에서는 구조화된 플러그인 명령어가 실용적인 이점입니다 — codex plugins add <name> --json과 codex plugins remove <name> --json은 jq로 파이프할 수 있는 JSONL을 출력하며, 확장된 필드에는 스크립터블 관리를 위한 마켓플레이스 소스 정보도 포함됩니다 .
이 가이드를 고정하기 전에 한 가지 유의할 점이 있습니다. 0.139.0이 2026년 6월 9일에 출시되어 한 단계 앞서 있습니다 . 이 주간 릴리스 주기에서는 동작 세부 사항이 빠르게 변합니다 — changelog에서 이 가이드의 내용과 달라진 점을 확인하세요. 핵심 요약: 지금 당장 /app 브리지와 JSON 플러그인 출력이 필요하다면 0.138.0이 안정적인 선택이지만, 스크립팅 전에 반드시 codex --version으로 버전을 확인하세요.
자주 묻는 질문
Codex CLI 0.138.0을 실행하려면 어떤 구독이 필요한가요?
Codex CLI 0.138.0을 사용하려면 ChatGPT Plus, Pro, Business, Edu, Enterprise 플랜 또는 API 키가 필요합니다 . 무료 티어는 없습니다. API 키 모드는 사용량 기반이며 CI 스타일의 로컬 워크플로에 적합하지만, GitHub 코드 리뷰 및 Slack 통합 같은 클라우드 기능은 제외됩니다 . 전체 클라우드 기능이 필요하다면 구독 로그인을 선택하세요.
Codex CLI 0.138.0인지 이전 빌드인지 어떻게 확인하나요?
codex --version을 실행해 0.138.0 문자열을 확인하세요. GitHub에서는 rust-v0.138.0으로 태그되어 있으며 2026년 6월 8일 날짜입니다 . 이전 버전이라면 독립 설치 프로그램을 다시 실행하거나 npm install -g @openai/codex로 업그레이드하세요 . 자격 증명은 codex login status로 별도 검증할 수 있으며, 유효한 세션이 있을 때 0을 반환합니다 .
0.138.0의 /app 명령어는 무엇을 하나요?
0.138.0에서 새로 추가된 /app 슬래시 명령어는 현재 터미널 스레드를 macOS 또는 네이티브 Windows의 Codex Desktop으로 전환합니다 . 세션 컨텍스트가 스레드 중간에 이전되므로 재시작이나 복사·붙여넣기 없이 GUI에서 동일한 대화를 이어갈 수 있습니다. Windows에서는 워크스페이스 실행 시 수동 프롬프트에서 멈추지 않고 Desktop으로 바로 열 수 있습니다 .
0.138.0에서 resume --last가 왜 더 빠른가요?
이전 빌드는 가장 최근 스레드를 찾기 위해 전체 세션 기록을 스캔했습니다. 0.138.0은 이를 상태 DB 직접 조회로 대체하여 대규모 기록에서 resume --last를 빠르게 실행합니다 . 수십 개의 저장된 세션이 있는 아카이브에서 차이가 가장 두드러집니다. 동일 릴리스에서는 최적화된 바이트 스캐닝을 통해 대용량 MCP·Ollama 스트림 및 긴 메시지 기록도 가속화했습니다 .
대화형 프롬프트 없이 CI에서 Codex CLI 0.138.0을 실행할 수 있나요?
가능합니다. 무인 실행에는 CODEX_NON_INTERACTIVE=1을 설정하고, printenv OPENAI_API_KEY | codex login --with-api-key로 비대화형 인증을 수행한 뒤, codex exec --sandbox workspace-write로 작업을 실행하고 --output-last-message로 결과를 캡처하세요 . 키 대신 헤드리스 OAuth를 사용하려면 codex login --device-auth로 디바이스 코드 플로우를 이용하고, never 승인 정책을 적용하면 CI/CD 파이프라인이 프롬프트에서 차단되지 않습니다 .
