첫 대화, 그리고 권한 창

2.1 Claude는 폴더 하나를 본다

1장 마지막에 폴더를 하나 열고 “이 폴더 뭐 있어?” 라고 물었습니다. 그게 우연이 아닙니다. Claude Code는 반드시 폴더 하나를 열어놓고 시작합니다.

📖 작업 폴더(working directory)

Claude가 들여다볼 수 있는 범위. VS Code에서 연 그 폴더 하나와, 그 안의 하위 폴더들이 전부입니다.

회사로 치면 배정받은 책상입니다. 그 책상 위 서류는 마음대로 보지만, 옆 팀 책상은 못 봅니다.

이게 왜 중요하냐면, 초보자가 가장 자주 겪는 두 가지 증상이 전부 여기서 나오기 때문입니다.

그래서 규칙이 하나 생깁니다.

일 하나에 폴더 하나.

바탕화면 전체나 C:\ 전체를 열지 마세요. Claude가 봐야 할 파일만 든 폴더를 열어야 합니다. 범위가 넓으면 Claude가 헤매고, 엉뚱한 걸 건드립니다.

폴더를 바꾸고 싶으면 File → Open Folder 로 다른 폴더를 열면 됩니다. 그 순간부터 Claude의 책상이 바뀝니다.

---

2.2 Claude가 하는 일은 세 가지뿐이다

앞으로 이 책에서 뭘 시키든, Claude가 실제로 하는 동작은 세 가지 중 하나입니다.

   ① 읽기 (read)    파일을 열어 내용을 본다
   ② 쓰기 (write)   파일을 만들거나 고친다
   ③ 실행 (run)     프로그램을 돌린다

“블로그 글 써줘” 도, “엑셀 정리해줘” 도, 뜯어보면 이 셋의 조합입니다. 지금 이 셋을 하나씩 직접 시켜보겠습니다.

① 읽기 — 파일을 보여달라고 하기

폴더에 파일이 하나도 없다면, 아무 텍스트 파일이나 하나 만들어 두세요. VS Code에서 File → New File 로 만들고 아무 내용이나 적어 저장하면 됩니다.

그다음 Claude 패널에 이렇게 칩니다.

이 폴더에 있는 파일을 읽고, 무슨 내용인지 설명해줘

여기서 화면에 창이 하나 뜹니다. 0장과 1장에서 두 번 예고한 그 창입니다. 잠깐 멈추고 2.3절로 갑니다.

---

2.3 그 창의 이름은 권한 창이다

왜 뜨는가

이유는 아주 단순합니다.

Claude가 지금 내 컴퓨터의 파일을 건드리려 하기 때문입니다.

웹 Claude는 이 창이 없습니다. 건드릴 파일이 없으니까요. 그냥 글자만 주고받습니다. 그런데 Claude Code는 진짜로 내 파일을 엽니다. 그러니 묻고 시작합니다.

📖 권한 창 / 권한 모드(permission mode)

Claude가 파일을 읽거나·쓰거나·실행하기 직전에 멈춰서 허락을 구하는 장치. 무엇을 하려는지 보여주고, 사용자가 허용(Allow) 또는 거부(Deny) 를 고릅니다.

어디까지 묻고 어디부터 자동으로 넘어갈지를 정해둔 설정을 권한 모드라고 부릅니다.

무엇을 보고 눌러야 하나

창에는 Claude가 지금 하려는 일이 적혀 있습니다. 볼 것은 두 가지입니다.

읽기는 마음 편히 허용해도 됩니다. 파일이 바뀌지 않으니까요. 주의해야 할 건 쓰기와 실행입니다. 특히 —

⚠️ 파일 이름을 꼭 보세요

내가 방금 만들라고 한 파일인가요? 아니면 원본 자료를 덮어쓰려는 건가요?

자료 원본을 날리는 사고는 거의 전부 여기서 납니다. 이름만 한 번 읽으면 막을 수 있습니다.

왜 이렇게 귀찮게 만들었나

처음에는 짜증납니다. 몇 번이고 계속 물으니까요. 그런데 이게 불편이 아니라 안전장치입니다.

AI는 틀립니다. 0장에서 미리 말씀드린 대로입니다. 그 틀림이 내 파일에 그대로 반영되기 전에 사람이 한 번 끼어드는 자리가 권한 창입니다.

💡 왜 매번 묻는 쪽을 기본값으로 골랐을까

자동으로 다 해주는 쪽이 편합니다. 그런데 편한 대신, 잘못됐을 때 되돌릴 기회가 없습니다.

만드는 쪽에서는 두 가지 중 하나를 골라야 합니다. “편하지만 사고가 날 수 있는 쪽”과 “귀찮지만 사고를 막는 쪽”. Claude Code는 후자를 기본값으로 골랐습니다.

