OpenAI Codex 완전가이드 4편 — Codex App 설치, Cloud 백그라운드 작업, MCP 서버 연동 실전

CLI에서 직접 Worktree 만들고 터미널 3개 열고 명령어 입력하는 건 3편에서 다 했습니다. 4편에서는 그 작업을 마우스 클릭 몇 번으로 처리하는 Codex App, 내 PC가 꺼져도 작업이 계속 되는 Codex Cloud, 그리고 GitHub/DB/외부 서비스를 Codex에 연결하는 MCP까지 다룹니다.

---

핵심 요약

→ Codex App: macOS + Windows 데스크탑 앱 — CLI의 모든 기능 + 시각적 UI
→ App 다운로드: codex app 명령어 또는 openai.com/codex
→ App의 핵심: Project(레포) → Thread(작업 단위) → Local/Worktree/Cloud 선택
→ Computer Use: Codex가 실제 macOS/Windows 앱 조작 (클릭, 타이핑, 스크린샷)
→ Codex Cloud: GitHub 연결 → OpenAI 서버에서 실행 → PC 꺼도 계속 → PR 자동 생성
→ Cloud 접근: chatgpt.com/codex 또는 App 내 Cloud Thread
→ Cloud 기본값: 네트워크 차단 (의존성 도메인 허용 목록 별도 설정)
→ MCP: codex mcp add 명령어 또는 config.toml 수동 편집
→ MCP 타입: STDIO(로컬 프로세스) / Streamable HTTP(원격 서버)
→ CLI + IDE 확장이 config.toml 공유 — MCP 한 번 설정하면 양쪽 다 적용
→ Codex를 MCP 서버로도 실행 가능 — 다른 에이전트가 Codex를 도구로 호출

---

실전 1 — Codex App 설치

방법 A: CLI에서 바로 실행 (가장 쉬움)

# 이미 Codex CLI 설치했다면
codex app
# → 앱이 설치되어 있으면 실행
# → 없으면 다운로드 링크 안내

방법 B: 직접 다운로드

macOS:
→ openai.com/codex 접속 → "Download for macOS" 클릭
→ .dmg 파일 다운로드 → 실행 → Applications 폴더로 드래그

Windows:
→ Microsoft Store에서 "Codex" 검색 → 설치
   또는 PowerShell:
   winget install OpenAI.Codex -s msstore

첫 실행 + 로그인

Codex App 실행
→ "Sign in with ChatGPT" 클릭
→ 브라우저 열림 → chatgpt.com 로그인
→ "Allow" 클릭
→ 앱으로 돌아오면 완료

---

실전 2 — App 화면 구조 이해

┌─────────────────────────────────────────────────────┐
│  PROJECTS          │  THREADS              │ 작업창  │
│  ─────────────    │  ──────────────────   │        │
│  📁 my-api        │  ● feature/auth      │ Thread │
│  📁 my-frontend   │    로그인 API 구현     │ 내용    │
│  📁 my-scripts    │  ● feature/products  │        │
│                   │    상품 목록 API       │        │
│  [+ Add Project]  │  ● Cloud Task #3     │        │
│                   │    백그라운드 실행 중  │        │
│  ─────────────   │                       │        │
│  Skills           │  [+ New Thread]       │        │
│  Automations      │                       │        │
│  MCP Servers      │                       │        │
└─────────────────────────────────────────────────────┘

각 영역 역할

PROJECTS (좌측):
→ 레포지토리 단위로 프로젝트 추가
→ 프로젝트마다 독립 AGENTS.md, config 적용
→ Skills, Automations, MCP Servers 설정 포함

THREADS (중앙):
→ 각 작업 단위 (CLI 세션과 동일 개념)
→ Local / Worktree / Cloud 세 가지 모드
→ 병렬 실행 중인 Thread 여러 개 동시 표시

작업창 (우측):
→ 선택한 Thread의 대화 내용
→ 파일 diff, 터미널 출력, 플랜 트래킹
→ Accept/Reject 버튼

---

실전 3 — Project 추가하기

좌측 패널 → [+ Add Project] 클릭
→ 폴더 선택 다이얼로그 열림
→ 작업할 레포 루트 폴더 선택
→ 프로젝트 목록에 추가됨

여러 레포 동시 관리

my-api (백엔드)
my-frontend (프론트엔드)
my-infra (인프라 코드)

