Codex 앱 기능
Codex 앱은 여러 Codex 스레드를 병렬로 다루기 위한 집중형 데스크톱 경험입니다. 워크트리 지원, 자동화, Git 기능이 기본으로 포함됩니다.
대부분의 Codex 앱 기능은 macOS와 Windows 모두에서 사용할 수 있습니다. 플랫폼별 예외는 아래 섹션에서 별도로 설명합니다.
프로젝트 간 멀티태스킹
하나의 Codex 앱 창에서 여러 프로젝트의 작업을 실행할 수 있습니다. 코드베이스마다 프로젝트를 추가하고 필요할 때 전환합니다.
Codex CLI를 사용해 봤다면, 앱의 프로젝트는 특정 디렉터리에서 세션을 시작하는 것과 비슷합니다.
하나의 저장소에 둘 이상의 앱이나 패키지가 있다면, 서로 다른 프로젝트를 앱 프로젝트로 나누는 것이 좋습니다. 이렇게 하면 샌드박스가 해당 프로젝트 파일만 포함합니다.
스킬 지원
Codex 앱은 CLI 및 IDE 확장과 같은 에이전트 스킬을 지원합니다. 사이드바의 스킬을 클릭하면 팀이 여러 프로젝트에서 만든 새 스킬도 보고 탐색할 수 있습니다.
자동화
자동화와 스킬을 결합해 텔레메트리 오류를 평가하고 수정 사항을 제출하거나 최근 코드베이스 변경 보고서를 만드는 등의 반복 작업을 수행할 수 있습니다. 진행 중인 작업을 같은 스레드에 유지해야 한다면 스레드 자동화를 사용합니다.
모드
각 스레드는 선택한 모드에서 실행됩니다. 스레드를 시작할 때 다음 중 하나를 고를 수 있습니다.
- Local: 현재 프로젝트 디렉터리에서 직접 작업합니다.
- Worktree: Git 워크트리에서 변경 사항을 격리합니다. 자세한 내용은 워크트리를 참고하십시오.
- Cloud: 구성된 클라우드 환경에서 원격 실행합니다.
Local과 Worktree 스레드는 모두 사용자의 컴퓨터에서 실행됩니다.
내장 Git 도구
Codex 앱은 일반적인 Git 기능을 앱 안에서 제공합니다.
Diff 패널은 로컬 프로젝트나 워크트리 체크아웃의 변경 사항을 Git diff로 보여 줍니다. 특정 청크나 전체 파일에 Codex가 처리할 인라인 코멘트를 추가할 수 있고, 청크 또는 파일 단위로 스테이징하거나 되돌릴 수도 있습니다.
로컬 및 워크트리 작업에 대해 Codex 앱 안에서 커밋, 푸시, pull request 생성을 직접 수행할 수 있습니다.
워크트리 지원
새 스레드를 만들 때 Local 또는 Worktree를 선택합니다. Local은 프로젝트 안에서 직접 작업합니다. Worktree는 새 Git 워크트리를 만들어 일반 프로젝트와 변경 사항을 격리합니다.
현재 작업을 건드리지 않고 새 아이디어를 시험하거나, 같은 프로젝트에서 독립 작업을 나란히 실행하고 싶을 때 Worktree를 사용합니다.
Git 저장소의 자동화는 전용 백그라운드 워크트리에서 실행되고, 버전 관리되지 않는 프로젝트에서는 프로젝트 디렉터리에서 직접 실행됩니다.
통합 터미널
각 스레드에는 현재 프로젝트 또는 워크트리 범위의 내장 터미널이 포함됩니다. 앱 오른쪽 위의 터미널 아이콘을 누르거나 Cmd+J를 눌러 토글합니다.
터미널을 사용해 앱을 떠나지 않고 변경 사항 검증, 스크립트 실행, Git 작업을 수행할 수 있습니다. Codex는 현재 터미널 출력도 읽을 수 있으므로 실행 중인 개발 서버 상태를 확인하거나 실패한 빌드 출력을 다시 참고하며 작업할 수 있습니다.
일반적인 작업:
git statusgit pull --rebasepnpm test또는npm testpnpm run lint같은 프로젝트 명령
정기적으로 실행하는 작업이 있다면 로컬 환경 안에 액션을 정의해 Codex 앱 창 상단에 바로가기 버튼을 추가할 수 있습니다.
Cmd+K는 Codex 앱의 명령 팔레트를 엽니다. 터미널을 지우지 않습니다. 터미널을 지우려면 Ctrl+L을 사용합니다.
네이티브 Windows 샌드박스
Windows에서는 WSL이나 가상 머신 없이 Codex가 PowerShell에서 네이티브 Windows 샌드박스로 실행될 수 있습니다. 이렇게 하면 제한된 권한을 유지하면서 Windows 네이티브 워크플로에 머무를 수 있습니다.
Windows 설정과 샌드박싱을 참고하십시오.
음성 받아쓰기
음성으로 Codex에 프롬프트를 입력할 수 있습니다. 작성기가 보이는 동안 Ctrl+M을 누른 채 말하면 음성이 텍스트로 변환됩니다. 변환된 프롬프트를 편집하거나 바로 전송해 Codex가 작업을 시작하게 할 수 있습니다.
플로팅 팝아웃 창
활성 대화 스레드를 별도 창으로 분리해 현재 작업 위치 근처로 옮길 수 있습니다. 브라우저, 편집기, 디자인 미리보기 근처에 스레드를 두고 빠르게 반복해야 하는 프론트엔드 작업에 적합합니다.
워크플로 전반에서 창이 계속 보이도록 팝아웃 창을 항상 위 상태로 전환할 수도 있습니다.
인앱 브라우저
인앱 브라우저를 사용하면 웹 앱을 반복 개발하는 동안 로컬 개발 서버, 파일 기반 미리보기, 로그인 필요 없는 공개 페이지를 미리 보고 리뷰하고 코멘트할 수 있습니다.
인앱 브라우저는 인증 흐름, 로그인된 페이지, 일반 브라우저 프로필, 쿠키, 확장 프로그램, 기존 탭을 지원하지 않습니다.
브라우저 코멘트를 사용해 페이지의 특정 요소나 영역을 표시한 뒤 Codex에 해당 피드백을 처리하도록 요청할 수 있습니다.
Codex가 페이지를 직접 조작해야 할 때는 로컬 개발 서버와 파일 기반 페이지에 대해 브라우저 사용을 사용합니다. 브라우저 플러그인, 허용 웹사이트, 차단 웹사이트는 설정에서 관리할 수 있습니다.
컴퓨터 사용
컴퓨터 사용은 Codex가 macOS 앱을 보고, 클릭하고, 입력할 수 있게 합니다. 데스크톱 앱 테스트, 브라우저 또는 시뮬레이터 흐름 점검, 플러그인으로 사용할 수 없는 데이터 소스 작업, 앱 설정 변경, GUI에서만 재현되는 버그 확인에 유용합니다.
컴퓨터 사용은 프로젝트 작업 공간 밖의 앱과 시스템 상태에 영향을 줄 수 있으므로 작업 범위를 좁게 유지하고 계속하기 전에 권한 프롬프트를 검토하십시오.
이 기능은 출시 시점에 유럽경제지역, 영국, 스위스에서는 사용할 수 없습니다.
코드가 아닌 산출물 작업
작업이 코드가 아닌 산출물을 생성하면 사이드바에서 PDF, 스프레드시트, 문서, 프레젠테이션을 미리 볼 수 있습니다. Codex에 원본 데이터, 원하는 파일 형식, 구조, 중요하게 보는 검토 기준을 알려 주십시오.
스프레드시트와 프레젠테이션의 경우 중요한 시트, 열, 차트, 슬라이드 섹션, 확인 항목을 설명합니다. Codex에게 결과를 어디에 저장했는지, 어떻게 확인했는지 설명해 달라고 요청하십시오.
스레드가 실행되는 동안 작업 사이드바로 Codex가 무엇을 하는지 따라갈 수 있습니다. 사이드바는 에이전트의 계획, 소스, 생성 산출물, 작업 요약을 표시할 수 있으므로 작업을 조정하고 생성 파일을 검토하고 추가 확인이 필요한지 판단할 수 있습니다.
IDE 확장과 동기화
편집기에 Codex IDE Extension이 설치되어 있으면 Codex 앱과 IDE 확장은 같은 프로젝트에 있을 때 자동으로 동기화됩니다.
동기화되면 Codex 앱 작성기에 IDE context 옵션이 보입니다. "Auto context"를 활성화하면 Codex 앱이 사용자가 보고 있는 파일을 추적하므로 "이 파일은 어떤 역할이야?"처럼 간접적으로 참조할 수 있습니다. Codex 앱에서 실행 중인 스레드를 IDE 확장 안에서 볼 수도 있고, 반대로 IDE 확장 스레드를 앱에서 볼 수도 있습니다.
앱에 컨텍스트가 포함되는지 확실하지 않다면 토글을 끄고 같은 질문을 다시 해 결과를 비교하십시오.
스레드 자동화
자동화는 단일 스레드에 붙을 수도 있습니다. 스레드 자동화는 스레드 컨텍스트를 보존하는 반복 호출로, Codex가 장기 실행 작업을 확인하거나 소스에서 새 정보를 폴링하거나 후속 반복을 계속할 수 있게 합니다. 같은 대화로 일정에 따라 계속 돌아와야 하는 하트비트 방식 자동화에 사용하십시오.
다음 실행이 현재 대화에 의존한다면 스레드 자동화를 사용합니다. 하나 이상의 프로젝트에 대해 새 반복 작업을 시작하려면 독립형 또는 프로젝트 자동화를 사용합니다.
승인과 샌드박싱
승인 및 샌드박스 설정은 Codex 동작을 제한합니다.
- 승인은 명령 실행 전에 Codex가 언제 권한을 위해 멈출지 결정합니다.
- 샌드박스는 Codex가 사용할 수 있는 디렉터리와 네트워크 접근을 제어합니다.
“approve once” 또는 “approve for this session” 같은 프롬프트가 보이면 서로 다른 범위의 도구 실행 권한을 부여하는 것입니다. 확실하지 않다면 가장 좁은 옵션을 승인하고 반복하십시오.
기본적으로 Codex는 현재 프로젝트로 작업 범위를 제한합니다. 대부분의 경우 이것이 적절한 제약입니다.
작업에 둘 이상의 저장소나 디렉터리가 필요하다면 Codex가 프로젝트 루트 밖을 돌아다니게 하는 대신 별도 프로젝트를 열거나 워크트리를 사용하는 편을 권장합니다.
작업 공간에서 자동 리뷰를 사용할 수 있으면 권한 선택기에서 선택할 수 있습니다. 자동 리뷰는 같은 샌드박스 경계를 유지하되, 대상 승인 요청을 사용자를 기다리지 않고 구성된 검토 정책으로 라우팅합니다.
상위 개요는 샌드박싱을 참고하십시오. 구성 세부 정보는 에이전트 승인 및 보안 문서를 참고하십시오.
MCP 지원
Codex 앱, CLI, IDE 확장은 Model Context Protocol(MCP) 설정을 공유합니다. 이미 한 표면에서 MCP 서버를 구성했다면 다른 표면에서도 자동으로 채택됩니다. 새 서버를 구성하려면 앱 설정의 MCP 섹션을 열고 권장 서버를 활성화하거나 구성에 새 서버를 추가합니다.
웹 검색
Codex에는 자사 웹 검색 도구가 포함됩니다. Codex 앱의 로컬 작업에서 Codex는 기본적으로 웹 검색을 활성화하고 검색 캐시에서 결과를 제공합니다. 샌드박스를 전체 접근으로 구성하면 웹 검색은 기본적으로 실시간 결과를 사용합니다. 웹 검색을 비활성화하거나 최신 데이터를 가져오는 실시간 결과로 전환하려면 구성 기본을 참고하십시오.
이미지 생성
스레드 안에서 Codex에게 이미지를 생성하거나 편집하도록 요청할 수 있습니다. UI 자산, 배너, 배경, 일러스트레이션, 스프라이트 시트, 자리 표시자를 코드와 함께 만들 때 유용합니다. 기존 자산을 변환하거나 확장하고 싶으면 참조 이미지를 추가하십시오.
자연어로 요청하거나 프롬프트에 $imagegen을 포함해 이미지 생성 스킬을 명시적으로 호출할 수 있습니다.
내장 이미지 생성은 gpt-image-2를 사용하고 일반 Codex 사용 한도에 포함됩니다. 품질과 크기에 따라 평균적으로 이미지 생성이 없는 유사 턴보다 포함 한도를 3-5배 빠르게 사용합니다. 자세한 내용은 가격 정책을 참고하십시오.
프롬프트 팁과 모델 세부 정보는 이미지 생성 가이드를 참고하십시오.
더 큰 이미지 생성 배치에는 환경 변수에 OPENAI_API_KEY를 설정하고 Codex에게 API를 통해 이미지를 생성하게 요청하면 API 가격이 적용됩니다.
이미지 입력
이미지를 프롬프트 작성기로 끌어다 놓아 컨텍스트로 포함할 수 있습니다. 이미지를 컨텍스트에 추가하려면 드롭할 때 Shift를 누릅니다.
시스템의 이미지를 Codex에게 보게 할 수도 있습니다. 작업 중인 앱의 스크린샷을 찍는 도구를 Codex에 제공하면 Codex가 수행 중인 작업을 검증할 수 있습니다.
채팅
채팅은 특정 프로젝트 폴더나 Git 저장소가 필요 없는 작업을 시작할 수 있는 스레드입니다. 연구, 분류, 계획 수립, 플러그인 중심 워크플로, 코드베이스 편집 대신 연결된 도구를 사용해야 하는 대화에 사용합니다.
채팅은 Codex 홈 아래 Codex 관리 threads 디렉터리를 작업 위치로 사용합니다. 기본 위치는 ~/.codex/threads입니다.
메모리
사용 가능한 경우 메모리를 통해 Codex가 과거 작업의 유용한 컨텍스트를 미래 스레드로 가져갈 수 있습니다. 안정적인 선호, 프로젝트 관례, 반복 작업 패턴, 매번 다시 설명해야 하는 알려진 문제 패턴에 가장 유용합니다.
알림
기본적으로 Codex 앱은 앱이 백그라운드에 있을 때 작업이 완료되거나 승인이 필요하면 알림을 보냅니다.
Codex 앱 설정에서 알림을 보내지 않거나, 앱이 포커스 상태여도 항상 보내도록 선택할 수 있습니다.
컴퓨터 절전 방지
작업이 완료되는 데 시간이 걸릴 수 있으므로, Codex 앱 설정의 "Prevent sleep while running" 토글을 활성화해 작업 중 컴퓨터가 잠들지 않게 할 수 있습니다.