⚡ 실행 모드 마스터하기

실행 모드란?

Claude Code는 기본적으로 파일을 수정하거나 명령어를 실행할 때 여러분에게 “이거 해도 되나요?”라고 물어봐요. 이 “허락 받기” 방식을 조절하는 게 바로 실행 모드예요.

자동차에 비유하면 이해하기 쉬워요.

어떤 모드를 쓰느냐에 따라 작업 속도와 안전성이 달라져요. 하나씩 살펴볼게요.

기본 모드: 하나씩 확인

아무 설정도 하지 않으면 기본 모드로 동작해요. Claude Code가 뭔가를 하기 전에 항상 여러분의 허락을 구해요.

/plan 모드: 계획부터

복잡한 작업을 시킬 때, AI가 바로 실행하면 방향이 잘못될 수 있어요./plan 명령을 쓰면 Claude Code가 실행 전에 “이렇게 할 건데 괜찮아?”라고 계획을 먼저 보여줘요.

> /plan
이메일 자동화 시스템을 만들어줘.
Gmail API로 메일 가져오고, 분류하고, 답장 초안까지.

그러면 Claude Code가 이런 식으로 계획을 보여줘요.

1. Gmail API OAuth 인증 설정
2. 받은편지함에서 최근 50건 가져오기
3. 제목/발신자 기준으로 카테고리 분류
4. 각 카테고리별 답장 초안 생성
5. 결과를 JSON 파일로 저장

계획이 마음에 들면 승인하고, 방향이 틀렸으면 수정을 요청할 수 있어요. 큰 작업에서 시간 낭비를 막아주는 유용한 기능이에요.

파일 수정 자동 승인

기본 모드에서 파일을 수정할 때마다 Yes/No를 누르는 게 귀찮을 수 있어요.--permission-mode acceptEdits 플래그를 붙이면 파일 수정은 자동으로 승인돼요.

claude --permission-mode acceptEdits

파일 수정은 자동이지만, 명령어 실행은 여전히 물어봐요. 코드를 빠르게 작성하고 싶을 때 딱 좋은 중간 단계예요.

완전 자동 모드

파일 수정은 물론, 명령어 실행까지 전부 자동으로 처리하는 모드예요. AI가 완전히 자율적으로 동작해요.

claude --dangerously-skip-permissions

이름부터 “dangerously”(위험하게)인 만큼, 간단한 반복 작업이나 빈 프로젝트에서 처음부터 만들 때만 사용하는 게 좋아요.

매번 플래그 안 치고 기본값으로 설정하기

매번 --dangerously-skip-permissions를 타이핑하기 귀찮잖아요. 설정 파일에 기본값으로 저장할 수 있어요.

/permissions

/permissions를 실행하면 허용할 도구를 개별적으로 설정할 수 있어요. 예를 들어 Bash, 파일 읽기/쓰기, 브라우저 등을 각각 허용/차단할 수 있거든요.

또는 설정 파일을 직접 수정할 수도 있어요.

// 위치: ~/.claude/settings.json
{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(node *)",
      "Read",
      "Write",
      "Edit"
    ]
  }
}

이렇게 설정하면 지정한 명령과 파일 작업이 자동 승인돼요. 완전 자동이 필요하면 claude --dangerously-skip-permissions를 사용하세요.프로젝트별로 다르게 설정하고 싶으면 프로젝트 폴더의 .claude/settings.json에 같은 형식으로 저장하면 돼요.

슬래시 명령어 모음

Claude Code 안에서 /로 시작하는 명령어를 입력하면 특별한 기능을 바로 사용할 수 있어요. 자주 쓰는 것들을 정리했어요.

키보드 단축키

마우스 없이도 Claude Code를 빠르게 제어할 수 있는 단축키예요. 네 가지만 기억하면 돼요.

특히 Esc는 가장 많이 쓰는 단축키예요. AI가 원하지 않는 방향으로 가고 있을 때 바로 멈추고 새로운 지시를 내릴 수 있거든요.

언제 어떤 모드를 쓸까?

상황에 맞는 모드를 고르는 게 중요해요. 아래 표를 참고하세요.

정리하면 이래요. 안전함과 속도는 반비례 관계예요.