커뮤니티 입장하기

클로드 코드를 실무에 쓰는 법

10개 개념, 총 학습 약 147분

클로드 코드(Claude Code) 중급: 실무 설정과 운영

클로드 코드(Claude Code) 중급은 설치를 마친 사용자가 CLAUDE.md와 권한, 스킬, 훅, 서브에이전트, MCP, Git, 비용, 원격 사용, 문제 해결을 실무에 맞게 설정하는 방법을 정리한 코스입니다. 앤트로픽이 운영하는 code.claude.com/docs의 공식 문서를 한국어 사용자가 실무에 바로 옮길 수 있도록 정리했고, 각 편 끝의 참고 자료에 원문 링크를 모았습니다.

입문 코스 비개발자를 위한 Claude Code가 각 기능이 무엇인지 알려 준다면, 이 코스는 그 기능을 설정 파일에 어떻게 적고 어디서 막히는지를 다룹니다. 기능 이름과 버전은 2026년 9월 28일 공식 문서 기준이라, 클로드 코드를 업데이트한 뒤에는 달라진 부분이 있을 수 있습니다.

📚 다루는 개념 10가지

순서대로 읽으면 규칙을 정하고 자동화를 붙인 뒤 운영하는 흐름으로 이어지고, 급한 문제가 있다면 문제 해결 편부터 골라 읽어도 괜찮습니다.

❓ 자주 묻는 질문

입문 코스를 먼저 봐야 하나요?

클로드 코드를 설치하고 몇 번 써 봤다면 바로 시작해도 됩니다. 각 편은 입문 코스의 해당 편을 링크로 연결하고 개념 설명은 반복하지 않으므로, 훅이나 MCP가 처음이라면 입문 편을 먼저 보는 편이 이해가 빠릅니다.

코딩을 모르는 사람도 따라갈 수 있나요?

설정 파일은 JSON과 마크다운이라 예시를 그대로 옮기면 됩니다. 셸 스크립트가 나오는 편은 훅 실전 하나이고, 그 예시도 어떤 줄이 무엇을 하는지 주석을 붙였습니다.

다른 코딩 에이전트에도 통하는 내용인가요?

CLAUDE.md와 AGENTS.md, 권한 모드, 워크트리 같은 개념은 코덱스나 제미나이 CLI에도 비슷한 기능이 있습니다. 도구마다 다른 점은 코딩 에이전트 입문 코스에서 나란히 비교했습니다.

🔗 함께 보는 코스

10개 개념총 학습 약 147분

3줄 요약

이번 방문에서 한 편은 바로 볼 수 있습니다.

1

CLAUDE.md 작성법 (적을 것과 뺄 것) 익히기

CLAUDE.md는 클로드 코드가 세션을 시작할 때마다 읽는 프로젝트 지침 파일로, 매번 필요한 사실과 규칙만 짧게 적는 곳입니다. 코드를 읽으면 알 수 있는 내용과 여러 단계 절차는 빼고, 반드시 막아야 할 일은 훅이나 권한 설정으로 옮깁니다.

16분→
2

클로드 코드 권한 모드와 허용 규칙 설정하기

클로드 코드의 권한 모드는 도구를 쓰기 전에 사람에게 물어볼 범위를 정하는 설정이고, 허용 규칙은 특정 명령과 파일을 늘 허용하거나 막는 목록입니다. 모드는 Shift+Tab과 시작 옵션으로 바꾸고, 규칙은 settings.json의 allow, ask, deny에 적습니다.

15분→
3

클로드 코드 스킬 만들기 (SKILL.md 구조와 트리거)

클로드 코드 스킬은 SKILL.md와 보조 파일을 담은 폴더로, 평소에는 설명만 컨텍스트에 두고 필요할 때 본문을 불러와 반복 절차를 수행하게 하는 확장 기능입니다. 설명(description)이 자동 호출의 기준이 되고, 부작용이 있는 스킬은 사람만 부르도록 막아 둡니다.

14분→
4

클로드 코드 훅 실전 (저장 뒤 검사와 커밋 전 검사)

클로드 코드 훅은 도구를 쓰기 전후나 응답이 끝날 때처럼 정해진 시점에 자동으로 실행되는 명령으로, 모델의 판단과 관계없이 검사와 차단을 거는 장치입니다. 저장 뒤 검사는 PostToolUse로, 커밋 전 검사는 PreToolUse와 종료 코드 2로 만듭니다.

15분→
5

클로드 코드 서브에이전트 실전 (조사와 검수 나누기)

클로드 코드 서브에이전트는 주 대화와 분리된 컨텍스트에서 따로 일하고 요약만 돌려주는 보조 에이전트로, 자기 시스템 프롬프트와 도구 권한, 모델을 따로 가집니다. 긴 조사와 결과 검수를 서브에이전트에 나눠 맡기면 주 대화의 컨텍스트가 덜 찹니다.

16분→
6

클로드 코드 MCP 서버 연결하기 (설정 파일, 권한, 오류)

클로드 코드의 MCP 서버 연결은 claude mcp add 명령이나 .mcp.json 파일로 외부 도구 서버를 등록해 클로드가 그 도구를 쓰게 하는 설정입니다. 등록 범위는 local, project, user 세 가지이고, 연결 상태와 인증은 /mcp에서 확인합니다.

13분→
7

클로드 코드 Git 작업 흐름 (브랜치, 커밋, 워크트리)

클로드 코드의 Git 작업 흐름은 브랜치를 나눠 작업하고, 확인한 변경만 커밋과 PR로 남기며, 여러 작업을 동시에 할 때는 워크트리로 폴더를 나누는 사용 방식입니다. 세션 안의 빠른 되돌리기는 체크포인트가, 영구 기록과 협업은 Git이 맡습니다.

13분→
8

클로드 코드 비용과 한도 관리 (캐시, 컨텍스트, 모델 선택)

클로드 코드의 비용과 한도 관리는 프롬프트 캐시가 끊기지 않게 작업하고, 컨텍스트를 제때 비우거나 줄이며, 작업에 맞는 모델과 추론 수준을 골라 같은 한도로 더 오래 쓰는 방법입니다. /usage의 캐시 줄과 상태줄로 무엇이 사용량을 쓰는지 확인합니다.

15분→
9

클로드 코드 클라우드 세션과 원격 사용 (웹, Remote Control, SSH)

클로드 코드의 클라우드 세션은 앤트로픽이 관리하는 가상 머신에서 도는 세션이고, Remote Control은 내 컴퓨터에서 도는 세션을 웹과 휴대폰에서 조작하는 연결입니다. 컴퓨터를 꺼도 되는지와 내 컴퓨터의 파일이 필요한지에 따라 둘 가운데 하나를 고릅니다.

16분→
10

클로드 코드 자주 나는 문제와 해결 (설치, 로그인, 멈춤)

클로드 코드 문제 해결은 증상을 설치, 로그인, 설정, 성능 네 가지로 나누고 claude doctor와 /doctor로 원인을 좁힌 뒤 공식 문서의 해당 항목을 따라가는 과정입니다. 명령을 못 찾는 문제는 대부분 설치 폴더가 PATH에 없어서 생깁니다.

14분→