→ 각자 다른 Thread에서 동시 작업 가능
→ 프로젝트 간 전환: 좌측 프로젝트 클릭

---

실전 4 — Thread 생성: Local vs Worktree vs Cloud

새 Thread를 만들 때 세 가지 모드 중 하나를 선택합니다.

[+ New Thread] 클릭 → 모드 선택 화면

┌─────────────────────────────────────────┐
│  새 Thread 만들기                        │
│                                         │
│  ○ Local                                │
│    현재 브랜치에서 직접 작업             │
│    내 PC에서 실행                        │
│                                         │
│  ○ Worktree                             │
│    별도 Git Worktree에서 격리 작업       │
│    기반 브랜치 선택 가능                 │
│                                         │
│  ○ Cloud                                │
│    OpenAI 서버에서 실행                  │
│    GitHub 연결 필요                      │
│    PC 꺼도 작업 계속                    │
│                                         │
│            [Create Thread]              │
└─────────────────────────────────────────┘

Worktree 선택 시 추가 옵션

기반 브랜치 선택:
○ main
○ develop
○ 현재 브랜치 (로컬 변경사항 포함)
○ 직접 입력

→ Create 클릭 → Git Worktree 자동 생성 (3편의 수동 작업 없이)
→ 완료 후 diff 확인 → Merge/Discard 클릭

App vs CLI Worktree 비교

CLI (3편에서 한 것):
git worktree add -b feature/auth ../my-api-auth main
cd ../my-api-auth
codex -a auto-edit "인증 API 구현해줘"
# 완료 후 수동 merge + remove

App (지금):
New Thread → Worktree → main 선택 → "인증 API 구현해줘" 입력
# 완료 후 Merge 버튼 클릭 → 자동 처리

---

실전 5 — Computer Use: Codex가 GUI 앱 조작

Computer Use는 Windows에서도 지원됩니다 (2026년 5월 29일 업데이트). Codex가 실제로 macOS/Windows 앱을 보고, 클릭하고, 타이핑합니다.

첫 사용 시 권한 설정 (한 번만)

Thread에서 Computer Use 관련 작업 입력
→ "접근성 권한이 필요합니다" 팝업
→ macOS: 시스템 설정 → 개인 정보 보호 → 접근성 → Codex 허용
→ Windows: UAC 프롬프트 → 허용
→ 스크린샷 권한도 허용

실전 사용 예시

# 예시 1: Figma 디자인 보고 코드 수정
"Figma 열어서 pricing 페이지의 버튼 색상이 뭔지 확인하고
 src/components/PricingButton.tsx 에 정확히 반영해줘"

# 예시 2: 로컬 서버 UI 테스트
"localhost:3000 열어서 로그인 폼 테스트해봐.
 잘못된 이메일 입력했을 때 에러 메시지 제대로 나오는지 확인하고
 안 나오면 고쳐줘"

# 예시 3: 스크린샷 기반 버그 수정
(스크린샷 첨부 후)
"이 UI 버그 보여? 모바일에서 네비게이션이 겹쳐 있어. 고쳐줘"

보안 주의사항

⚠️ Computer Use는 요청할 때만 활성화됨 (백그라운드 상시 실행 아님)
⚠️ 모든 보이는 창과 입력 필드에 접근 가능
⚠️ 민감한 정보(비밀번호, API 키) 화면에 띄워둔 채로 작업 요청 금지
⚠️ EEA(유럽경제지역), 영국, 스위스에서는 현재 미지원

---

실전 6 — Codex Cloud: PC 꺼도 작업 계속

Cloud Thread가 필요한 상황

✅ Cloud 쓰는 경우:
- "밤에 레거시 코드 전체 리팩토링해줘" (2~3시간 작업)
- 퇴근 후 작업 돌려두고 출근 때 결과 확인
- 코드베이스가 너무 커서 로컬 리소스 부족할 때
- CI/CD 파이프라인에서 자동 실행

✅ Local/Worktree 쓰는 경우:
- 빠른 버그 수정 (5~10분)
- 실시간 피드백 주면서 작업
- 네트워크 없는 환경
- 민감한 코드 (서버 전송 원치 않을 때)

GitHub 연결 (Cloud 필수 설정)

