Codex 가이드 (1): Codex App 설치 방법

읽는데 5분 소요

codex 가이드 (1): Codex App 설치 방법

Codex를 처음 쓰는 사람에게 가장 헷갈리는 지점은 기능 설명보다 첫 설치 선택지다. 이 글은 OpenAI 공식 Quickstart 기준으로 App을 고르고, macOS와 Windows에서 설치한 뒤, 안전한 연습 폴더로 첫 메시지를 보내는 흐름만 정리한다.

핵심 한 줄: 처음이라면 공식 Quickstart에서 App을 선택하고, Mac은 Apple Silicon/Intel을 구분해 다운로드하며, Windows는 Microsoft Store 또는 winget install Codex -s msstore 경로를 따르면 된다.

목차

1. 공식 문서 기준
2. macOS와 Windows 설치 순서
3. 첫 실행과 안전한 실습
4. 리뷰 관점과 주의점
5. FAQ

공식 문서 기준

공식 문서에서 확인한 설치 관련 사실은 아래 정도면 충분하다. 여기서부터는 리뷰가 아니라 문서 기준 사실이다.

항목	공식 문서에서 확인한 내용
앱 제공 OS	Codex App은 macOS와 Windows에서 제공된다. Codex app
Mac 선택	Mac은 Apple Silicon용과 Intel용 다운로드가 나뉜다. Intel 기반 Mac이면 Intel 빌드를 선택한다. Quickstart
로그인	설치 후 Codex를 열고 ChatGPT 계정 또는 OpenAI API 키로 로그인한다. API 키 로그인은 일부 기능이 제한될 수 있다. Quickstart
첫 프로젝트	프로젝트 폴더를 선택한 뒤, 첫 메시지를 보내기 전에 Local이 선택되어 있는지 확인한다. Quickstart
Windows 대체 설치	Microsoft Store UI 대신 명령줄을 쓰려면 winget install Codex -s msstore를 사용할 수 있다. Windows app
Windows 환경	Windows 11이 권장 기준이고, 최신 Windows 10은 best effort로 안내된다. winget이 필요할 수 있다. Windows

▲ 공식 Quickstart의 App 선택, macOS Apple Silicon/Intel, Windows 다운로드 버튼 위치. OpenAI Developers Quickstart

설치 순서

Codex App은 여러 프로젝트와 스레드를 한 화면에서 다루는 데스크톱 경험이다. CLI나 IDE 확장도 있지만, 처음 설치 글에서는 앱부터 시작하는 편이 설명하기 쉽다.

▲ 공식 Codex App 소개에 실린 제품 화면. 프로젝트, 스레드, 변경 diff를 한 화면에서 다루는 구성을 보여준다. OpenAI Developers Codex app

macOS

1. Codex Quickstart를 연다.
2. Setup에서 App을 선택한다.
3. M1, M2, M3, M4 계열이면 Download for macOS (Apple Silicon)을 누른다.
4. Intel Mac이면 Download for macOS (Intel)을 누른다.
5. 설치 파일을 열고 안내에 따라 앱을 설치한다.

Windows

1. Codex Windows app 문서를 열거나 Quickstart의 Download for Windows를 누른다.
2. Microsoft Store 화면에서 설치를 진행한다.
3. 명령줄 설치가 편하면 PowerShell에서 아래 명령을 실행한다.

winget install Codex -s msstore

▲ 공식 Windows App 문서의 다운로드 섹션과 winget 설치 명령. OpenAI Developers Windows app

▲ Windows용 Codex App 공식 제품 화면. Windows에서도 프로젝트, 스레드, 리뷰 화면을 한 앱에서 다룬다. OpenAI Developers Windows app

첫 실행과 안전한 실습

설치가 끝나면 Codex를 열고 로그인한다. 일반 사용자는 ChatGPT 계정 로그인이 가장 자연스럽고, API 키 로그인은 가능하지만 일부 기능 제한이 있을 수 있다는 점을 문서가 따로 안내한다.

처음에는 실제 업무 저장소보다 연습용 폴더를 권한다. 개인 경로, 고객 데이터, 회사 저장소, 비공개 토큰이 섞인 폴더를 바로 열면 부담이 커진다.

