Worktree, Teleport, Fast Mode, Remote Control, Settings — Claude Code의 끝판왕 기능들Worktree, Teleport, Fast Mode, Remote Control, Settings — Claude Code's ultimate features
본 프로젝트를 건드리지 않고 안전한 실험 공간에서 작업하세요.Work in a safe experiment space without touching your main project.
과학자가 실험할 때, 본 연구실의 시약을 직접 섞지 않습니다. 별도의 실험실에서 먼저 시도하죠.
Worktree도 마찬가지입니다. 현재 프로젝트 코드를 복사해서 격리된 작업 공간을 만들고, 거기서 마음껏 실험합니다.
실험이 성공하면 본 프로젝트에 머지하고, 실패하면 그냥 삭제하면 됩니다. — 본 코드는 단 한 줄도 다치지 않습니다.
When a scientist experiments, they don't mix reagents directly in the main lab. They try it first in a separate laboratory.
Worktree works the same way. It copies your current project code to create an isolated workspace, where you can experiment freely.
If the experiment succeeds, merge it into the main project. If it fails, just delete it. — Not a single line of your original code is touched.
Claude Code에서 Worktree 모드를 시작하면, 현재 브랜치를 기반으로 격리된 작업 공간이 만들어집니다.Starting Worktree mode in Claude Code creates an isolated workspace based on the current branch.
Worktree 안에서는 파일 수정, 삭제, 구조 변경 등 무엇이든 자유롭게 할 수 있습니다. 원본에는 영향이 없습니다.Inside the Worktree, you can freely modify, delete, or restructure files. The original is unaffected.
작업이 끝나면 빌드, 테스트를 실행해서 결과를 검증합니다.When work is done, run builds and tests to verify the results.
성공하면 원본 브랜치에 머지하고, 실패하면 Worktree를 삭제합니다. 세션 종료 시 유지/삭제를 선택할 수 있습니다.If successful, merge into the original branch. If not, delete the Worktree. At session end, you can choose to keep or remove it.
서브에이전트를 isolation: "worktree"로 실행하면, 각 에이전트가 독립된 작업 디렉토리에서 동시에 작업합니다. 서로의 파일 변경이 간섭하지 않습니다.Running sub-agents with isolation: "worktree" gives each agent an independent working directory. File changes don't interfere with each other.
에이전트 A가 수정한 파일을 에이전트 B가 덮어쓰는 일이 없습니다. 각자 독립된 git 브랜치에서 작업하므로, 완료 후 개별적으로 리뷰하고 머지할 수 있습니다.
Agent A's file edits won't be overwritten by Agent B. Each works on an independent git branch, so you can review and merge individually after completion.
각 워크트리는 독립된 컨텍스트를 사용하므로, 동시에 3개 에이전트를 돌리면 토큰 사용량도 3배입니다. API 사용자는 비용에 주의하세요.
Each worktree uses independent context, so running 3 agents simultaneously means 3x token usage. API users should watch costs.
느린 작업(빌드, 테스트, 대규모 탐색)은 백그라운드로 돌려놓고, 메인 에이전트는 다른 작업을 계속할 수 있습니다.Slow operations (builds, tests, large searches) can run in the background while the main agent continues other work.
로컬 ↔ 웹 세션을 자유롭게 이동하세요. 터미널에서 하던 작업을 웹으로, 웹에서 하던 작업을 터미널로.Move freely between local ↔ web sessions. Continue terminal work on the web, or web work in the terminal.
게임에서 포탈을 타면 다른 세계로 순간이동하듯이,
Teleport를 사용하면 터미널에서 하던 작업을 웹 브라우저로, 또는 웹에서 하던 작업을 터미널로 순간이동할 수 있습니다.
작업 컨텍스트가 통째로 이동하기 때문에, 대화 히스토리를 다시 설명할 필요가 없습니다.
Just like stepping through a portal in a game teleports you to another world,
Teleport lets you instantly move work from the terminal to a web browser, or from the web to the terminal.
The entire work context moves with you, so there's no need to re-explain the conversation history.
터미널(Claude Code CLI)이나 웹(claude.ai)에서 작업을 시작합니다.Start working in the terminal (Claude Code CLI) or on the web (claude.ai).
작업 환경을 전환하고 싶을 때 Teleport 명령을 사용합니다.Use the Teleport command when you want to switch environments.
생성된 URL을 브라우저에서 열면 동일한 컨텍스트로 작업을 이어갈 수 있습니다.Open the generated URL in a browser to continue work in the same context.
이전 대화 히스토리와 컨텍스트가 그대로 유지된 채 새로운 환경에서 이어서 작업합니다.Continue working in the new environment with the previous conversation history and context fully intact.
여러 Claude 에이전트가 동시에 협업하는 멀티에이전트 오케스트레이션.Multi-agent orchestration where multiple Claude agents collaborate simultaneously.
혼자서 프론트엔드, 백엔드, QA, 문서화를 다 하면 시간이 오래 걸립니다.
Agent Teams는 PM(메인 에이전트)이 작업을 분배하고,
프론트엔드 개발자, 백엔드 개발자, QA 엔지니어가 각자의 Worktree에서 동시에 작업합니다.
마치 실제 개발팀처럼, 각 에이전트가 전문 영역을 맡아 병렬로 처리합니다.
Doing frontend, backend, QA, and documentation alone takes a long time.
Agent Teams has the PM (main agent) distribute work,
while the frontend developer, backend developer, and QA engineer work simultaneously in their own Worktrees.
Just like a real dev team, each agent handles their specialty area in parallel.
여러 에이전트가 동시에 작업하므로, 순차적으로 처리하는 것보다 훨씬 빠릅니다. 프론트엔드 수정과 백엔드 수정을 동시에 진행할 수 있습니다.Multiple agents work simultaneously, making it much faster than sequential processing. Frontend and backend changes can proceed at the same time.
각 에이전트에게 특정 역할과 컨텍스트를 부여할 수 있습니다. 프론트엔드 전문 에이전트는 UI/UX에만 집중하고, 백엔드 에이전트는 API에만 집중합니다.Each agent can be given a specific role and context. The frontend specialist focuses only on UI/UX, while the backend agent focuses only on APIs.
여러 에이전트가 동시에 동작하므로 API 사용량이 늘어납니다. 간단한 작업에는 단일 에이전트가 더 효율적일 수 있으니, 복잡한 작업에만 사용하세요.Running multiple agents simultaneously increases API usage. A single agent may be more efficient for simple tasks, so use this only for complex work.
여러 에이전트가 같은 파일을 수정하면 머지 충돌이 발생할 수 있습니다. 작업 영역을 명확히 분리하고, 메인 에이전트가 조율하도록 설계하세요.If multiple agents modify the same file, merge conflicts can occur. Clearly separate work areas and design the main agent to coordinate.
.claude/commands/ 디렉토리에 마크다운 파일을 넣으면, 나만의 슬래시 커맨드가 됩니다.Place markdown files in the .claude/commands/ directory to create your own slash commands.
프로젝트 루트에 .claude/commands/ 디렉토리를 만듭니다.Create the .claude/commands/ directory in the project root.
파일 이름이 곧 커맨드 이름이 됩니다. 내용에는 Claude가 수행할 작업을 적습니다.The filename becomes the command name. Write the task you want Claude to perform in the content.
Claude Code 대화 중에 슬래시(/)로 시작하면 자동 완성됩니다.During a Claude Code conversation, start with a slash (/) and it will autocomplete.
.claude/commands/ 디렉토리를 Git에 커밋하면, 팀 전체가 동일한 커스텀 커맨드를 사용할 수 있습니다. 팀의 워크플로우를 코드로 관리하세요.Team sharing tip: Commit the .claude/commands/ directory to Git and the entire team can use the same custom commands. Manage your team's workflow as code.
Extended Context Window — 방대한 코드베이스도 한 번에 파악합니다.Grasp even massive codebases all at once.
| 모델Model | 컨텍스트 윈도우Context Window | 대략적 코드량Approx. Code Volume |
|---|---|---|
| GPT-4 | 128K tokens | ~300 파일~300 files |
| Claude 3.5 Sonnet | 200K tokens | ~500 파일~500 files |
| Claude (Extended) | 1M tokens | ~2,500 파일~2,500 files |
| Claude Code + 탐색Claude Code + Exploration | 1M+ (도구 활용tool-assisted) | 사실상 무제한Effectively unlimited |
대규모 프로젝트의 아키텍처를 한눈에 파악할 수 있습니다. "이 프로젝트의 전체 구조를 설명해줘"라고 하면, 수천 개의 파일을 탐색하고 종합적인 분석을 제공합니다.Understand the architecture of large-scale projects at a glance. Say "explain the full structure of this project" and it will explore thousands of files to provide a comprehensive analysis.
API 변경, 네이밍 컨벤션 통일, 디자인 패턴 적용 등 프로젝트 전반에 걸친 변경을 안전하게 수행합니다. 모든 관련 파일을 파악하고 일관성 있게 수정합니다.Safely perform project-wide changes like API updates, naming convention unification, and design pattern application. Identify all related files and modify them consistently.
/compact 전략은 여전히 중요합니다. 불필요한 컨텍스트를 줄이면 응답 품질이 올라가고, 비용도 절약됩니다. 대용량 컨텍스트는 "필요할 때 쓸 수 있는 여유"이지, "항상 다 채워야 하는 공간"이 아닙니다.Key point: No matter how large the context window, the /compact strategy still matters. Reducing unnecessary context improves response quality and saves cost. A large context is "room available when needed," not "a space that must always be filled."
/fast 명령 한 번으로 응답 속도를 2.5배 향상시키세요. 빠른 반복 작업과 라이브 디버깅에 최적화되어 있습니다.Boost response speed 2.5x with a single /fast command. Optimized for rapid iteration and live debugging.
Fast Mode는 다른 모델이 아닙니다. 동일한 Opus 4.6 모델을 사용하되, 비용 효율성보다 속도를 우선시하는 다른 API 구성을 사용합니다.
동일한 품질과 기능을 얻으며, 응답만 더 빠릅니다. 활성화되면 프롬프트 옆에 ↯ 아이콘이 나타납니다.
Fast Mode is not a different model. It uses the same Opus 4.6 model but with a different API configuration that prioritizes speed over cost efficiency.
You get the same quality and capabilities, just with faster responses. When active, a ↯ icon appears next to the prompt.
CLI에서 /fast를 입력해 Tab을 눌러 전환합니다. 또는 settings.json에 설정으로 고정할 수 있습니다.In the CLI, type /fast and press Tab to toggle. Or fix it permanently in settings.json.
Fast Mode는 응답 지연 시간이 비용보다 중요한 상황에 최적입니다.Fast Mode is ideal when response latency matters more than cost.
로컬 터미널 세션을 폰이나 브라우저에서 원격으로 이어받으세요. 자리를 벗어나도 Claude Code 작업을 계속할 수 있습니다.Continue your local terminal session remotely from your phone or browser. Keep working on Claude Code even when away from your desk.
마치 원격 데스크탑처럼, 로컬에서 실행 중인 Claude Code 세션을 클라우드를 통해 어디서든 접근할 수 있습니다.
사무실 컴퓨터에서 작업을 시작하고, 이동 중에 폰으로 이어받아 계속하고, 집에서 다시 PC로 돌아올 수 있습니다.
Just like remote desktop, you can access your locally running Claude Code session from anywhere via the cloud.
Start work on your office computer, continue on your phone while commuting, and return to your PC at home.
로컬 터미널에서 --remote 플래그로 Claude Code를 시작합니다.Start Claude Code in the local terminal with the --remote flag.
브라우저 또는 폰에서 claude.ai/code에 접속하여 Remote Control 옵션으로 로컬 세션에 연결합니다.Access claude.ai/code from a browser or phone and connect to the local session via the Remote Control option.
반대 방향도 가능합니다. 웹 세션에서 /teleport 명령을 사용하면 해당 세션을 로컬 터미널로 이동시킬 수 있습니다.The reverse is also possible. Use the /teleport command in a web session to move that session to the local terminal.
Claude Code를 더 빠르게 조작하는 필수 단축키들. 손이 키보드를 떠나지 않아도 됩니다.Essential shortcuts for faster Claude Code operation. Keep your hands on the keyboard.
| 단축키Shortcut | 기능Function | 상황Context |
|---|---|---|
| Shift + Tab | 권한 모드 순환 (Auto Accept → Manual → Plan Only)Cycle permission modes (Auto Accept → Manual → Plan Only) | 권한 제어Permission Control |
| Ctrl + B | 현재 작업을 백그라운드로 이동 — 다른 작업 시작 가능Move current task to background — start another task | 멀티태스킹Multitasking |
| Esc | Claude 응답 중단 (생성 중인 응답 즉시 중지)Stop Claude response (immediately stop generation) | 중단Stop |
| Esc × 2 | 마지막 파일 변경 취소 (Undo last file change)Undo last file change | 실행 취소Undo |
| Ctrl + R | 대화 히스토리 검색 (터미널에서 이전 명령 탐색)Search conversation history (navigate previous commands in terminal) | 히스토리History |
Shift+Tab을 누를 때마다 권한 모드가 순환됩니다. Auto Accept(자동 승인) → Manual(매번 확인) → Plan Only(계획만 보기) 순으로 전환됩니다. 위험한 작업 전엔 Manual로 전환하세요.Each Shift+Tab press cycles through permission modes: Auto Accept → Manual (confirm each time) → Plan Only (view plan only). Switch to Manual before risky operations.
Claude가 파일을 잘못 수정했을 때 Esc를 두 번 연속 누르면 마지막 파일 변경이 취소됩니다. 실수로 중요한 코드가 바뀌었을 때 빠른 복구 수단입니다. Worktree와 함께 쓰면 더욱 안전합니다.When Claude incorrectly modifies a file, press Esc twice in a row to undo the last file change. A quick recovery tool when important code is accidentally changed. Even safer when used with Worktree.
/output-style 명령으로 Claude의 응답 형식을 변경할 수 있습니다. 마크다운, 일반 텍스트, 간결 모드 등 상황에 맞게 조절하세요.Output style change: Use the /output-style command to change Claude's response format. Adjust to markdown, plain text, concise mode, etc. as needed.
settings.json과 환경 변수로 Claude Code 동작을 세밀하게 제어하세요. 개인·프로젝트·팀 단위로 계층적으로 적용됩니다.Control Claude Code behavior in detail with settings.json and environment variables. Applied hierarchically at personal, project, and team levels.
| 범위Scope | 파일 위치File Location | 적용 대상Applies To | Git 공유Git Sharing |
|---|---|---|---|
| User | ~/.claude/settings.json |
모든 프로젝트All projects | 비공유Not shared |
| Project | .claude/settings.json |
이 저장소 전체Entire this repo | 공유 가능Shareable |
| Local | .claude/*.local.* |
이 저장소의 나만Only me in this repo | gitignored |
| Managed | 시스템 관리 (IT 배포)System managed (IT deployment) | 머신의 모든 사용자All users on machine | IT 배포IT Deployed |
| 환경 변수Environment Variable | 설명Description |
|---|---|
| ANTHROPIC_MODEL | 기본 모델 지정 (예: claude-opus-4-5)Specify default model (e.g., claude-opus-4-5) |
| CLAUDE_CODE_DISABLE_AUTO_MEMORY | 1로 설정 시 자동 메모리 수집 비활성화Set to 1 to disable auto memory collection |
| CLAUDE_CODE_DISABLE_FAST_MODE | 1로 설정 시 Fast Mode 완전 비활성화Set to 1 to fully disable Fast Mode |
| ANTHROPIC_API_KEY | Anthropic API 키 (Console API 사용 시)Anthropic API key (when using Console API) |
세션 중 언제든 /model 명령으로 모델을 바꿀 수 있습니다. CLI 플래그로도 지정 가능합니다.Change the model anytime during a session with the /model command. Can also be specified via CLI flags.
/config 명령으로 현재 설정 상태를 탭 인터페이스로 확인하고 수정할 수 있습니다.Priority: Settings are applied in order: Managed (highest) > CLI args > Local > Project > User (lowest). More specific scopes override higher ones. Use the /config command to view and edit the current config state via a tab interface.
-p 플래그로 Claude Code를 스크립트, 자동화, CI/CD 파이프라인에 직접 통합하세요.Directly integrate Claude Code into scripts, automation, and CI/CD pipelines with the -p flag.
대화형 REPL 없이 단일 명령으로 Claude를 호출하는 모드입니다. 파이프(|)로 데이터를 넘기거나, 셸 스크립트에서 호출하거나, GitHub Actions에서 자동 실행할 수 있습니다.
Claude가 자동화 도구가 되는 겁니다.
A mode that calls Claude with a single command without an interactive REPL. You can pipe data via (|), call it from shell scripts, or auto-run it in GitHub Actions.
Claude becomes an automation tool.
앱 로그를 실시간으로 Claude에게 넘겨 에러 발생 시 즉시 알림을 받습니다.Stream app logs to Claude in real time and get instant notifications when errors occur.
커밋 전 git diff를 Claude에게 넘겨 보안 이슈나 버그를 자동으로 검토합니다.Pass git diff to Claude before committing to automatically review for security issues or bugs.
자동화 스크립트 안에서 Claude를 서브루틴처럼 호출해 분석, 변환, 요약 작업을 수행합니다.Call Claude like a subroutine within automation scripts to perform analysis, transformation, and summarization tasks.
claude -p "..."는 표준 exit code를 반환합니다. 성공 시 0, 실패 시 1. 이를 활용해 PR 자동 리뷰, 테스트 분석, 릴리즈 노트 생성 등을 파이프라인에 통합할 수 있습니다.CI/CD integration: claude -p "..." returns standard exit codes. 0 for success, 1 for failure. Use this to integrate PR auto-review, test analysis, release note generation, and more into your pipeline.
Claude Code를 GitHub 워크플로우와 브라우저에 직접 통합하여 개발 사이클 전체에 AI를 연결하세요.Directly integrate Claude Code into GitHub workflows and the browser to connect AI across your entire development cycle.
PR이 열릴 때마다 Claude가 자동으로 코드를 리뷰하고 댓글을 달게 설정할 수 있습니다. 팀 리뷰 부담을 크게 줄여줍니다.Configure Claude to automatically review code and post comments whenever a PR is opened. Greatly reduces the team's review burden.
라이브 웹 앱을 디버깅할 때 Claude가 브라우저 DOM, 콘솔 에러, 네트워크 요청에 직접 접근할 수 있습니다.When debugging a live web app, Claude can directly access the browser DOM, console errors, and network requests.
프로덕션 버그를 재현하면서 Claude에게 "이 에러가 왜 나는지 분석해줘"라고 하면, 실제 브라우저 상태를 기반으로 정확한 원인을 찾아줍니다.While reproducing a production bug, ask Claude "analyze why this error is occurring" and it will find the exact cause based on the actual browser state.
고급 기능에 대해 가장 많이 궁금해하는 것들The most common questions about advanced features
$ARGUMENTS 플레이스홀더를 사용하면, 슬래시 커맨드 뒤에 입력한 텍스트가 해당 위치에 삽입됩니다. 예를 들어 /test src/utils.ts라고 입력하면, test.md 안의 $ARGUMENTS가 "src/utils.ts"로 치환됩니다. 이를 통해 하나의 커맨드를 다양한 대상에 재사용할 수 있습니다.Yes! Using the $ARGUMENTS placeholder inside the .md file inserts the text typed after the slash command at that position. For example, typing /test src/utils.ts replaces $ARGUMENTS in test.md with "src/utils.ts". This lets you reuse a single command for various targets.
Worktree = 안전한 실험 공간
Teleport = 환경 간 순간이동
Agent Teams = 멀티에이전트 병렬 처리
커스텀 슬래시 = 나만의 워크플로우 자동화
Fast Mode = 2.5배 빠른 응답속도
Remote Control = 폰/브라우저에서 이어받기
Headless 모드 = CI/CD 완전 자동화Worktree = Safe Experimentation Space
Teleport = Instant Travel Between Environments
Agent Teams = Multi-Agent Parallel Processing
Custom Slash = Your Own Workflow Automation
Fast Mode = 2.5x Faster Response Speed
Remote Control = Pick Up From Phone/Browser
Headless Mode = Full CI/CD Automation
이 기능들을 조합하면, Claude Code는 단순한 코딩 도우미가 아니라
팀 전체의 개발 생산성 플랫폼이 됩니다.Combining these features, Claude Code becomes not just a coding assistant,
but a development productivity platform for the entire team.