Cmd. /worktree
Codex CLI의 새 세션·fork를 격리 git checkout으로 실행하고 worktree 소유 정보·삭제 확인을 구분하는 방법을 설명합니다.
핵심 요약
- Codex CLI의 새 세션·fork를 격리 git checkout으로 실행하고 worktree 소유 정보·삭제 확인을 구분하는 방법을 설명합니다.
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
Codex CLI의 새 세션·fork를 격리 git checkout으로 실행하고 worktree 소유 정보·삭제 확인을 구분하는 방법을 설명합니다.
/worktree사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 실험 기능 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Codex CLI 0.155.1 |
| 릴리스 근거 | v0.154.0 |
0.154.0 릴리스에서 확인된 실험 기능입니다. Git 저장소와 지원 빌드가 필요하며 CLI에는 --worktree도 있습니다.
사용 예
/experimental
/worktree/worktree와 CLI의 --worktree는 실험적 worktree 세션 흐름을 제공합니다. 새 작업이나 fork를 별도 checkout으로 분리하고 해당 세션을 탐색·재개할 수 있습니다.
codex --worktree기존 작업의 branch와 checkout 위치를 확인한 뒤 격리 세션을 시작하세요. 0.155.0의 agents 화면은 worktree 소유 정보를 보여주고, 관리되는 clean worktree를 삭제할 때 확인을 받습니다. archive와 worktree 삭제는 같은 작업이 아니므로 세션 기록과 파일 보존을 각각 확인합니다.
더 자세한 흐름은 세션 수명주기를 참고하세요.
실행 결과와 유지 범위
별도의 Git worktree에서 새 작업을 시작하거나 대화를 분기합니다. 새 checkout의 경로와 브랜치를 확인합니다.
주의사항
0.154.0 릴리스에서 확인된 실험 기능입니다. Git 저장소와 지원 빌드가 필요하며 CLI에는 --worktree도 있습니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록