바로 보는 구조

빠른 선택
- IDE extension: 현재 열어 둔 파일을 바로 읽고 고칠 때
- CLI: 명령 실행, 로그 확인, 검증 루프를 자주 돌릴 때
- Codex app: 여러 프로젝트와 스레드를 병렬로 관리할 때
- Codex web: 긴 작업을 클라우드에서 백그라운드로 맡길 때

모드 선택
- Local: 현재 작업 디렉터리를 직접 수정
- Worktree: Git worktree로 변경을 격리
- Cloud: 원격 환경에서 병렬 실행

사용 방식

사용 방식마다 컨텍스트가 자동으로 잡히는 범위가 다르다

Codex는 App, IDE 확장, CLI, 웹이라는 여러 사용 방식에서 같은 핵심 개념을 공유하지만, 컨텍스트가 자동으로 잡히는 범위가 다릅니다. IDE 확장은 열린 파일과 선택 영역이 자동으로 컨텍스트로 들어가므로, 지금 보고 있는 코드 흐름을 빠르게 설명받거나 작은 수정을 반복할 때 가장 자연스럽습니다. CLI는 관련 파일 경로와 재현 절차를 명시적으로 줘야 하지만, 명령 실행과 로그 확인이 강합니다.

상황별 선택
- "열어 둔 API 파일 두 개의 요청 흐름을 설명해 줘" → IDE extension
- "버그를 재현하고 관련 테스트만 다시 돌려 줘" → CLI
- "A 프로젝트 수정 중인데 B 프로젝트 분석도 같이 돌리고 싶다" → Codex app
- "PR 리뷰나 장시간 리팩터링을 백그라운드로 맡기고 싶다" → Codex web / Cloud

Codex app은 멀티 프로젝트와 Worktree를 통합 관리하는 환경이다

Codex app은 프로젝트와 스레드를 병렬로 다루고 Worktree, Automations, Git 기능까지 같이 관리할 때 장점이 큽니다. 단일 파일 수정보다 여러 작업을 동시에 추적하고 싶을 때, 또는 자동화나 백그라운드 실행을 설정하고 싶을 때 CLI보다 앱이 더 적합합니다. 특히 diff pane, inline comment, chunk stage 같은 Git 검토 기능이 내장되어 있어 수정과 검증 루프를 같은 화면에서 이어갈 수 있습니다.

IDE extension
  -> 열린 파일 중심

CLI
  -> 명령 실행과 검증 중심

Codex app
  -> 멀티 스레드 / Worktree / Git review 중심

Codex web
  -> 장시간 클라우드 작업 중심

Local, Worktree, Cloud의 선택은 격리 수준과 실행 위치의 트레이드오프다

Local은 가장 빠르지만 현재 체크아웃을 직접 만집니다. 기존 수정과 Codex의 수정이 섞일 위험이 있습니다. Worktree는 Git worktree 위에 별도 체크아웃을 만들어 현재 작업을 보호하면서 실험을 격리하는 데 적합합니다. Cloud는 오래 걸리는 작업을 원격으로 넘겨 병렬화할 때 적합하며, 로컬 머신을 차지하지 않는 장점이 있습니다. 처음부터 가장 큰 권한이나 가장 무거운 사용 방식을 고를 필요는 없습니다.

가장 좁은 방식에서 시작하고 필요할 때만 넓히는 이유

좁은 방식에서 시작하면 결과 검토 비용이 낮고, 실수가 생겨도 영향 범위가 제한됩니다. 반대로 처음부터 Cloud나 full access로 시작하면, 프롬프트가 애매할 때 예상치 못한 수정이 넓게 퍼지고 검토하기 어려워집니다. 가능한 한 좁은 방식에서 시작하고, 필요할 때만 Worktree나 Cloud로 넓히는 편이 관리가 쉽습니다.

어디서 시작할까

주의할 점

❌ IDE에서 충분한데 바로 Cloud 작업부터 시작
❌ 현재 로컬 수정이 있는데 Local 모드로 큰 작업 위임

이 패턴은 검토 범위를 불필요하게 키우고, 기존 로컬 변경과 새 변경이 섞일 위험도 높입니다.