클로드 코드 기초 총정리, 슬래시 명령·파일 도구·Bash·권한·서브에이전트 정리
클로드 코드를 막 시작해 도구가 몇 개나 되는지 모르겠다는 분께 맞습니다. 기본 슬래시 명령부터 파일 도구, Bash, 권한, 서브에이전트까지 한 번에 정리했습니다.
클로드 코드의 기본 도구는 슬래시 명령, 파일 도구(Read·Edit·Write), Bash, 권한 설정, 서브에이전트입니다. 도구를 쓰는 손과 그 도구를 안전하게 쓰는 규칙을 함께 익히면 됩니다.
클로드 코드 기본기를 연습하려고 해. 1. /clear와 /compact가 각각 무엇을 하는지 설명해 줘. 2. 이 프로젝트에서 파일 하나를 먼저 읽고(Read), 그다음 고치는(Edit) 순서를 함께 해 줘. 3. 결과가 길게 나오는 작업 하나를 서브에이전트에게 맡길 수 있는지 알려 줘. 각 단계가 끝날 때마다 무엇이 달라졌는지 한 줄로 정리해 줘.
클로드 코드 기초 총정리 시리즈 중, 이 글은 시즌1 후반(3~7편)과 시즌2 첫 편이 만나는 경계 지점을 다룹니다. 시즌1 초반(1~2편)에서는 설치와 CLAUDE.md(프로젝트 규칙 파일)를 다뤘습니다.
여기서부터는 실제로 손을 움직이는 도구들이 나옵니다. 저도 처음엔 도구가 몇 개나 되는지 몰라서 하나씩 켜 보며 익혔습니다.
각 도구가 무엇인가요
슬래시 명령 기본 (3편)
/clear(대화를 완전히 새로 시작), /compact(지금까지의 대화를 요약해서 이어가기), /help(사용 가능한 명령 목록 보기) 같은 기본 명령을 먼저 익히면 좋습니다. 이 셋만 알아도 세션 관리의 절반은 됩니다.
파일 읽기·편집 기본 동작 (4편)
클로드 코드는 파일을 읽는 도구(Read), 고치는 도구(Edit), 새로 만드는 도구(Write)를 나눠 씁니다.
읽지 않은 파일은 고칠 수 없게 막혀 있습니다. 실수로 엉뚱한 내용을 덮어쓰는 걸 막기 위한 안전장치입니다.
Bash 도구로 터미널 작업하기 (5편)
Bash는 터미널 명령을 실행하는 도구입니다. 파일 검색, 서버 실행, 깃(버전 관리 도구) 조작처럼 터미널에서 하던 일을 그대로 시킬 수 있게 해 줍니다.
권한 설정과 승인 흐름 (6편)
클로드 코드는 파일을 고치거나 명령을 실행하기 전에 승인을 구하도록 기본 설정돼 있습니다. 어떤 종류의 작업까지 자동으로 허용할지는 설정에서 직접 정할 수 있습니다.
세션 이어가기와 컨텍스트 관리 기초 (7편)
세션이 길어지면 앞의 대화를 다시 읽는 비용이 계속 쌓입니다. 토큰과 컨텍스트는 별도 글에서 더 깊이 다뤘습니다.
서브에이전트 기본 개념 (시즌2 1편)
서브에이전트(Subagent)는 하위 작업을 맡아 독립적으로 처리하는 보조 에이전트입니다. 무거운 작업을 따로 떼어 맡기고 요약만 돌려받는 방식이라, 메인 대화의 컨텍스트를 아낄 수 있다는 게 핵심입니다.
/clear와 /compact 비교하기
/clear와 /compact를 각각 한 번씩 실행해 차이를 눈으로 봅니다.
Read로 먼저 열고 Edit로 고치기
파일 하나를 Read로 먼저 열어 본 다음 Edit로 고쳐 봅니다.
서브에이전트에게 맡기고 비교하기
반복 작업 하나를 서브에이전트에게 맡겨 보고, 메인 대화가 얼마나 짧게 유지되는지 비교합니다.
자주 하는 실수
저는 처음에 파일을 읽지 않고 바로 고치려다 막힌 적이 여러 번 있습니다. 읽지 않은 파일은 편집이 막힌다는 규칙을 몰랐던 탓입니다. 읽기 먼저라는 순서를 알고 나니 헤매는 일이 줄었습니다.
자주 묻는 질문
Bash와 Edit 중 뭘 먼저 배워야 하나요?
Edit부터 익히는 편이 낫습니다. 파일을 직접 고치는 일이 더 자주 일어나고, Bash는 필요할 때 명령어를 하나씩 물어보며 써도 됩니다.
승인을 매번 눌러야 하나요?
아닙니다. 반복되는 안전한 작업은 설정에서 자동 허용으로 바꿀 수 있습니다. 다만 파일 삭제처럼 되돌리기 어려운 작업은 승인을 남겨 두는 편이 안전합니다.
서브에이전트는 꼭 써야 하나요?
아닙니다. 짧은 작업은 메인 대화에서 바로 처리하는 게 더 빠릅니다. 결과가 길게 나오는 작업(테스트, 리서치)일 때만 넘기면 됩니다.
정리
이 글은 도구를 쓰는 손과, 그 도구를 안전하게 쓰는 규칙을 함께 다뤘습니다. 다음 단계부터는 도구를 저장하고 자동화하는 단계로 넘어갑니다.