Codex소개와 개념

시작하기와 사용 방식

Codex app, IDE 확장, CLI, Codex web을 어떤 상황에서 고르면 좋은지와 Local, Worktree, Cloud 모드의 차이를 입문 관점에서 정리합니다.

마지막 수정 2026년 3월 20일

기본 패턴

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

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

설명

  • Codex는 코드를 읽고, 수정하고, 명령을 실행할 수 있는 코딩 에이전트이며 App, IDE 확장, CLI, 웹이라는 여러 사용 방식에서 같은 핵심 개념을 공유합니다.
  • IDE 확장은 열린 파일과 선택 영역이 자동 컨텍스트로 들어가므로, 지금 보고 있는 코드 흐름을 빠르게 설명받거나 작은 수정을 반복할 때 가장 자연스럽습니다.
  • CLI는 명령 실행, 로그 확인, 재현 절차, 테스트 재실행처럼 검증 루프가 중요한 작업에 강합니다.
  • Codex app은 프로젝트와 스레드를 병렬로 다루고 Worktree, Automations, Git 기능까지 같이 관리할 때 장점이 큽니다.
  • Local은 가장 빠르지만 현재 체크아웃을 직접 만집니다. Worktree는 안전하게 실험을 격리하고, Cloud는 오래 걸리는 작업을 원격으로 넘겨 병렬화할 때 적합합니다.

짧은 예제

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

빠른 정리

선택지잘 맞는 작업
IDE extension열린 파일 중심 분석, 근거리 수정
CLI명령 실행, 로그 확인, 테스트 검증
Codex app멀티 프로젝트, Worktree, Automations
Codex web원격 장기 작업, GitHub 연결
Local현재 체크아웃을 바로 수정
Worktree본 작업을 건드리지 않고 실험 분리
Cloud원격 환경에서 병렬 실행

주의할 점

처음부터 가장 큰 권한이나 가장 무거운 사용 방식을 고를 필요는 없습니다. 가능한 한 좁은 방식과 안전한 모드에서 시작하고, 필요할 때만 Worktree나 Cloud로 넓히는 편이 관리가 쉽습니다.

참고 링크

3 sources