Claude Code 도구 마스터 · 말로 하지 말고 도구를 써라 · 시작을 누르면 음성과 함께 슬라이드가 자동 재생됩니다. Claude Code Tool Mastery · don't tell it, use the tools · Press start and slides advance with narration.
Claude Code의 힘은 채팅이 아니라 환경을 직접 만지는 도구에서 나옵니다. Bash·Read·Edit·Write·Grep — 오늘은 그 도구함을 엽니다. 말은 보고, 도구는 사실. Claude Code's power comes not from chatting but from tools that touch the environment directly. Bash·Read·Edit·Write·Grep — today we open that toolbox. Talk is a report; a tool is a fact.
As of 2026-06 · 도구 이름·동작은 버전마다 바뀝니다 — ‘말 대신 도구’라는 원리가 진실. [추론]As of 2026-06 · tool names & behaviors change by version — the principle ‘tools over talk’ is the truth. [inference]
10강에서 ”멈춰서 확인하라”고 했죠 — 그 확인을 무엇으로 하나?In Session 10 we said ”stop and verify” — verify with what?
[추론] 말(자연어 응답)과 행동(도구 호출)은 다르다. 파일이 바뀌려면 Edit이, 명령이 돌려면 Bash가 실제로 호출돼야 한다. → 오늘의 질문: 언제 말이고 언제 도구인가.[inference] Talk (a natural-language reply) and action (a tool call) are different. For a file to change, Edit must actually run; for a command to run, Bash must. → Today's question: when is it talk, and when is it a tool?
컨텍스트에 남은 옛 내용이나 확률 추측으로 답한다. 그새 파일이 바뀌어도 모른다 (할루시네이션 위험).Answers from stale context or a probability guess. If the file changed, it doesn't know (hallucination risk).
Read·Grep이 디스크의 실제 현재 상태를 돌려준다 (검증 가능).Read·Grep return the disk's actual current state (verifiable).
사실이 필요하면, 떠올리지 말고 도구로 확인한다.When you need a fact, don't recall it — confirm it with a tool.
[추론] 도구 결과는 모델의 추측이 아니라 환경의 실제 상태다(파일 내용·명령 출력·검색 결과). 같은 질문도 ‘말’보다 ‘도구’가 사실에 가깝다. 단 도구 결과도 100%는 아니다(S11에서 다룸).[inference] A tool result is the real state of the environment, not the model's guess (file contents·command output·search results). For the same question, a tool is closer to fact than talk. But tool results aren't 100% either (covered in S11).
| 도구Tool | 하는 일What it does | 언제 쓰나When to use |
|---|---|---|
| Read | 파일 읽기Read a file | 내용을 봐야 할 때When you must see contents |
| Grep | 패턴 검색Search a pattern | 어디 있는지 찾을 때When you must find where |
| Edit | 부분 수정Partial change | 일부만 바꿀 때When you change only a part |
| Write | 새 파일·전체 교체New file·full replace | 처음 만들거나 통째로 쓸 때When creating or overwriting whole |
| Bash | 명령 실행Run a command | 빌드·테스트·셸 작업Build·test·shell work |
[출처: docs.anthropic.com/en/docs/claude-code/overview] Claude Code는 파일·셸을 직접 다루는 내장 도구를 제공한다. 도구 집합·이름은 2026-06 기준이며 버전마다 갱신 → 현행은 공식 문서·/help로 확인.[source: docs.anthropic.com/en/docs/claude-code/overview] Claude Code provides built-in tools that work directly with files and the shell. The tool set·names are as of 2026-06 and change by version → check the current set with the official docs·/help.
점진적 공개의 도구판 — 필요한 만큼만 읽고, 필요한 만큼만 쓴다.Progressive disclosure, the tool version — read only what you need, write only what you need.
[추론] 도구는 컨텍스트를 쓴다 — 큰 파일을 통째로 Read하면 그만큼 윈도우를 채운다. Grep로 위치를 좁히고, Read는 범위를 지정하고, Edit는 부분만 바꾼다(전체 Write 회피).[inference] Tools use context — Read a big file whole and it fills the window that much. Grep narrows the spot, Read targets a range, Edit changes only a part (avoid a full Write).
읽고 → 기다리고 → 읽고 → 기다리고.read → wait → read → wait.
한 턴에 Read 3개를 동시에.three Reads at once in one turn.
[추론] 결과가 서로 의존하지 않는 도구 호출(여러 파일 Read, 독립 Grep)은 한 메시지에 묶어 동시에 보낼 수 있어 왕복(지연)이 준다. 단 ‘A 결과로 B를 결정’하는 의존 관계는 순차여야 한다. → 독립이면 병렬, 의존이면 순차.[inference] Tool calls whose results don't depend on each other (multiple file Reads, independent Greps) can be bundled into one message and sent at once, cutting round-trips (latency). But a ‘B decided by A's result’ dependency must stay sequential. → Independent: parallel; dependent: sequential.
10강의 ”한 조각 → 확인 → 다음”과 똑같은 모양.Same shape as Session 10's ”one piece → verify → next”.
[추론] 도구 호출은 단방향 명령이 아니라 루프다 — Claude가 행동하고, 환경이 실제 결과(출력·에러·파일 내용)를 돌려주면, 그걸 보고 다음 행동을 정한다. → s10의 ‘하고–확인–다음’ 루프의 엔진이 바로 도구.[inference] A tool call isn't a one-way command but a loop — Claude acts, the environment returns the real result (output·error·file contents), and it reads that to decide the next action. → The engine of last time's ‘do–verify–next’ loop is the tool.
[출처: docs.anthropic.com/en/docs/claude-code/sub-agents] Agent(서브에이전트) 도구는 별도 컨텍스트에서 작업을 수행하고 결과만 반환한다 — 메인 대화의 컨텍스트 오염을 막는다. 동작·옵션은 2026-06 기준, 버전마다 갱신. → 크고 독립적인 탐색·검색은 통째로 위임하고 결과만 검증.[source: docs.anthropic.com/en/docs/claude-code/sub-agents] The Agent (subagent) tool runs work in a separate context and returns only the result — preventing context pollution of the main conversation. Behavior·options are as of 2026-06 and change by version. → Delegate big, independent search whole, and verify only the result.
| 도구Tool | 하는 일What it does |
|---|---|
| WebSearch | 키워드로 최신 정보 찾기Find recent info by keyword |
| WebFetch | 특정 URL의 내용 가져오기Fetch the contents of a specific URL |
학습 시점 이후의 사실은 떠올리지 말고 도구로 조회 — 단 조회 결과도 검증 대상.For facts past the training cutoff, look them up, don't recall — but the lookup result is also subject to verification.
[출처: docs.anthropic.com/en/docs/claude-code/overview] WebSearch는 키워드 검색, WebFetch는 지정 URL의 내용을 가져온다 — 모델 학습 이후의 사실을 보강하는 도구. 동작·가용 여부는 2026-06 기준, 환경/버전에 따라 다름.[source: docs.anthropic.com/en/docs/claude-code/overview] WebSearch searches by keyword, WebFetch pulls the contents of a given URL — tools to supplement facts past the model's training. Behavior·availability are as of 2026-06 and vary by environment/version.
[추론] 도구 결과는 ‘추측’보다 사실에 가깝지만 무오류는 아니다 — 잘못된 명령, 빈 검색, 엉뚱한 경로는 ‘성공적으로’ 틀린 결과를 준다. → 다음: 믿을 때 vs 의심할 때.[inference] Tool results are closer to fact than a guess but not error-free — a wrong command, an empty search, a wrong path can return a ‘successfully’ wrong result. → Next: when to trust vs when to doubt.
[추론] 5항목은 각각 슬라이드 03·05·07·06·09의 도구 사실과 1:1 대응. 도구 결과는 ‘성공처럼 보여도’ 틀릴 수 있어 읽는 눈이 필요하다. → 도구를 쓰는 법 절반, 결과를 읽는 법 절반.[inference] The 5 map one-to-one onto the tool facts of slides 03·05·07·06·09. A tool result can be wrong ‘even when it looks successful’, so you need an eye to read it. → Using the tools is half; reading their results is the other half.
[추론] Rule No.1(결과를 믿지 말고 검증하라)·No.2(컨텍스트를 지켜라)·No.11(도구를 써라)이 만나는 지점 — 도구로 사실을 얻되, 컨텍스트를 아끼고, 결과를 검증한다.[inference] Where Rule No.1 (don't trust the output)·No.2 (protect the context)·No.11 (use the tools) meet — get facts from tools, save context, and verify the result.
[추론] 말은 검증할 수 없고, 도구 호출은 결과가 남아 검증된다. ‘말로만’은 그럴듯한 보고, ‘도구로’는 확인 가능한 사실. → 이게 Rule No.11의 핵심.[inference] Talk can't be verified; a tool call leaves a result that can. ‘Talk only’ is a plausible report; ‘with tools’ is a verifiable fact. → That's the heart of Rule No.11.
한 단어로: 말 → 도구 → 검증.In one word: talk → tool → verify.
다음 강 예고 — 도구함이 부족하면? 직접 만든다 — MCP & Hooks.Next up — not enough tools? Build your own — MCP & Hooks.
As of 2026-06 · 도구는 늘어나도 ‘말 대신 도구, 결과는 다시 읽기’라는 습관은 그대로 갑니다. [추론]As of 2026-06 · tools keep growing, but the habit — ‘a tool instead of talk, and read the result back’ — stays the same. [inference]