클로드 코드(Claude Code) 중급: 실무 설정과 운영
클로드 코드(Claude Code) 중급은 설치를 마친 사용자가 CLAUDE.md와 권한, 스킬, 훅, 서브에이전트, MCP, Git, 비용, 원격 사용, 문제 해결을 실무에 맞게 설정하는 방법을 정리한 코스입니다. 앤트로픽이 운영하는 code.claude.com/docs의 공식 문서를 한국어 사용자가 실무에 바로 옮길 수 있도록 정리했고, 각 편 끝의 참고 자료에 원문 링크를 모았습니다.
입문 코스 비개발자를 위한 Claude Code가 각 기능이 무엇인지 알려 준다면, 이 코스는 그 기능을 설정 파일에 어떻게 적고 어디서 막히는지를 다룹니다. 기능 이름과 버전은 2026년 10월 3일 공식 문서 기준이라, 클로드 코드를 업데이트한 뒤에는 달라진 부분이 있을 수 있습니다.
첫 연습은 새 폴더에서 세 편만 진행합니다
Claude Code에 로그인할 수 있는 계정, 터미널과 텍스트 편집기를 준비합니다. 기존 업무 폴더 대신 새 연습 폴더를 사용하고 각 편의 가상 메모로 시작합니다. 실제 고객 자료나 API 키를 예제에 넣을 필요는 없습니다. 버전 출력이나 로그인이 되지 않으면 문제 해결 편의 시작 순서를 먼저 따릅니다.
- CLAUDE.md 작성법에서 날짜와 장소를 바꾸지 않는 규칙을 적고 가상 메모와 답을 대조합니다.
- 권한 모드와 허용 규칙에서 가상 파일의 읽기 요청과 실제 차단 기록을 확인합니다.
- 스킬 만들기에서 시간 미정을 유지하는 수동 요약을 만들고 빠진 항목을 고쳐 다시 호출합니다.
이후 Git으로 변경을 기록하고 비용과 문제 해결 편으로 실행 상태를 확인합니다. 훅, 서브에이전트, MCP, mods와 원격 연결은 해당 기능이 필요한 때 진행합니다. 첫 실습을 위해 모든 기능을 한 번에 켜지는 않습니다.
📚 다루는 개념 11가지
- 규칙과 권한 정하기: CLAUDE.md 작성법, 권한 모드와 허용 규칙
- 자동화 붙이기: 스킬 만들기, 훅 실전, 서브에이전트 실전, MCP 서버 연결, mods로 화면과 도구 호출 바꾸기
- 작업 흐름 관리하기: Git 작업 흐름, 비용과 한도 관리
- 어디서든 쓰고 고치기: 클라우드 세션과 원격 사용, 자주 나는 문제와 해결
순서대로 읽으면 규칙을 정하고 자동화를 붙인 뒤 운영하는 흐름으로 이어지고, 급한 문제가 있다면 문제 해결 편부터 골라 읽어도 괜찮습니다.
결과를 확인하고 한 번 더 고칩니다
각 실습에서 원자료, 요청, 실제 도구 실행 기록과 결과를 남깁니다. “규칙을 지켰습니다”라는 답만 보지 말고 파일 값과 실행 기록을 확인합니다. 틀린 부분이 있으면 원본의 값을 제시해 수정한 뒤 같은 작업을 다시 합니다.
예를 들어 서브에이전트 검수에서는 장소와 시간의 오류 두 개를 찾은 뒤 직접 고친 파일을 다시 대조합니다. 그다음 날짜만 바꾸어 새로운 오류도 찾는지 확인합니다. 세션 사용량을 비웠다는 표시가 계정 한도의 초기화를 뜻하는 것은 아니며, 연결됨 표시도 실제 자료 조회가 성공했다는 증거는 아닙니다.
한 가지 설정을 바꾼 전후 결과를 설명하고, 남은 오류와 미확인 항목을 적을 수 있으면 해당 연습을 마친 것입니다. 연습용 설정이 실제 업무의 모든 오류를 막는다고 가정하지 않습니다.
❓ 자주 묻는 질문
입문 코스를 먼저 봐야 하나요?
클로드 코드를 설치하고 몇 번 써 봤다면 바로 시작해도 됩니다. 각 편은 입문 코스의 해당 편을 링크로 연결하고 개념 설명은 반복하지 않으므로, 훅이나 MCP가 처음이라면 입문 편을 먼저 보는 편이 이해가 빠릅니다.
코딩을 모르는 사람도 따라갈 수 있나요?
새 연습 폴더의 예제부터 따라갈 수 있습니다. JSON은 괄호와 쉼표를 포함해 형식을 맞춰야 하는 설정 파일이고, 마크다운은 제목과 본문을 적는 텍스트 형식입니다. 기존 설정 파일이 있다면 통째로 덮어쓰지 말고 원본을 보존한 뒤 필요한 항목만 합칩니다. 훅 편의 셸 스크립트는 필요한 도구와 종료 코드까지 확인하며 진행합니다.
다른 코딩 에이전트에도 통하는 내용인가요?
CLAUDE.md와 AGENTS.md, 권한 모드, 워크트리 같은 개념은 코덱스나 제미나이 CLI에도 비슷한 기능이 있습니다. 파일 이름, 지원 필드와 권한 문법은 도구마다 다르므로 설정을 그대로 복사하지 않습니다. 도구마다 다른 점은 코딩 에이전트 입문 코스에서 나란히 비교했습니다.
🔗 함께 보는 코스
- 비개발자를 위한 Claude Code: 설치, 슬래시 명령, 플랜 모드 같은 입문 개념을 다룹니다
- 코딩 에이전트 입문: 코덱스 CLI, 제미나이 CLI, 안티그래비티와 권한 설정 원칙을 다룹니다
- 클로드(Claude) 실무 활용: 채팅 화면에서 쓰는 스킬, 프로젝트, 코워크를 다룹니다
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
CLAUDE.md 작성법 (적을 것과 뺄 것) 익히기
CLAUDE.md는 클로드 코드가 세션을 시작할 때마다 읽는 프로젝트 지침 파일로, 매번 필요한 사실과 규칙만 짧게 적는 곳입니다. 반복해서 필요한 지시를 구체적으로 적고, 반드시 막아야 하는 동작은 별도 통제 방법을 검증합니다.
클로드 코드 권한 모드와 허용 규칙 설정하기
클로드 코드의 권한 모드는 도구 실행 전에 승인을 확인하는 방식을 정합니다. allow와 ask 및 deny 규칙은 특정 도구와 명령의 허용, 확인과 차단을 정하며 사용자가 맡긴 업무 범위를 대신하지 않습니다.
클로드 코드 스킬 만들기 (SKILL.md 구조와 트리거)
클로드 코드 스킬은 반복할 작업의 설명과 절차를 SKILL.md에 모아 필요할 때 불러오는 기능입니다. 먼저 작은 작업을 직접 호출해 결과를 확인한 뒤 자동 호출 조건을 다듬습니다.
클로드 코드 훅 실전 (저장 뒤 검사와 커밋 전 검사)
클로드 코드 훅은 정해진 이벤트가 발생하면 등록한 검사를 실행하는 기능입니다. 실행 전 훅은 조건에 따라 도구를 막을 수 있고, 실행 후 훅은 이미 끝난 작업을 되돌리지 못합니다.
클로드 코드 서브에이전트 실전 (조사와 검수 나누기)
클로드 코드 서브에이전트는 주 대화와 분리된 컨텍스트에서 따로 일하고 요약만 돌려주는 보조 에이전트로, 자기 시스템 프롬프트와 도구 권한, 모델을 따로 가집니다. 긴 조사와 결과 검수를 서브에이전트에 나눠 맡기면 주 대화의 컨텍스트가 덜 찹니다.
클로드 코드 MCP 서버 연결하기 (설정 파일, 권한, 오류)
클로드 코드의 MCP 서버 연결은 claude mcp add 명령이나 .mcp.json 파일로 외부 도구 서버를 등록해 클로드가 그 도구를 쓰게 하는 설정입니다. 등록 범위는 local, project, user 세 가지이고, 연결 상태와 인증은 /mcp에서 확인합니다.
클로드 코드 Git 작업 흐름 (브랜치, 커밋, 워크트리)
클로드 코드의 Git 작업 흐름은 브랜치를 나눠 작업하고, 확인한 변경만 커밋과 PR로 남기며, 여러 작업을 동시에 할 때는 워크트리로 폴더를 나누는 사용 방식입니다. 세션 안의 빠른 되돌리기는 체크포인트가, 변경 기록과 협업은 Git이 맡습니다.
클로드 코드 비용과 한도 관리 (캐시, 컨텍스트, 모델 선택)
클로드 코드의 비용과 한도 관리는 사용량 화면에서 현재 상태를 확인하고, 작업에 필요한 대화와 모델 설정을 선택하는 일입니다. 대화를 정리해도 이미 쓴 사용량이나 청구액이 취소되지는 않습니다.
클로드 코드 클라우드 세션과 원격 사용 (웹, Remote Control, SSH)
클로드 코드의 클라우드 세션은 별도 클라우드 환경에서 작업하고, Remote Control은 내 컴퓨터의 세션을 다른 기기에서 조작합니다. 작업을 실행하는 컴퓨터와 필요한 파일의 위치를 먼저 확인합니다.
클로드 코드 자주 나는 문제와 해결 (설치, 로그인, 멈춤)
클로드 코드 문제 해결은 오류 문구와 실행 환경을 기록하고 설치, 로그인, 설정, 성능 중 해당 증상을 확인하는 과정입니다. 명령을 찾을 수 있는지부터 검사하고 한 가지씩 바꾼 뒤 같은 동작을 다시 확인합니다.
클로드 코드 mods (화면과 도구 호출을 바꾸는 플러그인)
클로드 코드 mod는 Claude Code 안에서 실행되는 JavaScript 또는 TypeScript 함수를 담은 플러그인입니다. 도구 호출, 프롬프트, 명령과 화면 그리기 같은 이벤트를 관찰하거나 바꾸거나 직접 처리하며, 샌드박스 없이 사용자 권한으로 실행됩니다.