1. 설치
한 가지 방법을 고르세요.
macOS 또는 Linux: 독립 실행형 설치 프로그램
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows: 독립 실행형 설치 프로그램
새 PowerShell 창을 연 다음 실행하세요:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npm (Node.js가 있는 모든 운영 체제)
npm install -g @openai/codex
Homebrew (macOS)
brew install --cask codex
README에 따르면 독립 실행형 설치 프로그램은 releases.openai.com/codex에서 다운로드하며, 그곳을 사용할 수 없으면 GitHub Releases를 대신 사용합니다. GitHub Releases를 강제로 사용하려면:
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
2. 설치 확인
PATH가 새로 고쳐지도록 새 터미널을 연 다음 실행하세요:
codex --version
버전 번호가 표시되어야 합니다. “command not found”가 표시되면 이 해결 방법을 따르세요.
3. 로그인
프로젝트 폴더로 이동해 Codex를 시작하세요:
cd path/to/your/project
codex
Sign in with ChatGPT(ChatGPT로 로그인)를 선택하세요. 브라우저가 열리고, 로그인하면 인증 정보가 CLI로 전달됩니다. codex login을 직접 실행할 수도 있습니다. 대신 API 키를 사용하려면:
printenv OPENAI_API_KEY | codex login --with-api-key
어떤 방법이 활성화되어 있는지는 codex login status로 확인하세요. SSH로 작업하거나 헤드리스 서버를 사용하나요? codex login --device-auth를 사용하세요. 더 많은 로그인 옵션.
4. 첫 프롬프트 실행
Tell me about this project
그런 다음 첫 번째 실제 작업으로 넘어가세요.
알아 두면 유용한 명령어
| 명령어 | 기능 |
|---|---|
codex | 현재 폴더에서 대화형 세션 시작 |
codex resume | 이 저장소의 최근 채팅 다시 열기 |
codex exec "..." | 스크립트와 CI용 비대화형 실행 |
codex --search | 이번 실행에서 실시간 웹 검색 사용 |
codex mcp add ... | MCP 서버 연결 |
codex login status | 활성화된 로그인 방법 표시 |
codex completion | 셸 자동 완성 생성 |