mkdir codex-practice
cd codex-practice
printf "# Codex practice\n\nThis is a safe toy folder.\n" > README.md

연습 폴더를 프로젝트로 선택한 뒤, Local이 선택되어 있는지 확인하고 아래처럼 요청하면 된다.

이 폴더의 파일을 읽고 구조를 설명해줘.
아직 파일은 수정하지 말고, 내가 다음에 시도해볼 수 있는 작은 작업 3개만 제안해줘.

예상 흐름은 간단하다. Codex가 README를 읽고 폴더 상태를 요약한 뒤, 다음 작업 후보를 제안한다. 이 단계에서는 “설치가 끝났고, 프로젝트 폴더를 읽을 수 있고, Local 모드에서 대화가 시작된다”는 사실만 확인하면 충분하다.

▲ 설치 후 에디터 연결을 정리할 때 참고할 수 있는 Windows 설정 화면. OpenAI Developers Windows app

▲ Windows-native와 WSL2 중 어디서 에이전트를 실행할지 고르는 설정 화면. OpenAI Developers Windows app

리뷰 관점

좋은 점
App으로 시작하면 프로젝트 선택, 스레드 진행, 변경 diff, 터미널 확인을 한 화면에서 이어가기 쉽다. 초보자용 설치 글에는 CLI보다 설명 부담이 낮다.

주의할 점
Codex는 선택한 프로젝트 폴더를 기준으로 파일을 읽고 수정할 수 있다. 첫 실습은 꼭 더미 폴더나 공개 가능한 샘플 저장소로 시작하는 편이 안전하다.

맞는 독자
개발자, 기술 블로거, 작은 팀에서 반복 작업을 자동화해보고 싶은 사람에게 좋다. 비개발자도 파일 정리나 문서 작업으로 시작할 수 있다.

한계
계정, 워크스페이스, OS, 로그인 방식에 따라 보이는 기능이 다를 수 있다. 특히 API 키 로그인은 일부 기능 제한 가능성을 문서가 안내한다.

권한 설정은 설치 직후 한 번 확인해두면 좋다. 공식 Sandbox 문서는 기본 권한에서 Codex가 제한된 범위 안에서 작업하고, 범위를 넘을 때 승인 흐름으로 넘어간다고 설명한다. 초반에는 전체 접근보다 기본 권한으로 연습하는 편이 안전하다. Sandbox

FAQ

Q1. Mac에서 Apple Silicon과 Intel 중 무엇을 골라야 하나요?+

M1, M2, M3, M4처럼 M 시리즈 칩이면 Apple Silicon을 고릅니다. 오래된 Mac에서 프로세서가 Intel로 표시되면 Intel 빌드를 선택합니다.

Q2. Windows는 Microsoft Store만 가능한가요?+

공식 Windows App 문서는 Microsoft Store 경로와 함께 winget install Codex -s msstore 명령을 안내합니다. Store UI가 불편하면 PowerShell에서 이 명령을 사용할 수 있습니다.

Q3. Linux용 Codex App도 있나요?+

공식 App 페이지의 설치 영역은 macOS와 Windows 다운로드를 안내하고, Linux는 알림 신청 버튼으로 분리되어 있습니다. Linux 사용자는 CLI 또는 Cloud 흐름을 먼저 확인하는 편이 현실적입니다.

Q4. ChatGPT 계정 대신 API 키로 로그인해도 되나요?+

가능합니다. 다만 공식 Quickstart는 API 키 로그인 시 일부 기능이 제공되지 않을 수 있다고 안내합니다. 앱 기능을 폭넓게 확인하려면 ChatGPT 계정 로그인이 더 자연스럽습니다.

Q5. 설치 직후 실제 프로젝트를 열어도 되나요?+

가능하지만 첫 실습은 더미 폴더가 안전합니다. 만들 때 개인 경로, 비공개 파일명, 토큰, 회사 저장소 정보가 노출될 수 있기 때문입니다.

출처

• OpenAI Developers - Codex Quickstart
• OpenAI Developers - Codex app
• OpenAI Developers - Windows app
• OpenAI Developers - Windows
• OpenAI Developers - Sandbox