[Codex 입문 2/6] Codex App 시작하기 - Thread, Local, Worktree, Cloud

 

Codex 입문 시리즈 · 2/6

02

Codex의 작업 공간 이해하기

처음 열었을 때 헷갈리는 Thread, Local, Worktree, Cloud를 생활 언어로 정리

ThreadLocalWorktreeCloud

이번 회차 목차

1. Thread는 작업 기록이다
2. Local은 지금 내 폴더에서 일하는 모드
3. Worktree는 안전한 실험실이다
4. Cloud는 오래 걸리는 일을 맡기는 곳

Thread는 작업 기록이다

Codex에서 하나의 대화는 단순한 채팅방이 아니라 하나의 작업 기록입니다. 어떤 파일을 봤는지, 무슨 결정을 했는지, 어떤 검증을 했는지가 흐름으로 남습니다.

대화가 길어지면 Codex는 필요한 맥락을 압축해서 이어갑니다. 그래서 긴 작업을 하다가 '아까 뭐 했더라' 하고 처음부터 다시 설명할 필요가 줄어듭니다.

블로그 재포스팅처럼 여러 글을 순서대로 고치는 작업은 Thread 하나에 묶어두면 흐름이 살아납니다.

Local은 지금 내 폴더에서 일하는 모드

Local mode는 현재 컴퓨터의 프로젝트 폴더를 기준으로 일합니다. 글 원본, 이미지 폴더, 발행 스크립트처럼 내 디스크에 있는 자료를 직접 읽고 처리할 때 사용합니다.

Claude Cowork가 내 PC 파일을 정리해주는 느낌이었다면, Codex Local은 프로젝트 폴더 안에서 수정과 검증까지 같이 하는 느낌에 가깝습니다.

다만 중요한 폴더를 다룰 때는 권한 범위를 좁히고, 큰 변경 전에는 계획을 확인하는 습관이 좋습니다.

Worktree는 안전한 실험실이다

Worktree는 원본 프로젝트를 바로 건드리지 않고 별도 작업 공간에서 실험할 때 유용합니다. 새 기능을 만들거나 큰 구조 변경을 할 때 특히 안전합니다.

블로그 글 재구성이라면 원본 HTML을 유지한 채 새 버전을 만들고 비교할 수 있습니다. 코드 프로젝트라면 원래 브랜치와 분리된 공간에서 테스트할 수 있습니다.

AI에게 일을 맡길수록 '망치면 되돌릴 수 있는 공간'이 중요해집니다. Worktree는 그 안전장치 역할을 합니다.

Cloud는 오래 걸리는 일을 맡기는 곳

Cloud mode는 내 컴퓨터를 계속 붙잡아두지 않아도 되는 작업에 어울립니다. 리팩터링, 테스트 조사, 여러 파일 분석처럼 시간이 걸리는 일을 백그라운드로 넘기기 좋습니다.

반대로 지금 화면을 보면서 브라우저 확인, 로컬 파일 업로드, 즉시 발행 같은 작업은 Local에서 하는 편이 자연스럽습니다.

핵심은 작업 성격입니다. 내 컴퓨터 자료와 즉시 연결되면 Local, 독립적으로 오래 돌아가도 되면 Cloud가 좋습니다.

상황	추천 모드
대화로 글 구조를 잡고 싶다	Thread
내 폴더의 파일을 읽고 고치고 싶다	Local
실험하다가 실패해도 원본을 지키고 싶다	Worktree
오래 걸리는 분석을 맡기고 싶다	Cloud
브라우저에서 결과를 직접 확인해야 한다	Local + Browser

바로 써볼 프롬프트

내 프로젝트 폴더를 기준으로 작업하려고 해.
이 작업은 Local, Worktree, Cloud 중 어디가 맞는지 판단해주고,
실행 전에 확인해야 할 위험 요소와 검증 방법을 먼저 정리해줘.

이전편 보기1편 · Codex란 무엇인가? 다음편 가기3편 · Plan과 Goal로 일 맡기기

다음 편에서는 Codex에게 일을 잘 맡기는 프롬프트, Plan, Goal 사용법을 정리합니다.