Claude Code 입력창 아래에서 파일 수정이나 명령 실행을 사람이 확인하는지, 일부를 자동으로 허용하는지, 확인 없이 진행하는지를 구분합니다. 모델 이름·생각의 깊이·구독 등급을 보여 주는 표시는 아닙니다.
공식 문서 확인: 2026-11-08. 아래 하단 문구와 단축키는 터미널에서 실행하는 Claude Code CLI 기준입니다. VS Code의 표시 이름은 별도로 구분합니다.
1. 하단 모드 문구 읽기
승인 모드는 Claude Code가 사람에게 묻지 않고 할 수 있는 일의 범위를 정합니다. 아이콘·색상만 외우지 않고 영어 이름을 함께 읽습니다. 다음은 공식 문서: 승인 모드에 나온 6개 모드입니다.
| 중요도 | 화면 이름·설정값 | 정확한 CLI 하단 문구 | 쉬운 확인 기준 |
|---|---|---|---|
| 핵심 | Manualdefault | ⏸ manual mode on회색으로 표시합니다. | 읽기만 승인 없이 합니다. 파일 수정·명령 실행 등 나머지 동작은 사람이 확인합니다. CLI에서는 manual도 같은 모드를 가리키는 별칭으로 받습니다. |
| 중요 | Accept editsacceptEdits | ⏵⏵ accept edits on | 읽기·파일 편집과 폴더 만들기·파일 이동·복사 같은 흔한 파일 명령을 승인 없이 합니다. 모든 명령 실행을 자동으로 허용하는 뜻은 아닙니다. |
| 핵심 | Planplan | ⏸ plan mode on | 바꾸기 전에 읽고 탐색하며 계획합니다. Auto를 사용할 수 있으면 별도 분류 모델이 승인한 명령도 실행할 수 있습니다. |
| 핵심 | Autoauto | ⏵⏵ auto mode on | 모든 동작을 대상으로 하되, 실행 전에 별도 분류 모델이 검사합니다. 확인 요청을 줄여 주지만 안전을 보장하지 않습니다. 명시적으로 확인하도록 정한 ask 규칙은 여전히 사람이 확인합니다. 지원 모델·관리자 설정에 따라 사용할 수 없을 수 있습니다. |
| 참고 | Don't askdontAsk | ⏵⏵ don't ask on | 작업 폴더 안 읽기와 미리 허용한 도구만 실행합니다. 확인이 필요한 동작은 묻지 않고 거부합니다. 자동 실행·검사 스크립트용이며 Shift+Tab 순환에는 나타나지 않습니다. |
| 참고 | Bypass permissionsbypassPermissions | ⏵⏵ bypass permissions on | 모든 동작을 사람의 승인 확인 없이 진행하는 모드입니다. 격리된 컨테이너·가상머신 전용이며, 입문 단계에서는 사용하지 않습니다. |
on은 현재 켜져 있다는 뜻입니다. 모든 새 대화의 시작 모드를 바꿨다는 뜻은 아닙니다. Manual의 설정값 default도 현재 제품의 기본 시작 모드라는 뜻으로 해석하지 않습니다. 최신 Claude Code(v2.1.283 이후)는 터미널·VS Code 세션을 Auto로 시작하는 것이 기본이며, Auto를 쓸 수 없는 환경에서는 Manual로 시작합니다. 시작 모드는 ~/.claude/settings.json의 permissions.defaultMode로 바꿀 수 있습니다. 지금 화면에 표시된 모드를 확인합니다.
설정값과 더 자세한 허용 범위는 Permission Modes(승인 모드)에서 이어서 확인합니다.
2. Mac과 Windows에서 확인·변경하기
| 중요도 | 환경 | 확인·변경 방법 |
|---|---|---|
| 핵심 | Mac(macOS)의 터미널에서 실행하는 CLI | 입력창 아래의 모드 문구를 읽습니다. Claude Code 입력창을 선택하고 Shift+Tab을 누른 뒤 바뀐 문구를 확인합니다. |
| 핵심 | Windows Terminal의 PowerShell에서 실행하는 CLI | 입력창 아래의 모드 문구를 읽습니다. Claude Code 입력창을 선택하고 Shift+Tab을 누른 뒤 바뀐 문구를 확인합니다. |
| 중요 | Mac·Windows 공통: VS Code | 모드 선택기를 사용합니다. 표시 이름은 Manual, Edit automatically, Plan, Auto, Bypass permissions입니다. CLI 문구와 구별합니다. |
CLI의 Shift+Tab 키는 Mac과 Windows에서 같습니다. 기본 순환 순서는 Manual(default) → Accept edits(acceptEdits) → Plan(plan) → Manual입니다. Auto 상태에서 처음 누르면 Manual로 바뀝니다.
사용할 수 있게 켠 선택 모드는 Plan 뒤에 들어갑니다. 두 모드가 모두 있으면 Plan → Bypass permissions → Auto → Manual 순서입니다. Auto는 지원 모델·관리자 설정 등 사용 조건을 만족할 때만 나타납니다. Bypass permissions는 시작할 때 해당 모드를 허용하는 플래그나 설정을 켠 경우에만 나타납니다.
dontAsk는 이 순환에 들어가지 않으며 --permission-mode dontAsk로만 설정합니다. 입문 단계에서는 이름과 거부 방식을 구별하는 것으로 충분합니다. 키가 전달되지 않으면 Claude Code 입력창이 선택되어 있는지와 터미널 단축키 설정을 확인합니다. 일반 셸에서 키를 눌러도 Claude Code 모드는 바뀌지 않습니다.
3. 상태 표시줄(Status line)
상태 표시줄은 사용자가 설정한 정보를 보여 주는 별도 줄입니다. 설정한 스크립트가 현재 대화의 정보를 받아 글을 출력하면 Claude Code가 그 글을 보여 줍니다. 스크립트는 컴퓨터가 실행할 작은 명령 묶음입니다. 이 사용자 지정 상태 표시줄은 설정하지 않으면 나타나지 않습니다.
위치는 입력 상자 아래, 기본 모드 표시 바로 위 줄입니다. 모드 표시를 대체하지 않으며, 상태 표시줄의 내용을 바꿔도 승인 모드는 바뀌지 않습니다. 사용자 상태 표시줄을 쓰면 하단의 키보드 힌트 대부분은 숨겨집니다. 공식 문서: 상태 표시줄에서 기능과 위치를 확인합니다.
두 줄의 위치를 구별하는 예시
설명용 예시 화면입니다. 실제 캡처가 아니며, /statusline으로 모델 이름·폴더·컨텍스트 사용률·예상 비용을 표시하도록 만든 예시입니다. 모델 이름과 수치는 모두 예시값입니다. 경로 ~/projects/demo는 Mac의 홈 폴더 아래 연습 폴더를 나타낸 예시이며, Windows에서는 해당 컴퓨터의 폴더 경로를 표시합니다.
⏸ manual mode on입니다.좁은 화면에서는 예시 화면 안을 좌우로 스크롤합니다. 키보드로는 예시 영역을 선택한 뒤 방향키로 확인합니다.
만들기와 끄기 — Mac·Windows 공통
일반 터미널 명령을 치는 곳이 아니라 실행 중인 Claude Code 입력창에 /statusline을 쓰고, 뒤에 원하는 표시를 말로 적습니다. 예를 들어 다음과 같이 요청합니다.
/statusline 모델 이름과 컨텍스트 사용률을 보여 줘.Claude Code가 사용자 홈 폴더의 .claude 안에 스크립트를 만들고 설정을 자동으로 바꿉니다. 파일 수정 확인을 요청하면 내용을 읽고 승인합니다. 끄려면 같은 입력창에 /statusline delete 또는 /statusline clear를 입력합니다.
설정 파일 위치와 고급 항목
설정은 settings.json의 statusLine 항목에 저장합니다. Mac의 위치는 ~/.claude/settings.json이며, Windows는 사용자 홈 폴더의 .claude\settings.json입니다. type은 "command", command는 실행할 명령입니다. 선택 항목인 padding은 가로 여백, refreshInterval은 몇 초마다 다시 실행할지 정합니다.
스크립트를 직접 작성하는 경우 Mac용 셸 스크립트와 Windows용 PowerShell·Git Bash는 실행 방법이 다릅니다. 입문 단계에서는 위의 자연어 요청으로 설정합니다.
표시할 수 있는 정보와 읽는 법
필요한 항목을 골라 표시합니다. 컨텍스트는 모델이 현재 대화에서 참고하는 내용을 뜻하며, 세션은 한 번 이어서 작업하는 대화 단위입니다.
| 중요도 | 정보 | 쉬운 뜻·주의할 점 |
|---|---|---|
| 핵심 | 모델 이름 | 지금 응답하는 모델을 보여 줍니다. 승인 모드와는 다른 정보입니다. |
| 핵심 | 현재 폴더·프로젝트 | 어느 폴더·프로젝트에서 작업하는지 보여 줍니다. |
| 참고 | Git 저장소 정보 | 파일 변경 이력을 관리하는 Git의 작업 갈래(브랜치)나 변경 상태를 보여 줄 수 있습니다. |
| 중요 | 예상 세션 비용 | 이 대화의 예상 비용을 미국 달러로 보여 줍니다. 추정값이므로 실제 청구 금액과 다를 수 있습니다. 예시의 $0.42도 확정 청구액이 아닙니다. |
| 참고 | 경과 시간·추가 및 삭제한 줄 수 | 작업한 시간과 파일에 더하거나 지운 줄 수를 보여 줄 수 있습니다. |
| 핵심 | 컨텍스트 사용률 | 현재 대화에서 모델이 참고할 수 있는 공간을 얼마나 썼는지 보여 줍니다. 구독 사용 한도의 잔여량이 아닙니다. |
| 중요 | 생각 깊이(effort) | 현재 설정된 추론 노력 수준을 보여 줄 수 있습니다. 지원하는 모델에서만 제공하는 정보입니다. |
| 핵심 | 구독 사용 한도 | 5시간·7일 한도의 사용률과 다시 계산되는 시점을 보여 줄 수 있습니다. claude.ai Pro·Max·Ultra 구독자에게만 제공하는 정보이며 컨텍스트 사용률과 구별합니다. |
상태 표시줄은 세션 시작, 새 응답, 대화를 압축하는 /compact 완료, 승인 모드 변경 등 사건이 있을 때 다시 실행합니다. 빠르게 이어진 변경은 300밀리초(0.3초) 단위로 묶어 처리합니다. refreshInterval을 정하면 그 초 간격으로도 실행합니다.
상태 표시줄 스크립트 실행은 로컬에서 이루어지며 API 토큰을 사용하지 않습니다. 로컬은 Claude Code를 실행하는 컴퓨터를 뜻합니다. 위의 /statusline으로 스크립트를 만들어 달라고 요청하는 과정과, 완성된 스크립트가 정보를 표시하는 실행은 구별합니다.
직접 구성하기 어려우면 초급 키워드인 ccstatusline(상태 표시줄)에서 외부 도구로 항목을 고르는 방법과 Mac·Windows별 설치·연결 순서를 확인합니다. 기본 모드 표시를 읽는 데는 외부 도구 설치가 필요하지 않습니다.
맨 아래 모드 표시는 승인 방식을 알려 줍니다. 그 위에 사용자가 설정한 상태 표시줄은 모델·폴더·컨텍스트 등 고른 정보를 보여 줍니다.