익숙해지면 자주 쓰는 동작은 자동으로 넘기도록 바꿀 수 있습니다. 그건 3부에서 다룹니다. 지금은 다 읽고 누르는 연습을 하세요.

자, 허용(Allow) 을 누르세요. Claude가 파일을 읽고 내용을 설명해 줍니다.

---

2.4 ② 쓰기 — 파일을 만들게 해보기

이번엔 Claude에게 파일을 만들라고 시킵니다.

이 폴더에 hello.py 라는 파일을 만들어줘.
'Hello, Claude Code!' 라고 화면에 출력하는 프로그램이야.

권한 창이 또 뜹니다. 이번엔 쓰기입니다. 아까와 다른 점을 보세요 — 만들려는 파일 이름이 hello.py 로 적혀 있을 겁니다. 내가 말한 그 이름이 맞나 확인하고 허용하세요.

허용하면 VS Code 왼쪽 파일 목록에 hello.py 가 새로 생깁니다.

잠깐 멈추고 이 장면을 보세요. 방금 AI가 내 컴퓨터에 파일을 만들었습니다. 웹 챗봇이라면 “아래 코드를 복사해서 hello.py 로 저장하세요” 라고 했을 자리입니다. 복사도, 붙여넣기도, 저장도 없었습니다.

③ 실행 — 돌려보기

방금 만든 hello.py 를 실행해줘

권한 창이 세 번째로 뜹니다. 이번엔 실행입니다. 허용하면 아래쪽 터미널에 Hello, Claude Code! 가 찍힙니다.

여기서 1장에 깐 Python이 일을 했습니다. 파일은 Claude가 썼고, 그걸 읽어서 실제로 돌린 건 Python입니다. 1.4절의 통역기가 이 장면을 위해 있었습니다.

⚠️ python을 찾을 수 없습니다 가 나오면

1장 그 체크박스입니다. 1.9절 ②번으로 가세요. Python을 다시 깔면 됩니다.

---

2.5 읽기·쓰기·실행 — 한 장 정리

앞으로 이 책에서 나올 모든 작업은 이 셋의 조합입니다. 복잡해 보이는 Skill도 뜯어보면 “읽고 → 쓰고 → 읽고 → 쓰고” 일 뿐입니다.

---

2.6 이렇게 말하면 잘 알아듣는다

첫 대화에서 바로 쓸 수 있는 표현들입니다. 강의에서 실제로 자주 쓴 것만 골랐습니다.

💡 “왜 그렇게 했어?” 를 자주 쓰세요

이 책이 채우려는 게 바로 그 질문입니다. Claude는 자기가 한 일을 설명할 수 있습니다. 결과만 받고 넘어가면 아무것도 안 남지만, 한 번 물으면 남습니다.

강의에서 이 질문을 습관처럼 던진 분들이 3주차에 확실히 빨랐습니다.

---

2.7 안 될 때

메시지를 보냈는데 아무 반응이 없다

1. 패널 아래쪽에 계정이 보이나요? 안 보이면 로그인이 풀린 겁니다 → 다시 Sign in
2. 인터넷 연결을 확인하세요
3. VS Code를 껐다 켜세요. 정말로 이걸로 자주 해결됩니다

답이 영어로 온다

Claude는 기본적으로 영어로 답할 때가 있습니다. 그때그때 “한국어로 답해줘” 라고 해도 되지만, 매번 말하기 번거롭습니다.

이걸 한 번만 적어두고 영원히 해결하는 방법이 있습니다. 7장에서 다룹니다.

“그 파일이 없다”고 한다

2.1절입니다. 그 파일이 작업 폴더 밖에 있습니다. 파일을 폴더 안으로 옮기거나, 그 파일이 있는 폴더를 새로 여세요.

권한 창에서 실수로 거부를 눌렀다

아무 일도 안 일어납니다. 그냥 다시 시키면 됩니다. 거부는 되돌릴 수 없는 사고가 아닙니다. 오히려 애매하면 거부하는 게 맞습니다.

---

2.8 정리

오늘 한 일은 세 줄입니다.

• 파일을 읽게 했다
• 파일을 쓰게 했다
• 프로그램을 실행하게 했다

그리고 그때마다 권한 창이 떴고, 이제 그게 뭔지 압니다. 0장에서 약속한 첫 번째 빈칸이 채워졌습니다.

다음 장은 잠깐 손을 쉽니다. 지금까지 “Claude” 라고 불러온 이것이 대체 무엇인지, 왜 틀리는지, 왜 어떤 건 잘하고 어떤 건 못하는지 — 짧게 짚고 갑니다. 3장을 읽고 나면 AI에게 일을 시키는 감각이 달라집니다.

---