방법 A: App에서 연결
Codex App → 좌측 패널 Settings → GitHub
→ "Connect GitHub" 클릭
→ GitHub OAuth 인증
→ 허용할 레포 선택 (전체 or 특정 레포)

방법 B: chatgpt.com에서 연결
chatgpt.com/codex 접속
→ "Connect a repository" 클릭
→ GitHub 인증 → 레포 선택

Cloud Thread 시작하기

방법 A: App에서
New Thread → Cloud 선택 → 브랜치 선택 → 작업 입력
→ 백그라운드 실행 시작
→ 진행 상황 실시간 확인 가능
→ PC 꺼도 계속 실행됨

방법 B: chatgpt.com/codex에서
좌측 "New task" 클릭
→ 레포 선택 → 브랜치 선택
→ 작업 설명 입력 → "Code" 클릭

방법 C: CLI에서 Cloud 작업 론칭
codex cloud "인증 모듈 완전히 리팩토링해줘" \
  --repo my-org/my-project \
  --branch feature/auth-refactor \
  --env python3.12  # 환경 지정

Cloud 작업 진행 상황 확인

chatgpt.com/codex 접속 → 실행 중 작업 목록
→ 각 태스크: 진행 단계, 터미널 로그, 파일 변경사항 실시간 표시
→ 완료되면 이메일 알림
→ 결과: Draft PR 자동 생성 or diff 다운로드

Cloud 보안 설정

기본값: 네트워크 완전 차단

패키지 설치 필요할 때 (npm install, pip install):
chatgpt.com/codex → Settings → Network
→ "Allow software dependencies" 토글 ON
→ 또는 특정 도메인만 허용 목록 추가:
   registry.npmjs.org
   pypi.org
   files.pythonhosted.org

Cloud 작업 완료 후 처리

결과 확인 → "Open Pull Request" 클릭
→ GitHub에 Draft PR 생성됨
→ PR에서 파일 변경사항 리뷰
→ 피드백 남기면 Codex가 추가 커밋으로 수정
→ 만족하면 → "Merge" 클릭

또는 로컬로 가져오기:
git fetch origin feature/codex-task
git checkout feature/codex-task
git diff main

---

실전 7 — MCP 서버 연결

MCP를 연결하면 Codex가 코드베이스 밖의 정보에도 접근할 수 있습니다.

MCP 추가 방법: 명령어 (가장 쉬움)

# Context7 (개발자 문서 MCP) 추가
codex mcp add context7 -- npx -y @upstash/context7-mcp

# GitHub MCP 추가
codex mcp add github \
  --env GITHUB_TOKEN=ghp_여기에토큰 \
  -- npx -y @modelcontextprotocol/server-github

# 추가된 MCP 목록 확인
codex mcp list

# MCP 제거
codex mcp remove github

MCP 추가 방법: config.toml 직접 편집

cat >> ~/.codex/config.toml << 'EOF'

