Codex CLI 설치하기

OpenAI의 독립 실행형 설치 프로그램으로 Codex CLI를 설치하세요. macOS나 Linux에서는 curl -fsSL https://chatgpt.com/codex/install.sh | sh를 실행합니다. Windows에서는 새 PowerShell 창에서 install.ps1 명령어를 실행합니다. 대안으로 npm install -g @openai/codex 또는 brew install --cask codex를 사용할 수 있습니다. 그런 다음 프로젝트 폴더에서 codex를 실행하고 Sign in with ChatGPT를 선택하세요.

적용 대상: Codex CLI, macOS, Linux, Windows

이 페이지는 영어 가이드의 번역본입니다. 명령어와 파일 이름은 그대로 두었습니다. 두 내용이 다르면 영어 페이지와 공식 출처가 우선합니다.

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셸 자동 완성 생성

자주 묻는 질문

어떤 설치 방법을 써야 하나요?

독립 실행형 설치 프로그램은 OpenAI가 가장 먼저 안내하는 방법이며 Node.js가 필요하지 않습니다. 이미 npm이나 Homebrew로 도구를 관리하고 있다면 그것을 사용하세요. 여러 방법을 섞어 쓰지 마세요. 그러면 PATH에 사본이 두 개 생길 수 있습니다.

설치 프로그램이 GitHub에서 다운로드하도록 강제할 수 있나요?

네. README에 따르면 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false를 설정하면 설치 프로그램이 releases.openai.com 대신 GitHub Releases를 사용합니다.

디버깅을 위해 Codex가 무엇을 하는지 보려면 어떻게 하나요?

codex -c log_dir=./.codex-log를 실행해 일반 텍스트 로그를 기록한 다음, tail -F ./.codex-log/codex-tui.log로 로그를 따라가며 보세요.

출처

이 페이지의 모든 안내에는 공식 출처 링크를 달았습니다. 이 페이지의 내용이 공식 출처와 다르면 공식 출처를 따르시고 저희에게 알려 주세요.