Claude Code가 코드 읽는 3단계, 교육적 함의
클로드는 코드를 ‘읽는’ 것이 아니라 ‘탐색’한다. 수만 줄 코드베이스 앞에서 막막함을 느끼는 건 인간이나 AI나 마찬가지다.
코드베이스 탐색, 세 가지 위상
Claudical 채널의 영상은 Claude Code가 대규모 코드베이스를 탐색하는 효율적인 방법을 제시한다. 핵심은 코드 전체를 한 번에 ‘읽는’ 것이 아니라, 세 가지 도구(Glob, Grep, Read)를 활용해 점진적으로 탐색 범위를 좁혀나가는 전략이다. 마치 지도를 보듯, 코드베이스를 여러 ‘위상’으로 나누어 접근하는 방식이다.
- Glob: 파일 이름 목록을 훑어보며 전체 구조를 파악 (지명 목록)
- Grep: 키워드 검색을 통해 특정 기능이 구현된 위치를 추적 (키워드 색인)
- Read: 특정 파일의 내용을 상세히 분석하여 로직을 이해 (길거리 사진)
이 세 가지 도구는 각각 다른 수준의 정보와 비용을 제공하며, 탐색의 효율성을 극대화하는 데 기여한다. 클로드는 이 세 가지 도구를 순차적으로 사용하며, 마치 깔때기처럼 탐색 범위를 좁혀나간다.
어텐션 분산 문제
클로드가 코드베이스 전체를 한 번에 읽지 않는 이유는 ‘어텐션 분산’이라는 문제 때문이다. 영상에서는 6만 줄 코드에 비유하며, 잉크가 너무 넓게 번지면 글자가 안 보이는 것과 같다고 설명한다. 대규모 텍스트를 처리할 때, AI 모델은 입력 전체에 어텐션을 분산시키는데, 이로 인해 중요한 정보가 희석될 수 있다. 클로드의 세 단계 탐색 전략은 바로 이 어텐션 분산 문제를 해결하기 위한 효과적인 방법이다.
Glob, Grep, Read, 그리고 교육
이 세 가지 도구는 각각 다음과 같은 특징을 지닌다.
| 도구 | 기능 | 정보 수준 | 비용 |
|---|---|---|---|
| Glob | 파일 이름 검색 | 가장 거침 | 낮음 |
| Grep | 키워드 검색 | 중간 | 중간 |
| Read | 파일 내용 전체 읽기 | 가장 정밀 | 높음 |
이러한 도구들의 특징은 교육 현장에도 시사하는 바가 크다. 학생들은 문제를 해결할 때, 무작정 모든 정보를 탐색하는 것이 아니라, Glob처럼 문제의 전체적인 구조를 먼저 파악하고, Grep처럼 관련된 키워드를 중심으로 정보를 검색하며, Read처럼 특정 부분을 집중적으로 분석하는 전략을 활용해야 한다. AI 코딩 도구를 활용한 교육이 효과를 거두려면 교사는 학생들에게 이러한 탐색 전략을 명시적으로 가르쳐야 한다.
반직관적 전환 — Read의 함정
흔히 가장 ‘정확한’ 정보가 가장 ‘좋은’ 정보라고 생각하기 쉽지만, 영상은 Read의 함정을 지적한다. Read는 한 번에 하나의 파일만 처리할 수 있기 때문에, 탐색 범위가 좁혀지지 않은 상태에서 사용하면 오히려 비효율적이다. 즉, ‘결제 실패’라는 키워드를 Grep으로 찾아낸 후, 그 키워드가 포함된 파일만 Read로 읽어야 의미 있는 정보를 얻을 수 있다.
이것은 교육 현장에서도 마찬가지다. 학생들은 문제 해결에 필요한 모든 정보를 ‘다 읽으려고’ 하는 경향이 있다. 하지만 중요한 것은 정보의 양이 아니라, 정보의 ‘선택’과 ‘집중’이다. 교사는 학생들이 문제 해결에 필요한 핵심 정보만 효율적으로 추출하고 분석할 수 있도록 안내해야 한다. 모든 정보를 다 읽는 것이 능사가 아니라, 필요한 정보만 선별하여 깊이 있게 이해하는 것이 중요하다.
도시계획·공간행동학의 시선으로 보면
클로드의 코드 탐색 전략은 도시계획 및 공간행동학에서 사용되는 ‘공간 인지’ 과정과 유사하다. 도시를 처음 방문한 사람은 지도를 보거나 (Glob), 특정 시설의 위치를 검색하거나 (Grep), 특정 장소를 직접 방문하여 경험한다 (Read). 이러한 공간 인지 과정은 클로드의 코드 탐색 전략과 마찬가지로, 점진적으로 정보를 획득하고 공간에 대한 이해도를 높여나가는 과정이다. 도시계획가는 이러한 공간 인지 과정을 고려하여 도시를 설계하고, 시민들이 효율적으로 도시를 탐색하고 이용할 수 있도록 지원해야 한다.
교육 현장에 던지는 질문
클로드의 코드 탐색 전략은 결국 ‘어떻게 효율적으로 정보를 탐색하고 활용할 것인가’라는 질문으로 귀결된다. 이 질문은 AI 코딩 교육뿐만 아니라, 모든 교육 분야에 적용될 수 있는 중요한 화두다. 학생들은 AI 도구를 사용하는 방법을 배우는 것을 넘어, AI 도구를 활용하여 어떻게 학습하고 문제를 해결할 수 있을지를 고민해야 한다.
당신은 교육 현장에서 학생들의 정보 탐색 능력을 향상시키기 위해 어떤 노력을 기울이고 있는가?
출처
- Claudical. (2026-05-18). Claude Code가 코드베이스 탐색하는 3단계: Glob, Grep, Read. YouTube.