첫 세션

새 세션을 열면 Claude Code는 방금 고른 폴더를 작업 대상으로 잡고 요청을 기다립니다. 요청을 보내면 답만 돌아오는 것이 아니라 폴더 안의 파일이 실제로 만들어지거나 고쳐지는데, 그 일이 일어나기 전에 승인 창을 띄울지는 권한 모드가 정합니다.

권한 모드가 무엇을 허용하고 무엇을 막는지

모드 이름은 화면에 늘 표시되므로 외울 필요는 없습니다. 데스크톱 앱에서는 보내기 버튼 옆 모드 선택기에서 읽고 바꾸며, 터미널에서 연 화면에서는 Shift+Tab을 누를 때마다 다음 모드로 넘어가고 아래쪽 상태 표시줄에 현재 모드가 나타납니다.

• Manual — 파일을 읽는 일만 바로 진행합니다. 파일을 만들거나 고칠 때, 터미널 명령을 실행할 때, 인터넷에 접속할 때는 그때마다 승인 창을 띄웁니다. 설정 파일과 안내 문서에서는 같은 모드를 default라는 값으로 부릅니다.
• acceptEdits — 지금 연 폴더 안의 파일을 만들고 고치는 일까지 승인 창 없이 적용하며, mkdir·touch·mv·cp 같은 파일 정리 명령도 함께 통과시킵니다. 폴더 밖의 경로와 그 밖의 터미널 명령은 여전히 승인을 묻습니다.
• plan — 파일을 고치지 않고 먼저 계획을 내놓습니다. 계획을 승인하면 그때 모드가 바뀌면서 수정이 시작되므로, 무엇을 건드릴지 미리 읽어 보고 싶을 때 씁니다.
• auto — classifier라는 별도 모델이 작업을 대신 검토하면서 승인 창 없이 진행합니다. 요청 범위를 넘어서는 작업은 막지만, 사람이 읽는 승인 절차를 대신하지는 못합니다.

목록에는 dontAsk와 bypassPermissions도 보입니다. 자동화 스크립트와 격리된 컨테이너에서 쓰는 모드라, 연습하는 동안에는 고르지 않습니다.

모드를 잘못 골랐을 때

바꾼 모드는 다음 요청부터 적용되므로, 아직 요청을 보내기 전이라면 모드 선택기에서 Manual을 다시 고르는 것으로 끝납니다. 이미 요청이 지나간 뒤라면 파일이 바뀐 상태이므로, 되돌리기까지 함께 해야 합니다.

데스크톱 앱에서 모드 선택기로 고른 모드는 그 폴더에 기억됩니다. 다음에 같은 폴더를 열면 지난번에 고른 모드가 그대로 켜져 있으므로, 연습이 끝나면 Manual로 돌려 두는 편이 안전합니다. plan은 예외라서 그 세션에만 적용됩니다.

되돌리는 방법

Claude Code는 요청을 보낼 때마다 그 직전의 파일 상태를 체크포인트로 저장합니다. 입력창을 완전히 비운 상태에서 Esc를 두 번 누르면 이번 세션에서 보낸 요청 목록이 뜨고 돌아갈 지점을 고른 뒤 무엇을 되돌릴지 선택합니다. Restore code는 파일만 되돌리고 대화는 남기며, Restore code and conversation은 파일과 대화를 같은 지점으로 함께 되돌립니다.

되돌리기로 되살아나는 것은 Claude가 파일 편집 기능으로 직접 고친 파일까지입니다. 터미널 명령으로 지우거나 옮긴 파일은 체크포인트에 담기지 않아 rewind로 돌아오지 않으므로, 그런 작업까지 되돌리려면 Git으로 기록해 두어야 합니다.

진행 중인 답이나 실행을 중간에 멈출 때는 Esc를 한 번 누릅니다.

순서의 각 단계 아래 붙여넣기 예제가 있습니다. 위에서부터 하나씩 실행해 보세요.

메모 파일 하나를 새로 만들어 줘. 파일 이름은 note.md로 하고, 오늘 확인해야 할 일 3가지를 체크리스트로 적어 줘.

지금 정리해 두면 좋을 일이 있어: [한 줄로 설명]. 그 내용을 담은 메모 파일을 하나 만들어 줘.

방금 만든 파일에 체크리스트 항목을 하나만 추가해 줘. 이번엔 승인 창에서 몇 줄이 바뀌는지 정확히 확인하고 알려 줘.