codex-cli.md

PRCW Codex CLI

이 프로젝트는 codex exec 기반 Node.js 래퍼도 포함합니다. ChatGPT 구독 로그인과 API 키 로그인을 모두 지원하며, 기본적으로 구독 로그인이 우선입니다.

ChatGPT 구독으로 설치:

npm install -g @openai/codex
codex.cmd login
npm.cmd run codex:auth

Windows PowerShell에서는 codex 대신 codex.cmd를 사용하세요. codex 명령어가 codex.ps1로 해석될 수 있으며, Codex가 설치되어 로그인된 상태에서도 PowerShell 실행 정책에 의해 차단될 수 있습니다.

API 키로 설치:

$env:OPENAI_API_KEY | npm.cmd run codex:login-api

Codex 실행:

npm.cmd run codex -- "Summarize README.md"
npm.cmd run codex -- --sandbox read-only --approval never "Analyze this project"
npm.cmd run codex -- --json "Print JSONL events for this run"

Codex 모델 명령어:

npm.cmd run codex:models
npm.cmd run codex:model
npm.cmd run codex:set-model -- gpt-5.5
npm.cmd run codex -- --model gpt-5.4 "Use GPT-5.4 for this request only"
npm.cmd run codex -- --model gpt-5.6-sol "Use GPT-5.6 Sol if your account and CLI support it"

기본 Codex 모델은 .prcw-ai.json의 codex-model에 저장됩니다. 이 래퍼는 로컬 Codex 모델 캐시가 있을 경우 이를 읽으며, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna 같은 최신 모델명도 포함합니다. 실제 사용 가능 여부는 Codex 계정 및 CLI 배포 상황에 따라 다릅니다. 단독 gpt-5.6 모델 별칭은 없습니다.

기본적으로 OPENAI_API_KEY와 CODEX_API_KEY는 자식 환경에서 제거되어 저장된 ChatGPT/Codex 구독 로그인이 우선 사용됩니다. 한 번 실행에 API 키 자격 증명을 의도적으로 전달하려면 --allow-api-key를 추가하세요.