12장. 동시 작업과 원격
필수 이 단계를 따라가려면 꼭 읽으세요.한 줄 요약: Git으로 첫 기록을 남기면 worktree로 작업 폴더를 나눠 일을 나란히 맡길 수 있습니다.
이 장의 화면은 2026년 11월 6일 리눅스에서 Claude Code 2.1.318로 실행한 결과입니다. 폴더 경로와 요금제 이름은 이 강좌에 맞게 바꿔 적었습니다.
지금 상태를 저장해 두고, 본 폴더를 건드리지 않는 작업 폴더를 만들어 봅니다.
Git으로 첫 기록 남기기
Git은 폴더의 변경 내역을 저장해 두는 프로그램입니다. 저장한 시점 하나를 커밋(Commit)이라고 부릅니다. 게임의 저장 지점과 비슷합니다. 기록이 쌓이는 폴더는 저장소(Repository)라고 부릅니다.
왜 지금 필요할까요? 이유는 두 가지입니다.
- 7장의 되감기는 Claude의 편집 도구가 고친 파일만 되돌립니다. Bash 명령으로만 바뀐 파일은 추적하지 않습니다. 그런 파일을 되돌리려면 Git 같은 버전 관리를 씁니다.[1]
- 다음 절의 worktree는 커밋에서 만들어집니다. 저장소에 커밋이 하나는 있어야 합니다.[2]
먼저 git --version으로 Git이 있는지 봅니다. 번호가 나오면 됩니다. 번호 대신 명령을 찾을 수 없다는 말이 나오면 이렇게 설치하세요.
- Windows: git-scm.com/downloads/win 에서 설치 프로그램을 받아 설치하고 새 창을 엽니다.[3]
- 맥과 리눅스: git-scm.com의 안내를 따릅니다.
이제 연습 폴더에서 기록을 시작합니다.
cd ~/hello-ai-연습/터미널
git initgit init은 이 폴더의 변경 내역을 기록하기 시작하라는 명령입니다. 다음으로 기록하지 않을 것을 정합니다. 7장의 비밀 폴더는 가짜 파일이지만, 진짜 비밀이라고 치고 빼 보겠습니다. 다음 절의 worktree 폴더도 함께 뺍니다.[4] claude를 켜고 이렇게 보냅니다.
이 폴더에 .gitignore 파일을 만들고 "비밀/"과 ".claude/worktrees/" 두 줄을 적어 줘..gitignore는 Git이 못 본 척할 파일을 적는 목록입니다. 이제 /exit로 나와서 터미널에 칩니다.
git config user.name "내 이름"
git config user.email "me@example.com"
git config core.quotePath false
git add .
git status --short한 줄씩 보면 이렇습니다.
- 첫째·둘째 줄(
git config user.…): 커밋에 적힐 이름과 이메일을 정합니다. 이 폴더에만 적용됩니다. 나중에 저장소를 공개하면 함께 공개되니, 공개해도 되는 값을 쓰세요. - 셋째 줄(
git config core.quotePath false): 한글 파일 이름을 그대로 보여 주게 합니다. git add .: 저장할 파일을 모읍니다..은 지금 폴더라는 뜻입니다.git status --short: 모인 파일을 짧게 보여 줍니다.
새 폴더에서 돌렸을 때는 이렇게 나왔습니다.
A .claude/skills/meeting-notes/SKILL.md
A .gitignore
A CLAUDE.md
A inbox/회의-2026-10-27-주간회의.txt
A notes/회의록-2026-10-27.md
A 주간정리.sh
A 회의록.md내 목록은 파일이 더 많을 수 있습니다. 셋째 줄을 빼면 한글 이름이 \355\232… 같은 숫자로 보여서 비밀 폴더가 담겨도 알아보기 어렵습니다.
여기서 스스로 물어보세요. 비밀 폴더가 목록에서 빠졌나? 빠졌다면 저장합니다. 보이면 커밋하지 마세요. .gitignore의 두 줄을 고친 뒤 git reset과 git add .를 다시 칩니다. git reset은 방금 git add .로 모은 파일을 다시 내려놓는 명령입니다. 파일 자체는 지워지지 않으니 안심하세요.
git commit -m "첫 기록"git commit이 실제로 기록을 남깁니다. -m은 메시지(message)의 줄임말이고, 따옴표 안이 이 기록의 설명입니다.
이 순서는 새 폴더에서 돌려서 비밀 폴더가 빠지고 커밋이 남는 것까지 확인했습니다.
확인 퀴즈
`.gitignore` 파일에 `비밀/`이라고 적으면 어떻게 될까요?
worktree로 작업 폴더 나누기
worktree(워크트리)는 별도의 작업 폴더입니다. 저장소 기록은 함께 쓰고, 파일과 가지(Branch, 갈라져 나온 작업 줄기)는 따로 가집니다.[5] 복사본 폴더를 하나 더 만들어 그 안에서 일하는 모습을 떠올리면 됩니다. 여기서는 맛보기로 한 번만 해 봅니다.
--worktree 뒤에 이름을 주면 그 폴더를 만들고 안에서 Claude를 시작합니다.[5:1]
claude --worktree memo-fix실제로 돌리니 시작 화면의 폴더가 이렇게 바뀌었습니다.
▐▛███▛█ Claude Code v2.1.318
▝▜██████▀ Opus 5.5 · Claude 요금제 이름
▝▝ ▝▝ ~/hello-ai-연습/터미널/.claude/worktrees/memo-fix폴더는 .claude/worktrees/memo-fix에 생기고, 새 가지 이름은 worktree-memo-fix입니다.[6] 세션 이름을 붙이지 않고, 아무것도 바꾸지 않은 채 /exit로 끝내니 폴더가 바로 지워졌습니다.
Removing worktree…
Worktree removed (no changes)worktree 이름과 세션 이름은 다릅니다. 세션에 이름을 붙였다면 지우기 전에 보관할지 먼저 묻는다고 공식 문서는 설명합니다.[6:1] 이 경우는 실행해 보지 않았습니다.
알아 둘 점이 둘 있습니다.
- 새로 받은 사본입니다.[7] 커밋에 없는 파일은 그 안에 없습니다. 위에서 뺀
비밀폴더도 없습니다. 메모가 안 보이면 커밋했는지 먼저 확인하세요. - 남은 작업이 있으면 끝낼 때 보관할지 삭제할지 묻습니다. 삭제를 고르면 폴더와 가지, 그 안의 작업이 함께 사라집니다. 나중에 돌아오려면 종료할 때 나오는
claude --worktree <이름> --resume명령을 씁니다.[8]
worktree의 결과를 본 폴더로 합치는 일은 Git의 가지 합치기입니다. 이 장에서는 합치지 않습니다. 본 폴더를 건드리지 않고 따로 일해 보는 곳이라는 것만 알면 충분합니다. 합치는 방법이 궁금하면 4단계 · AI-SDLC 가이드의 PR 장을 보세요. PR(Pull Request)은 가지의 변경을 본 줄기에 합쳐 달라고 요청하는 일입니다.
확인 퀴즈
`claude --worktree memo-fix`를 쓰려면 저장소에 무엇이 있어야 할까요?
터미널 창 두 개로 나란히
회의록을 고치는 동안 공부 노트도 맡기고 싶을 때가 있습니다. 터미널 창을 두 개 열면 됩니다.
- 아쉬운 예: 두 창 모두 같은 폴더에서
claude를 켠다. 같은 파일을 건드릴 수 있습니다. 다른 세션이 고친 내용은 되감기가 대개 잡아 주지 못합니다.[9] - 나은 예: 창마다 다른 이름의 worktree를 쓴다. 파일이 따로라서 서로 부딪히지 않습니다.
첫 번째 창에서는 이렇게 칩니다.
cd ~/hello-ai-연습/터미널
claude --worktree memo-fix두 번째 창에서는 이렇게 칩니다.
cd ~/hello-ai-연습/터미널
claude --worktree study-note두 창은 이렇게 서로 다른 폴더에서 일합니다. 앞 절에서 본 대로 worktree는 .claude/worktrees/<이름>에 생기기 때문입니다.
창 1: ~/hello-ai-연습/터미널/.claude/worktrees/memo-fix 회의록 고치기
창 2: ~/hello-ai-연습/터미널/.claude/worktrees/study-note 공부 노트 정리창 두 개를 동시에 돌리는 일은 이 가이드에서 실행해 보지 않았습니다. 끝나면 스스로 물어보세요. 두 작업이 서로 파일을 건드리지 않았나? 창을 늘리면 쓰는 양도 늘 수 있습니다. 13장의 /usage로 살피면서 꼭 필요할 때만 쓰세요.
확인 퀴즈
터미널 창 두 개로 일을 나란히 맡길 때 더 나은 방법은 무엇일까요?
더 알아보기
아래 셋은 이 가이드에서 실행해 보지 않았습니다. 공식 문서가 설명하는 내용만 짧게 옮깁니다. 지금 몰라도 괜찮습니다. 필요해지면 꺼내 보세요.
/loop 는 세션 안에서 같은 요청을 간격을 두고 다시 실행합니다.[10] 예를 들어 한 시간마다 새 메모가 왔는지 확인하게 할 수 있습니다.
/loop 쓰는 법과 주의할 점 (눌러서 펼치기)
/loop 1h inbox 폴더에 새 메모가 있으면 파일 이름만 알려 줘/goal 은 완료 조건을 정해 두면 단계마다 지시하지 않아도 Claude가 계속 일하게 합니다.[13]
/goal 쓰는 법과 주의할 점 (눌러서 펼치기)
판정하는 모델은 파일을 직접 열지 않습니다. 그래서 조건은 답에 드러나게 쓰고, 멈출 조건도 넣습니다.[14] 턴은 Claude가 한 번 일하고 결과를 받는 한 차례입니다.
/goal inbox의 회의 메모마다 notes 폴더에 회의록이 생기고 만든 파일 이름을 답에 모두 적으면 끝. 또는 10턴 후 멈춰./goal clear로 해제합니다.[15]
원격 제어(Remote Control)는 내 컴퓨터에서 돌고 있는 세션을 claude.ai/code나 Claude 휴대폰 앱에 연결합니다. 세션에서 /remote-control을 칩니다.[16] 쓸 수 있는 요금제는 정해져 있습니다.[17]
클라우드에서 실행되는 것이 아닙니다. 일은 내 컴퓨터에서 계속되고, 휴대폰은 그 세션을 보는 창입니다. 그래서 컴퓨터가 켜져 있고 claude가 계속 실행 중이어야 합니다.[18]
컴퓨터가 꺼져 있어도 돌아가야 하는 일이라면 앱 가이드의 클라우드와 예약을 보세요.
확인 퀴즈
휴대폰으로 원격 제어를 쓰는 동안 일은 어디서 돌아갈까요?
직접 해 보기
- 연습 폴더에서
git init,.gitignore, 첫 커밋까지 합니다. git log --oneline으로 기록이 한 줄 보이는지 확인합니다.claude --worktree memo-fix로 시작하고! pwd로 지금 폴더를 확인합니다.- 아무것도 바꾸지 않고
/exit로 끝낸 뒤, 화면의 안내를 읽습니다.
스스로 물어보세요. 첫 기록에서 비밀 폴더가 빠졌나? 지금 내가 어느 폴더에 있는지 pwd로 말할 수 있나?
정리
- Git 첫 기록은 되감기가 못 되돌리는 변경을 돌려놓을 길이고, worktree의 전제다.
- worktree는 파일과 가지가 따로인 작업 폴더다. 커밋에 없는 파일은 그 안에 없다.
- 일을 나란히 맡길 때는 창마다 다른 worktree를 쓴다.
/loop,/goal, 원격 제어는 필요해지면 꺼내 본다.
용어 정리
| 용어 | 읽는 법 | 한 줄 뜻 |
|---|---|---|
| Git | 깃 | 폴더의 변경 내역을 저장하는 프로그램 |
| Repository | 리포지토리 (저장소) | Git 기록이 쌓이는 폴더 |
| Commit | 커밋 | Git에 저장한 시점 하나 |
| Branch | 브랜치 (가지) | 갈라져 나온 작업 줄기 |
.gitignore | 깃이그노어 | Git이 기록하지 않을 파일 목록 |
| Worktree | 워크트리 | 기록은 같고 파일과 가지가 따로인 작업 폴더 |
| Remote Control | 리모트 컨트롤 (원격 제어) | 내 컴퓨터의 세션을 다른 기기에서 이어 보는 기능 |
이 장을 다 읽었나요?
기록은 이 브라우저에만 저장됩니다. 진행 현황은 전체 목차에서 볼 수 있어요.
다음 장: 13장. 비용·안전·문제 해결
참고 자료 (18개)
Claude Code 공식 문서, 「Checkpointing」. "A file that only Bash commands changed isn't tracked and stays as it is." / "To revert it, use version control, such as Git." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Common workflows」. "so the repository needs at least one commit first." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Terminal guide for new users」. "Go to git-scm.com/downloads/win and download the installer" code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Run parallel sessions with worktrees」. "Add
.claude/worktrees/to your.gitignoreso worktree contents don't appear as untracked files in your main checkout." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Run parallel sessions with worktrees」. "A git worktree is a separate working directory with its own files and branch, sharing the same repository history and remote as your main checkout." / "Pass
--worktreeor-wwith a name to create an isolated worktree and start Claude in it." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Run parallel sessions with worktrees」. "By default, the worktree is created under
.claude/worktrees/<name>/at your repository root, on a new branch namedworktree-<name>:" / "for an unnamed session, Claude removes the worktree and its branch automatically." / "A named session prompts you first so you can keep the worktree for later" code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Run parallel sessions with worktrees」. "A worktree is a fresh checkout, so initialize your development environment there" code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Run parallel sessions with worktrees」. "Removing deletes the worktree directory and its branch, along with all the work in them" / "To return later, run the
claude --worktree <name> --resumecommand that Claude Code prints on exit." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Checkpointing」. "Manual changes you make to files outside of Claude Code and edits from other concurrent sessions are normally not captured, unless they happen to modify the same files as the current session." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Run prompts on a schedule」. "Session-scoped scheduled tasks let Claude re-run a prompt automatically on an interval within a Claude Code session." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Run prompts on a schedule」. "Tasks only fire while Claude Code is running and idle." / "Recurring tasks automatically expire 7 days after creation." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Run prompts on a schedule」. "
EscandCtrl+Cdon't stop it, or any task you scheduled by asking Claude directly." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Keep Claude working toward a goal」. "The
/goalcommand sets a completion condition and Claude keeps working toward it without you prompting each step." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Keep Claude working toward a goal」. "It doesn't run commands or read files independently, so write the condition as something Claude's own output can demonstrate." / "To bound how long a goal runs, include a turn or time clause in the condition, such as
or stop after 20 turns." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Keep Claude working toward a goal」. "
stop,off,reset,none, andcancelare accepted as aliases forclear." code.claude.com (확인일 2026-11-06) ↩︎Claude Code 공식 문서, 「Continue local sessions from any device with Remote Control」. "If you're already in a Claude Code session and want to continue it remotely, use the
/remote-control(or/rc) command:" code.claude.com (확인일 2026-11-06) ↩︎Pro·Max·Ultra·Team·Enterprise 요금제에서 쓰고, API 키(13장에서 설명합니다)로는 쓸 수 없습니다. Claude Code 공식 문서, 「Continue local sessions from any device with Remote Control」. "Remote Control connects claude.ai/code or the Claude app for iOS and Android to a Claude Code session running on your machine." / "available on Pro, Max, Ultra, Team, and Enterprise plans. API keys are not supported." code.claude.com (확인일 2026-11-06) ↩︎
Claude Code 공식 문서, 「Continue local sessions from any device with Remote Control」. "The web and mobile interfaces are a window into that local session, so your computer has to stay on and the
claudeprocess has to keep running." code.claude.com (확인일 2026-11-06) ↩︎