DownloadCodex 비공식 가이드
한국어

Codex 설치하기

터미널에서 작업하거나 스크립트와 CI에 쓰려면 Codex CLI를 설치하세요. 프로젝트, 병렬 채팅, 리뷰 창을 한 창에서 쓰고 싶다면 ChatGPT 데스크톱 앱을 설치하세요. 주로 VS Code, Cursor, Windsurf에서 작업한다면 IDE 확장 프로그램을 설치하세요. 세 가지 모두 로그인과 config.toml을 공유하므로 둘 이상을 함께 사용할 수 있습니다.

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

무엇을 설치해야 할까요?

Codex CLIChatGPT 데스크톱 앱 (Codex)IDE 확장 프로그램
실행 위치터미널데스크톱 창에디터 안
적합한 용도터미널 워크플로, 스크립트, codex exec를 사용한 CI여러 프로젝트 동시 작업, 워크트리, 예약 작업, 내장 브라우저열려 있는 파일에 집중한 편집
플랫폼macOS, Linux, WindowsmacOS, Windows, Linux (프리뷰)VS Code, Cursor, Windsurf; JetBrains와 Xcode는 자체 통합 기능을 통해 지원
설치한 줄 설치 프로그램, npm 또는 Homebrewchatgpt.com/download 또는 Microsoft Store에디터 마켓플레이스
가이드CLI 설치하기데스크톱 앱 설치하기에디터에 설치하기

잘 모르겠다면 CLI부터 시작하세요. 설치 용량이 작고, Codex가 무엇을 하는지 정확히 보여 주며, 설정한 모든 내용이 나머지 두 가지에도 그대로 적용됩니다.

설치하기 전에

  1. 계정. Codex가 포함된 요금제의 ChatGPT 계정으로 로그인하거나, API 요금으로 청구되는 OpenAI API 키를 사용합니다. ChatGPT 로그인 또는 API 키를 참고하세요.
  2. Git. 선택 사항이지만 권장합니다. Codex는 변경 사항을 검토하고 되돌릴 때 Git을 사용합니다. OpenAI는 각 작업 전후에 Git 체크포인트를 만들 것을 권장합니다.
  3. 운영 체제. 내 컴퓨터가 무엇을 지원하는지 시스템 확인으로 확인하세요.

설치한 후에

이 섹션의 페이지

  • Codex CLI 설치하기 OpenAI의 독립 실행형 설치 프로그램, npm 또는 Homebrew로 Codex CLI를 단계별로 설치하고, 로그인한 뒤 codex를 처음 실행하세요.
  • Codex 데스크톱 앱 설치하기 Codex 데스크톱 환경은 이제 ChatGPT 데스크톱 앱에 있습니다. macOS, Windows, Linux에 설치하고 프로젝트 폴더에서 Codex 채팅을 시작하는 방법입니다.
  • 에디터에 Codex 설치하기 VS Code, Cursor, Windsurf에 Codex IDE 확장 프로그램을 추가하고, JetBrains IDE와 Xcode에서 Codex를 활성화하는 방법을 공식 페이지 링크와 함께 안내합니다.
  • Windows에서 WSL2로 Codex 사용하기 Windows의 WSL2에서 Codex 실행하기: 데스크톱 앱 에이전트를 WSL로 전환하고, Linux 안에 CLI를 설치하고, CODEX_HOME으로 구성을 공유하고, WSL1 함정을 피하세요.
  • Codex 업데이트 또는 제거하기 설치할 때와 같은 방법으로 Codex CLI를 업데이트하고, 운영 체제별로 데스크톱 앱을 업데이트하고, ~/.codex 데이터까지 포함해 Codex를 깔끔하게 제거하세요.

자주 묻는 질문

CLI와 데스크톱 앱을 함께 설치할 수 있나요?

네. OpenAI 문서에 따르면 CLI와 IDE 확장 프로그램은 같은 구성 계층과 캐시된 로그인 정보를 공유합니다. MCP 서버 설정은 같은 컴퓨터의 데스크톱 앱, CLI, IDE 확장 프로그램이 함께 공유합니다.

Codex를 설치하려면 Node.js가 필요한가요?

npm 설치 방법을 선택할 때만 필요합니다. 공식 독립 실행형 설치 프로그램과 Homebrew는 Node.js가 필요하지 않습니다.

출처

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

다음 읽을거리