# GitHub MCP
[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
[mcp_servers.github.env]
GITHUB_TOKEN = "ghp_여기에토큰입력"

# 파일시스템 MCP (특정 폴더 접근)
[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/cell/projects"]

# Context7 (문서 검색)
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
EOF

자주 쓰는 MCP 서버 목록

MCP 서버 패키지 무엇을 할 수 있나

GitHub	@modelcontextprotocol/server-github	이슈/PR/코드 읽기, PR 생성
Filesystem	@modelcontextprotocol/server-filesystem	지정 폴더 외부 파일 접근
Context7	@upstash/context7-mcp	최신 라이브러리 문서 검색
Postgres	@modelcontextprotocol/server-postgres	DB 스키마 읽기, 쿼리 실행
Slack	@modelcontextprotocol/server-slack	채널 메시지 읽기/전송
Linear	@modelcontextprotocol/server-linear	이슈 조회/생성
Notion	Notion 공식 MCP	페이지 읽기/업데이트

GitHub MCP 실전 사용

codex

# MCP 연결 후 이런 작업 가능:
> @github 현재 오픈된 PR 중 리뷰 대기 중인 것 목록 보여줘

> @github issue #42 내용 읽고 해결 코드 작성해줘

> @github 이 변경사항으로 feature/auth 브랜치에서 main으로 PR 만들어줘.
  제목: "feat: JWT 인증 API 추가"
  설명에 변경 파일 목록 포함해줘

Postgres MCP 실전 사용

# ~/.codex/config.toml에 추가
[mcp_servers.database]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres"]
[mcp_servers.database.env]
POSTGRES_CONNECTION_STRING = "postgresql://user:pass@localhost:5432/mydb"

> @database users 테이블 스키마 보여줘

> @database 최근 7일간 로그인 횟수가 0인 유저 조회 쿼리 작성하고
  그 유저들에게 재활성화 이메일 보내는 서비스 코드 구현해줘

Codex를 MCP 서버로 실행 (고급)

Codex 자체를 다른 에이전트나 도구가 호출할 수 있는 MCP 서버로 실행할 수 있습니다.

# Codex를 MCP 서버로 실행
codex mcp serve

# 다른 에이전트의 config에서 Codex를 도구로 등록
[mcp_servers.codex]
command = "codex"
args = ["mcp", "serve"]

---

실전 8 — Automations: 반복 작업 자동화

App의 Automations 기능으로 정기적인 작업을 스케줄링합니다.

App 좌측 → Automations → [+ New Automation]

예시 1: 매일 아침 코드 리뷰 리포트
트리거: 매일 오전 9시
작업: "어제 머지된 PR들 리뷰하고 품질 리포트 slack으로 보내줘"
MCP: GitHub + Slack

예시 2: 테스트 실패 시 자동 수정
트리거: CI 실패 웹훅
작업: "실패한 테스트 원인 파악하고 수정 PR 만들어줘"
MCP: GitHub

예시 3: 주간 기술 부채 리포트
트리거: 매주 금요일 오후 5시
작업: "이번 주 추가된 TODO 주석, 하드코딩된 값, 
       deprecated 함수 사용 집계해서 Linear에 이슈로 등록해줘"
MCP: GitHub + Linear

---

실전 9 — VS Code 확장 설치

CLI와 App 외에 VS Code 안에서 바로 Codex를 쓸 수 있습니다.

VS Code 열기
→ Extensions (Ctrl+Shift+X)
→ "Codex" 검색 → "OpenAI Codex" 설치

설정:
VS Code 우상단 → 기어 아이콘 → Codex Settings
→ config.toml 열기 (CLI와 동일한 파일 공유)
→ MCP 서버 설정도 동일하게 적용됨

VS Code 확장 사용법

인라인 에이전트:
코드 선택 → Ctrl+I (또는 우클릭 → "Codex: Edit")
→ "에러 핸들링 추가해줘" 입력

사이드 패널:
좌측 사이드바 Codex 아이콘 → Chat 패널 열기
→ CLI와 동일한 세션 (컨텍스트 공유됨!)

---

마무리

기능 접근 방법 언제

CLI	codex 터미널	빠른 단일 작업, 스크립트
App Local	Codex App → Local Thread	실시간 개발, GUI 필요
App Worktree	Codex App → Worktree Thread	병렬 작업 (CLI 없이)
App Cloud	Codex App → Cloud Thread	장시간 백그라운드
Cloud Web	chatgpt.com/codex	PC 없을 때, 모바일
VS Code 확장	IDE 안에서	IDE 벗어나기 싫을 때
Computer Use	App → GUI 작업 요청	Figma, 브라우저 테스트
MCP	codex mcp add	GitHub, DB, Slack 연동

CLI가 익숙해졌다면 App으로 올라가는 게 자연스러운 다음 단계입니다. Worktree 관리, Cloud 작업, MCP 설정이 모두 UI 안에서 해결됩니다. 특히 Cloud Thread + GitHub MCP 조합은 — 이슈 열고 작업 설명 쓰면 PR까지 자동으로 만들어지는 사이클이 가능해집니다.

5편에서는 가격 구조 상세 계산, CI/CD 파이프라인 자동화, 그리고 Claude Code vs Codex vs Copilot vs Kiro 최종 정리까지 씁니다.

---

관련 글

• OpenAI Codex 완전가이드 1편 — 설치부터 첫 실행까지
• OpenAI Codex 완전가이드 2편 — 승인 모드, 샌드박스, AGENTS.md
• OpenAI Codex 완전가이드 3편 — Git Worktree 병렬 에이전트
• OpenAI Codex 완전가이드 4편 — Codex App, Cloud, MCP 연동
• OpenAI Codex 완전가이드 5편 — 가격, CI/CD 자동화, Claude Code vs Codex 최종 비교