Claude Code Ultraplan 종료와 Plan, Auto, Bypass 모드 차이
Ultraplan은 종료된 기능입니다. 현재 Claude Code의 Plan, Manual, Auto, Bypass가 무엇을 다르게 승인하는지 구분하고, 작은 연습 파일로 요청 범위와 결과를 확인합니다.
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
Claude Code는 터미널에서 파일과 명령을 다루는 AI 도구입니다. 여기서 모드는 어떤 동작을 실행하기 전에 물어볼지 정하는 설정입니다. 자동으로 허용한다는 말이 결과가 정확하다는 뜻은 아닙니다. 예를 들어 파일 수정을 허용해도 날짜나 금액을 잘못 적을 수 있으므로 결과를 확인해야 합니다.
이 글은 처음에는 2026년 4월의 Ultraplan, Auto 출시 상황을 다뤘습니다. 2026년 10월 4일 기준으로는 Ultraplan이 종료되었고 Auto의 제공 범위도 달라졌습니다. 예전 명령을 따라 하기 전에 현재 상태부터 구분하겠습니다.
Ultraplan이 목록에 없는 이유
Ultraplan은 계획 작업을 클라우드에 보내고 브라우저에서 검토하던 실험 기능입니다. 지금은 /ultraplan 명령과 문장 속 ultraplan 호출, 계획 승인창의 관련 선택지가 모두 제거되었습니다. 명령이 없다고 설치를 지우거나 유료 플랜을 바꿀 필요는 없습니다.
현재는 로컬 Claude Code의 Plan 모드에서 계획을 검토하거나, 브라우저에서 작업하려면 Claude Code 클라우드 세션을 사용합니다. 클라우드는 내 컴퓨터가 아닌 서비스의 실행 환경이므로 연결할 저장소와 보내는 자료도 확인해야 합니다. 공식 종료 안내
처음에는 이름보다 승인 범위를 봅니다
다음 표는 모드의 기본 역할입니다. 실제 적용에는 별도로 저장된 허용과 거부 규칙, 조직 설정이 함께 작용합니다. default라는 설정값은 화면의 Manual과 연결되며, 현재 제품의 기본 시작 모드가 항상 Manual이라는 뜻은 아닙니다.
| 화면이나 설정의 이름 | 주로 달라지는 점 |
|---|---|
Manual (default) | 파일 수정 등에서 승인을 받으며 읽기에는 예외가 있음 |
Plan (plan) | 원본 수정 전에 조사하고 계획을 제안 |
Accept edits (acceptEdits) | 작업 범위의 파일 편집과 일부 파일 명령을 자동 허용 |
Auto (auto) | 분류기라는 별도 판단 모델이 검토할 동작을 평가 |
Don't ask (dontAsk) | 사전 허용되지 않아 질문이 필요한 동작은 거부 |
Bypass (bypassPermissions) | 일반 권한 확인을 건너뛰는 방식 |
Accept edits에서도 모든 셸 명령을 물어보는 것은 아닙니다. 작업 폴더 안의 일부 이동, 복사, 삭제 같은 명령도 자동 허용될 수 있습니다. 또 Plan도 탐색 명령은 실행할 수 있고, 대화형 터미널에서 Bypass가 모드 선택 목록에 포함된 세션에는 편집 차단 예외가 있습니다. 처음 연습할 때 우회 옵션을 함께 붙이지 않는 이유입니다. 권한 설정 문서, 모드별 조건
Manual에서 작은 파일 하나로 확인하기
설치와 로그인을 마친 뒤 중요 자료가 없는 연습 폴더를 준비합니다. 설치 전이라면 윈도우 안내 또는 맥 안내의 첫 실행까지 진행합니다. 아래는 실제 회사 자료 대신 사용할 가상의 독서 기록입니다.
Claude Code가 실행 중이면 대화 입력칸에서 /exit로 나옵니다. 연습 폴더의 터미널 셸에서 다음 한 줄을 입력합니다.
claude --permission-mode default대화 입력칸 아래에 Manual 표시가 있는지 봅니다. 요청 전 폴더에 reading-note.md가 이미 있는지 봅니다. 있다면 새 이름인 reading-note-2.md를 사용하고 이후 요청에서도 그 이름을 유지합니다. 그다음 대화 입력칸에 다음 요청을 보냅니다.
이 연습 폴더에 reading-note.md를 만들어 줘.
내용은 아래 세 줄이야. 다른 파일은 바꾸지 마.
# 독서 기록
- 책: 연습용 도서
- 읽은 분량: 10쪽승인창이 나오면 대상이 연습 폴더의 reading-note.md인지, 내용이 위 세 줄인지 봅니다. 맞으면 이번 동작을 승인합니다. 자동 승인 전환이나 앞으로 묻지 않기와 이번 승인 버튼은 다르므로 이름을 읽고 선택합니다. Manual인데 승인창 없이 바뀌었다면 기존 허용 규칙이 있는지 /permissions에서 확인합니다. 새 폴더라도 사용자나 조직 설정이 적용될 수 있습니다.
완료 답변 뒤에는 편집기에서 실제 파일을 열어 10쪽인지 확인합니다. 이제 같은 파일의 10쪽만 15쪽으로 바꾸라고 요청하고 파일을 다시 엽니다. 제목과 책 이름은 그대로이고 분량만 바뀌었으면 요청한 범위를 확인한 것입니다.
다른 파일을 수정하려 하거나 경로가 맞지 않으면 승인하지 않고 실제로 사용한 파일 이름을 넣어 “이 연습 폴더의 reading-note.md만 대상이야”라고 바로잡습니다. 이미 변경했다면 먼저 실제 파일과 변경 내용을 확인합니다. 중단 버튼은 완료된 변경까지 되돌리는 기능이 아닙니다.
계획과 실행은 따로 확인합니다
이번에는 아래 요청을 대화 입력칸에 보냅니다. 파일 이름을 바꿨다면 여기에도 같은 이름을 씁니다.
/plan reading-note.md에 날짜: 2026-10-12 항목을 추가하려고 해. 수정 전에 계획만 설명해 줘.계획에서 바꿀 파일, 추가할 날짜, 확인 방법을 읽습니다. 불필요한 파일까지 바꾸겠다면 구현 승인 대신 계획 수정을 요청합니다. 이 연습은 계획 확인까지만 해도 됩니다. 구현을 승인하지 않고, 승인 선택창이 열려 있다면 Esc로 닫은 뒤 /exit로 종료합니다. 그다음 파일에 날짜가 추가되지 않았는지 확인합니다.
계획을 승인하면 선택한 실행 모드로 전환될 수 있습니다. 계획이 마음에 든다는 이유만으로 승인 버튼의 모드 설명까지 생략하지 않습니다. 예를 들어 날짜를 추가하는 변경은 타당해도 다른 파일을 자동으로 수정하도록 범위를 넓힐 필요는 없습니다.
Auto는 어떤 역할을 하나요?
Auto는 사람에게 묻는 횟수를 줄이기 위한 모드입니다. 분류기는 실행하려는 동작이 요청 범위를 벗어나는지 등을 판단합니다. 외부 자료 속 지시가 원래 요청을 바꾸게 하는 프롬프트 인젝션도 검사 대상이지만, 모든 위험을 정확히 찾아낸다는 보장은 없습니다. Anthropic의 설계 설명
모든 도구 호출이 같은 검사를 받는 것도 아닙니다. 명시적인 ask 규칙은 여전히 질문을 만들 수 있습니다. 분류기가 실행을 막았을 때는 대상과 요청을 확인해야 하며, 멈췄다는 이유만으로 Bypass로 바꾸지 않습니다.
아래는 기존 글에 있던 Opus 4.7 시기의 상태 표시줄 이미지입니다. Auto가 켜졌다는 표시를 읽는 참고 자료로 남겼으며 현재 지원 모델이나 플랜의 전체 목록이 아닙니다.
2026년 10월 4일 공식 문서는 Auto를 모든 플랜의 지원 기능으로 안내합니다. 다만 지원 모델, 공급자, 조직 설정 조건을 충족해야 하며 Claude Code 이용 자격과는 별도로 봅니다. Auto를 위해 반드시 Max를 결제해야 한다는 예전 설명은 현재 기준이 아닙니다. v2.1.283 이상에서는 대화형 터미널과 VS Code의 기본 시작 모드도 Auto지만, 명시한 설정과 사용 조건에 따라 달라집니다. 현재 제공 조건
Auto가 없다면 /status의 버전과 모델, 계정 및 조직 설정부터 확인합니다. 기능을 켜기 위해 회사의 제한을 해제하거나 상위 요금제를 바로 결제하지 않습니다. Manual로도 위 실습을 진행할 수 있습니다.
Bypass는 오류 해결 버튼이 아닙니다
--dangerously-skip-permissions는 일반 권한 확인을 건너뛰도록 실행하는 옵션입니다. 하지만 명시적 거부 규칙 등 남아 있는 제한도 있으므로 “모든 안전 검사가 없어지고 어떤 동작도 막지 않는다”는 설명은 정확하지 않습니다. 보호 경로에 쓰는 동작도 우회될 수 있어 .git이나 .claude라는 이름만으로 보호된다고 기대해서도 안 됩니다. 권한 설정 문서
공식 권장 사용 환경은 피해 범위를 제한한 컨테이너나 가상머신 같은 격리 환경입니다. 새 폴더를 하나 만들었다는 것만으로 격리되는 것은 아닙니다. 그 안의 프로그램이 원래 컴퓨터의 파일이나 계정에 접근할 수 있다면 그 접근 권한도 함께 확인해야 합니다. Claude Code 보안 안내
처음 쓰는 사람은 위 연습을 마치기 위해 Bypass를 켤 필요가 없습니다. 파일이 안 만들어지면 작업 폴더, 오류 메시지와 승인 대기 여부를 먼저 봅니다. 파일 접근이 차단됐다면 어떤 규칙에 막혔는지 확인합니다.
요청 문장과 권한 규칙은 역할이 다릅니다
“배포하지 마”는 AI에게 작업 범위를 전달하는 문장입니다. 배포란 변경한 프로그램을 실제 서비스에 반영하는 작업입니다. 반면 deny는 일치하는 도구 실행을 막는 권한 규칙이고 ask는 실행 전 확인을 요구하는 규칙입니다. /permissions에서 어떤 규칙이 적용되어 있는지 볼 수 있습니다.
자연어 지시만으로 모든 실행 경로가 차단되는 것은 아닙니다. 규칙도 정한 도구와 패턴에 맞아야 하므로, 이름만 적고 차단이 끝났다고 판단하지 않습니다. 실제 서비스 작업이라면 대상 파일과 명령, 외부 전송 위치를 구체적으로 정하고 적용 결과를 검증합니다. 세부 권한 설정
Manual에서 Auto로 바꾸는 것은 초급에서 고급으로 승급하는 순서가 아닙니다. 이번 작업에서 직접 확인해야 할 동작과 자동으로 허용해도 되는 동작을 구분해 선택합니다. 처음에는 연습 파일 하나의 변경을 읽고 확인할 수 있으면 충분합니다.
Sources
3줄 요약
-
Ultraplan은 종료되었으며 현재 계획 작업에는 Plan 모드나 클라우드 세션을 사용합니다.
-
Auto는 일부 실행 판단을 자동화하지만 결과의 정확성이나 모든 위험의 차단을 보장하지 않습니다.
-
처음에는 Manual에서 작은 파일 하나의 변경을 확인하고 모드를 바꿀 때도 대상과 실행 범위를 점검합니다.
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
처음 보는 폴더에서 연습 파일 하나를 수정할 때 가장 먼저 확인할 것은 무엇인가요?
이 글이 도움이 되었나요?
설치 다음 단계인 명령어, 플랜 모드, 메모리, 한도를 차례로 익힙니다
- 1Claude Code 이해하기: 파일을 읽고 수정하는 AI 도구
- 2클로드 코드(Claude Code) 설치 따라하기: 터미널 입문 포함
- 3클로드 코드 슬래시 명령어(Slash Commands) 알아보기
새 글과 AI 소식을 메일로 받아 보세요
AI가 바꾸는 일과 도구, 측정 실무 이야기를 매주 한 번 보내 드려요.