Ch10. Codex App/IDE
Codex App의 Git 워크트리·인라인 diff·Plan Mode, IDE Auto/Full Access/Read-only 모드와 steering/resume API, in-app browser와 Chrome 확장까지 데스크톱·IDE 인터페이스 운영 가이드
데스크톱 26.908 (2026-09-11)
공식 통합 Changelog는 ChatGPT desktop app의 Pets Quick Chat과 Windows Appshots를 추가했습니다. Quick Chat은 macOS Option+Space, Windows Windows+Alt+P로 열고 @ context·$ skill을 사용할 수 있습니다. Windows Appshot은 양쪽 Alt 키로 현재 앱 창의 screenshot·사용 가능한 text를 공유합니다. 이 항목은 데스크톱 기능이며 CLI 0.154.0 명령과 구분합니다.
핵심 요약
- Codex App·IDE 확장·CLI는 동일한 config/skills/MCP 설정을 공유하며, App은 Git 워크트리로 여러 에이전트를 충돌 없이 병렬 실행하고 인라인 diff·Plan Mode를 제공합니다.
- IDE 확장은 Auto(작업 디렉토리 읽기/수정/실행, 외부 접근만 승인)·Full Access·Read-only 세 모드를
/permissions로 세션 중 전환합니다. - app-server를 직접 붙이는 팀은 active turn steering, resume_agent, approval/input 상태 복원으로 "멈췄다 다시 시키기" 대신 실행 중인 세션을 그대로 조정합니다(0.99.0~0.107.0).
- App 26.415~26.423은 in-app browser, PR sidebar, browser cookies 유지, diff reviewer comments를 더해 코드 편집기를 넘어 검증·리뷰 워크벤치로 넓어졌습니다.
- Chrome 확장은 로그인된 브라우저 상태가 필요한 작업에만 쓰고, browser history와 페이지 내용은 prompt injection 가능성이 있는 untrusted context로 취급해 별도 승인합니다.
Codex는 데스크톱 앱(Codex App), IDE 확장, CLI 세 가지 인터페이스를 제공합니다. 세 인터페이스 모두 동일한 config/skills/MCP 설정을 공유하면서, 각자 쓰임에 맞는 UX를 갖췄습니다.
Codex App (macOS & Windows 데스크톱)
Codex App은 멀티에이전트 병렬 작업에 최적화된 데스크톱 앱입니다.
핵심 기능
- 프로젝트별 스레드 관리: 사이드바에서 프로젝트 전환, 각 스레드가 독립 컨텍스트 유지
- Git 워크트리: 여러 에이전트가 같은 레포에서 충돌 없이 병렬 작업(격리된 브랜치)
- 인라인 diff 리뷰: 에이전트 변경사항을 앱 내에서 리뷰, 코멘트, 스테이지/리버트
- 스레드별 터미널: 각 스레드에서 독립적으로 테스트·빌드·스크립트 실행
- 자동화(Automations): Skills와 연동한 백그라운드 작업, 인박스에 결과 수집
- Plan Mode: 복잡한 변경을 읽기 전용으로 분석한 뒤 사용자와 논의 후 실행
운영 팁
- 워크트리 활용: 각 에이전트가 독립 워크트리에서 작업하므로, 메인 브랜치 오염 없이 여러 접근을 동시 시도
- Auto Context: IDE 확장과 공유되는 자동 컨텍스트로, 열린 파일/커서 위치 등이 연동
- 앱 ↔ CLI 연동:
codex app <path>로 CLI에서 앱 전환, 설정은 동기화 - CLI thread handoff: 0.138.0부터
/app으로 현재 CLI thread를 Desktop으로 넘길 수 있어, 터미널에서 시작한 조사를 앱의 review/worktree UI로 이어갈 수 있음
IDE 확장
app-server TUI 기본화 (0.117.0)
0.117.0부터 app-server-backed TUI가 기본값이 됐습니다. 팀 문서가 classic TUI 화면이나 흐름을 전제로 한다면, 이제는 app-server TUI 기준으로 캡처와 운영 가이드를 다시 정리하는 게 맞습니다.
모드(권한) 이해
IDE 확장은 기본적으로 Auto(Agent) 모드로 동작합니다.
| 모드 | 범위 | 승인 |
|---|---|---|
| Auto | 작업 디렉토리 읽기/수정/실행 | 외부 접근만 승인 |
| Full Access | 네트워크 포함 전체 접근 | 승인 없음(주의) |
| Read-only | 읽기만 허용 | 모든 변경 승인 |
/permissions로 세션 중 모드 전환이 가능합니다.
웹 검색(web search) 기본값
IDE 확장에는 1st-party 웹 검색 도구가 들어 있고, 기본은 캐시 모드입니다.
Full Access에서는 live 모드로 동작하므로, web_search 설정으로 팀 정책을 분명히 적어 두세요.
Cloud 위임
IDE에서 오래 걸리는 작업은 Codex Cloud로 넘길 수 있습니다. 진행 상황을 지켜보다가 완료되면 diff를 로컬에 적용하는 워크플로우를 지원합니다.
Steering/Resume API (0.99.0~0.107.0)
앱 서버를 직접 붙여 쓰는 고급 팀이라면, 최근 릴리스의 steering/resume 계열 API를 꼭 살펴보세요.
- active turn steering: 진행 중인 turn에 중간 지시를 넣어 방향을 조정
- resume_agent / thread resume: 연결이 끊겨도 agent 재개가 쉬움
- approval/input 상태 복원: 재연결 시 승인 대기나 추가 입력 대기 상태까지 복원
- notification opt-out / feature discovery: 내부 UI를 만들 때 필요한 이벤트만 구독 가능
이 기능의 핵심은 "긴 작업을 멈추고 다시 시키는" 대신 실행 중인 세션을 안전하게 계속 조정한다는 데 있습니다.
이미지 드래그&드롭
스크린샷이나 디자인 이미지를 프롬프트에 바로 넣으면 맥락 전달이 빨라집니다.
CLI에서도 codex -i screenshot.png "설명" 형태로 이미지를 첨부할 수 있습니다.
prompt history recall + /title (0.117.0)
- prompt history recall: app-server TUI에서 세션 간 prompt history recall이 동작해 반복 프롬프트 재사용이 쉬워졌습니다
/titleterminal-title picker: classic TUI와 app-server TUI 모두에서 터미널 제목을 분명하게 설정할 수 있어, 여러 세션을 병렬로 띄우는 팀에 유용합니다
Codex App 26.312: 테마 & 자동화 개편 (2026-03-12)
테마 커스터마이징
Codex App에서 외관을 자유롭게 바꿀 수 있습니다.
- 베이스 테마 선택: 라이트/다크 등 기본 테마 중 선택
- 색상 조정: 액센트, 배경, 전경 색상을 개별 조정
- 폰트 변경: UI 폰트와 코드 폰트를 각각 설정
- 테마 공유: 커스텀 테마를 팀원과 공유 가능
"팀 표준 테마"를 만들어 공유하면 스크린샷이나 화면 공유 때 환경을 일관되게 유지할 수 있습니다.
자동화(Automations) 개편
자동화 기능이 크게 강화됐습니다.
- 로컬 vs 워크트리 실행 선택: 자동화 작업을 메인 워킹 디렉토리에서 할지, 격리된 워크트리에서 할지 선택
- 커스텀 추론 수준/모델: 자동화별로 reasoning effort와 모델을 독립 지정
- 템플릿 기반 발견: 자동화 템플릿에서 영감을 얻어 빠르게 시작
운영 팁
자동화에서 "워크트리 실행"을 기본으로 두면 메인 브랜치를 더럽히지 않고 백그라운드 작업을 돌릴 수 있습니다. 추론 수준은 자동화 목적에 맞게 낮추면 비용을 아낄 수 있습니다.
Codex App 26.415: 작업 공간 확장 (2026-04-16)
26.415는 앱을 "코드 편집기 보조 UI"에서 작업 공간 전체를 다루는 워크벤치 쪽으로 끌어올린 릴리즈입니다.
검증/리뷰 표면 확장
- in-app browser: 로컬 개발 서버, 파일 기반 프리뷰, 로그인 없는 공개 페이지를 앱 안에서 열고 코멘트 가능
- PR sidebar workflow: GitHub PR을 사이드바에서 보고 diff/comment를 검토한 뒤 Codex에게 후속 수정과 검증을 계속 맡길 수 있음
- artifact viewer: PDF, spreadsheet, document, presentation 같은 생성 산출물을 사이드바에서 미리보기
- Memories: 반복되는 선호와 프로젝트 관례를 다음 스레드로 가져오는 메모리 surface가 더 전면화됨
시작/추적/지속 실행 UX
- Chats: 프로젝트 폴더 없이 스레드를 시작할 수 있어 리서치·기획·분석 작업 진입 비용이 낮아짐
- thread automations: 같은 스레드를 스케줄에 따라 다시 깨워 follow-up loop를 이어감
- task sidebar: plan, sources, generated artifacts, summary를 한곳에서 추적
- context-aware suggestions: 작업 시작 시점과 복귀 시점에 후속 액션 추천
환경/플랫폼 확장
- SSH remote connections alpha: 앱에서 원격 호스트 프로젝트를 직접 열어 작업 가능
- multiple terminals / multi-window: 병렬 실행과 분리된 확인 흐름을 더 쉽게 관리
- Intel Mac support + new plugins: Apple Silicon 외 Mac 지원이 넓어지고 플러그인 surface가 확장
운영 주의
in-app browser는 로그인/쿠키/브라우저 확장/기존 탭을 지원하지 않고, SSH remote connections는 아직 alpha입니다. 팀 표준에 넣을 때는 "인증 없는 프리뷰 검증"과 "원격 작업"을 따로 떼어 문서화하는 게 안전합니다.
Codex App 26.423: 브라우저·리뷰 워크플로우 심화 (2026-04-23)
26.423은 26.415에서 열어 둔 작업 공간을 실제 검증/코멘트 루프까지 끌고 간 릴리즈입니다.
브라우저 surface 현실화
- browser cookies 유지: 로그인된 프리뷰나 세션 기반 QA를 더 현실적으로 재현할 수 있음
- browser use 지원: 브라우저 상호작용을 작업 흐름 안에서 직접 다룰 수 있음
- browser on popout windows: 분리된 브라우저 창에서도 같은 워크플로우를 이어갈 수 있음
리뷰/산출물 흐름 확장
- diff reviewer comments: diff reviewer가 코멘트를 직접 남길 수 있어, 단순 확인을 넘어 리뷰 협업이 가능
- direct images to thread: 스크린샷/디자인 레퍼런스를 더 빨리 붙일 수 있음
- slides generate/edit + Figma integration: 코드 외 산출물을 앱 안에서 바로 만들고 수정하는 surface가 넓어짐
지속 실행 UX
- continue current task from notification: 알림에서 현재 task를 바로 이어가도록 진입 비용이 줄어듦
- automatic approval review: 승인 요청 전에 subagent review를 자동 실행하는 흐름이 앱 UX와 연결됨
운영 포인트
26.423 이후 App은 단순 데스크톱 셸이 아니라 브라우저 검증과 리뷰 코멘트까지 아우르는 워크벤치에 가까워졌습니다. 팀 표준 문서도 "코드 수정"과 "브라우저 검증"을 같은 흐름으로 묶어야 실제 쓰임과 맞습니다.
Codex App 26.608 계열: remote/MCP/Computer Use 보강 (2026-06-09~2026-06-11)
6월 초 앱 릴리즈는 대형 기능 하나보다 원격 연결과 작업 표면 안정화에 무게를 뒀습니다.
- remote connection 지원:
codex remote-control기반 연결 흐름이 앱과 더 잘 맞물림 - Composer thinking mode selector: 모델/추론 상태를 앱에서 더 명확히 선택
- active MCP servers 표시: 현재 세션에서 어떤 MCP 서버가 살아 있는지 앱 UI에서 확인 가능
- Computer Use rendering/responsiveness 개선: UI 자동화/검증 작업에서 화면 반응과 렌더링 신뢰도가 올라감
- mobile UX 보강: 모바일 입력 커서 이동, cancel button, setup/onboarding, startup memory, unsupported language 처리 개선
운영 기준:
- 앱에서 작업을 이어가기 전 active MCP server와 remote host를 확인
/apphandoff 후에는 앱의 모델/추론 선택이 CLI 설정과 맞는지/status또는 앱 status surface로 재확인- Computer Use 기반 검증은 스크린샷, 콘솔 로그, 재현 단계까지 함께 남겨 사람이 리뷰할 수 있게 보존
- 모바일 접근은 "UI 편의"가 아니라 연결된 host의 파일/자격증명/플러그인 접근 권한으로 취급
Codex for Chrome: 로그인 브라우저 작업 (2026-05-07)
Chrome 확장은 사용자의 로그인된 Chrome 상태가 필요한 웹사이트에서 Codex가 작업하도록 해줍니다. Salesforce, Gmail, LinkedIn, 사내 어드민처럼 plugin이나 in-app browser만으로는 부족한 작업에 맞습니다.
운영 기준은 분명하게 나눠 두세요.
- in-app browser 우선: localhost, file preview, 로그인 없는 공개 페이지 검증
- plugin 우선: GitHub, Slack, Google Drive처럼 전용 integration이 있는 업무
- Chrome 확장 사용: 로그인 상태, 실제 브라우저 프로필, 탭 그룹 기반 병렬 작업이 꼭 필요한 경우
보안 기준
Codex는 새 host를 쓸 때 승인을 요청하고, allowlist/blocklist로 사이트 접근을 관리합니다. browser history에는 민감한 내부 URL과 검색어가 섞일 수 있으니 항상 별도 승인 대상으로 두세요. 페이지 내용은 prompt injection 가능성이 있는 untrusted context로 다뤄야 합니다.
Codex Windows 앱 출시 (2026-03-04)
macOS에 이어 Windows 네이티브 앱이 나왔습니다.
- 네이티브 에이전트 샌드박스: 제한된 토큰, 파일시스템 ACL, 전용 격리 환경
- PowerShell 지원: Windows 개발 환경에 최적화
- 크로스 플랫폼 세션 동기화: ChatGPT 계정 기반으로 macOS/Windows 간 세션 이동
- 모든 ChatGPT 플랜 지원: Plus, Pro, Go, Free 모두 사용 가능
App 26.305 (2026-03-05)
- 원격 연결 개선: 오류 메시지와 상태 표시가 더 명확해짐
- Windows 통합 터미널에서 복사/붙여넣기 단축키 수정
- 보관된 고정 스레드가 사이드바에 다시 나타나는 버그 수정
$ 멘션 피커 개선 (0.114.0)
작성기에서 $를 입력하면 뜨는 멘션 피커가 개선됐습니다.
- 카테고리 라벨: Skills, Apps, Plugins가 명확히 구분 표시되어, 원하는 항목을 빠르게 찾을 수 있습니다
- 번들 시스템 스킬 비활성화: config에서 번들 시스템 스킬을 끌 수 있는 스위치가 추가되어, 팀에서 허용하는 스킬만 피커에 노출 가능
- 기존
@파일 첨부와$멘션을 조합하면, 컨텍스트+도구를 한 프롬프트에 정밀하게 지정할 수 있습니다
앱 세션 호환성 수정
0.114.0에서 지원되지 않는 세션인데도 앱이 활성화되던 버그가 수정됐습니다. 이전에 특정 세션 타입에서 앱 관련 오류가 났다면 업데이트하면 사라집니다.
배포 상태 엔드포인트: healthz/readyz (0.114.0)
WebSocket 기반 app-server 배포 환경에 헬스 체크 엔드포인트가 추가됐습니다.
GET /readyz: 서버가 요청을 받을 준비가 되었는지 확인(프로브용)GET /healthz: 서버가 정상 동작 중인지 확인(라이브니스 체크)- Kubernetes, ECS 등 오케스트레이터에서 readiness/liveness probe로 직접 연결 가능
- 예전엔 커스텀 헬스 체크를 직접 만들어야 했던 부분이 1st-party로 해결됨
app-server를 직접 운영하는 팀이라면, 배포 파이프라인에 이 엔드포인트를 바로 연결하세요.
Handoff 시 실시간 트랜스크립트 전달 (0.114.0)
에이전트 간 Handoff 때 실시간 트랜스크립트 컨텍스트가 함께 넘어갑니다. 예전엔 handoff 후 새 에이전트가 이전 대화 맥락을 잃었지만, 이제는 진행 중이던 대화 흐름이 자연스럽게 이어집니다.
고급 팁(시니어용)
@로 파일 첨부: 작성기에서@입력 → 퍼지 검색 → Tab/Enter로 삽입$로 도구 멘션: 작성기에서$입력 → Skills/Apps/Plugins 카테고리별 선택- 선택 영역 기반 컨텍스트: 필요한 부분만 컨텍스트로 추가
- 변경 검증 루틴: diff 확인 → 테스트 → 요약 순서 고정
- 세션 분리: 리팩토링/버그 수정 세션을 분리해 품질 유지
Enter중 주입: 실행 중에 Enter를 눌러 추가 지시를 중간에 삽입 가능- 이전 메시지 편집: 빈 작성기에서 Esc 두 번 → 이전 사용자 메시지 편집
- Fast/Standard 구분: 최신 TUI는 세션 헤더에 Fast/Standard를 보여주므로, 리뷰/민감 작업은 Standard로 내리는 규칙을 두기 좋음
참고 문서
- Codex App: https://developers.openai.com/codex/app (영어)
- Codex IDE 개요: https://developers.openai.com/codex/ide (영어)
- IDE 설정: https://developers.openai.com/codex/ide/settings (영어)
- IDE 기능(Cloud Tasks): https://developers.openai.com/codex/ide/features (영어)
- config 기본(web_search): https://developers.openai.com/codex/config-basic (영어)
Ch9. 멀티에이전트
default/worker/explorer/monitor 역할 분리, agents.max_threads/max_depth 설정, fork+steering과 spawn_agents_on_csv 배치, guardian 승인과 샌드박스 상속까지 멀티에이전트 병렬 워크플로우 운영
Ch11. MCP 연동
STDIO·Streamable HTTP MCP 서버 등록(codex mcp add), allowlist·enabled_tools·timeout 정책, resource/action 서버 분리와 plugin 마켓플레이스 라이프사이클로 외부 도구 연동을 통제하는 운영 가이드