클로드 코드(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와 원격 연결은 그 기능이 필요한 때 진행합니다. 첫 실습을 위해 모든 기능을 한 번에 켜지는 않습니다.
📚 다루는 개념 7가지
- 규칙과 권한 정하기: CLAUDE.md 작성법, 권한 모드와 허용 규칙
- 자동화 붙이기: MCP 서버 연결, mods로 화면과 도구 호출 바꾸기
- 작업 흐름 관리하기: Git 작업 흐름
- 어디서든 쓰고 고치기: 클라우드 세션과 원격 사용, 자주 나는 문제와 해결
자동화와 비용 관리는 클로드 실무 활용 코스의 스킬 만들기와 비개발자를 위한 Claude Code 코스의 훅, 서브에이전트, 비용과 한도 관리에서 함께 읽습니다.
순서대로 읽으면 규칙을 정하고 자동화를 붙인 뒤 운영하는 흐름으로 이어지고, 급한 문제가 있다면 문제 해결 편부터 골라 읽어도 괜찮습니다.
결과를 확인하고 한 번 더 고칩니다
각 실습에서 원자료, 요청, 실제 도구 실행 기록과 결과를 남깁니다. “규칙을 지켰습니다”라는 답만 보지 말고 파일 값과 실행 기록을 확인합니다. 틀린 부분이 있으면 원본의 값을 제시해 수정한 뒤 같은 작업을 다시 합니다.
예를 들어 서브에이전트 검수에서는 장소와 시간의 오류 두 개를 찾은 뒤 직접 고친 파일을 다시 대조합니다. 그다음 날짜만 바꾸어 새로운 오류도 찾는지 확인합니다. 세션 사용량을 비웠다는 표시가 계정 한도의 초기화를 뜻하는 것은 아니며, 연결됨 표시도 실제 자료 조회가 성공했다는 증거는 아닙니다.
한 가지 설정을 바꾼 전후 결과를 설명하고, 남은 오류와 미확인 항목을 적을 수 있으면 그 편의 연습을 마친 것입니다. 연습용 설정이 실제 업무의 모든 오류를 막는다고 가정하지 않습니다.
❓ 자주 묻는 질문
입문 코스를 먼저 봐야 하나요?
클로드 코드를 설치하고 몇 번 써 봤다면 바로 시작해도 됩니다. 각 편은 같은 기능을 다룬 입문 코스의 편을 링크로 연결하고 개념 설명은 반복하지 않으므로, 훅이나 MCP가 처음이라면 입문 편을 먼저 보는 편이 이해가 빠릅니다.
코딩을 모르는 사람도 따라갈 수 있나요?
새 연습 폴더의 예제부터 따라갈 수 있습니다. JSON은 괄호와 쉼표를 포함해 형식을 맞춰야 하는 설정 파일이고, 마크다운은 제목과 본문을 적는 텍스트 형식입니다. 기존 설정 파일이 있다면 통째로 덮어쓰지 말고 원본을 보존한 뒤 필요한 항목만 합칩니다. 훅 편의 셸 스크립트는 필요한 도구와 종료 코드까지 확인하며 진행합니다.
다른 코딩 에이전트에도 통하는 내용인가요?
CLAUDE.md와 AGENTS.md, 권한 모드, 워크트리 같은 개념은 코덱스나 제미나이 CLI에도 비슷한 기능이 있습니다. 파일 이름, 지원 필드와 권한 문법은 도구마다 다르므로 설정을 그대로 복사하지 않습니다. 도구마다 다른 점은 코딩 에이전트 입문 코스에서 나란히 비교했습니다.
🔗 함께 보는 코스
- 비개발자를 위한 Claude Code: 설치, 플랜 모드, 플랜과 사용량 같은 입문 개념을 다룹니다
- 코딩 에이전트 입문: 코덱스 CLI, 제미나이 CLI, 안티그래비티와 권한 설정 원칙을 다룹니다
- 클로드(Claude) 실무 활용: 채팅 화면에서 쓰는 스킬, 프로젝트, 코워크를 다룹니다
세 줄로 먼저 읽기
- 새 연습 폴더에서 지침과 권한 및 수동 스킬부터 하나씩 적용하고 실제 결과를 확인합니다.
- 훅과 서브에이전트 및 MCP는 필요한 경우에 추가하며 실행 기록과 원본을 대조해 동작을 검증합니다.
- 사용량과 오류를 기록하고 설정 하나를 바꾼 뒤 같은 작업을 다시 실행해 변화와 남은 문제를 확인합니다.
CLAUDE.md 작성법 (적을 것과 뺄 것) 익히기
CLAUDE.md는 Claude Code가 세션을 시작할 때마다 읽는 지침 파일로, 세션마다 다시 설명하게 되는 사실과 규칙을 적어 두는 곳입니다. Claude가 혼자 알 수 없는 규칙만 확인할 수 있는 문장으로 짧게 적고, 반드시 막아야 하는 동작은 권한 규칙이나 훅으로 막습니다.
클로드 코드 권한 모드와 허용 규칙 설정하기
클로드 코드의 권한 규칙은 특정 명령과 파일을 묻지 않고 실행할지(allow), 실행 전에 물어볼지(ask), 막을지(deny) 정해 두는 설정으로, settings.json 파일의 permissions 항목에 적습니다. 어느 규칙에도 맞지 않는 명령은 권한 모드가 처리합니다.
클로드 코드 MCP 서버 연결하기 (설정 파일, 권한, 오류)
클로드 코드의 MCP 서버 연결은 claude mcp add 명령이나 .mcp.json 파일로 MCP 서버를 등록해 Claude가 그 서버의 도구를 쓰게 하는 설정입니다. 등록 범위는 local, project, user 세 가지이고, 연결 상태와 로그인은 /mcp에서 확인합니다.
클로드 코드 Git 작업 흐름 (브랜치, 커밋, 워크트리)
클로드 코드의 Git 작업 흐름은 Claude가 고친 파일을 사용자가 확인한 뒤 필요한 변경만 커밋으로 남기고, 확인이 끝나지 않은 작업은 브랜치나 워크트리로 나눠 두는 사용 방식입니다. Claude Code의 체크포인트는 세션 안의 빠른 되돌리기를, Git 커밋은 오래 남기는 기록을 맡습니다.
클로드 코드 클라우드 세션과 원격 사용 (웹, Remote Control, SSH)
클로드 코드의 클라우드 세션은 Anthropic이 관리하는 클라우드 컴퓨터에서 실행되는 Claude Code 세션이라 내 노트북을 닫아도 작업이 계속되고, Remote Control은 내 컴퓨터에서 실행 중인 세션을 휴대폰의 Claude 앱이나 브라우저에서 이어 쓰는 기능이라 그 컴퓨터가 켜져 있어야 합니다.
클로드 코드 자주 나는 문제와 해결 (설치, 로그인, 멈춤)
클로드 코드 문제 해결은 화면에 나온 증상과 오류 문구로 막힌 곳이 설치, 로그인, 세션 가운데 어디인지 먼저 정하고, 그곳을 확인하는 명령(claude --version, claude doctor, claude auth status, /doctor)부터 실행해 원인을 좁히는 일입니다.
클로드 코드 mods (화면과 도구 호출을 바꾸는 플러그인)
클로드 코드 mod는 Claude Code의 화면과 동작을 바꾸는 플러그인으로, JavaScript나 TypeScript 함수가 Claude Code 안에서 실행됩니다. 도구 호출, 프롬프트, 화면 그리기 같은 이벤트를 관찰하거나 바꾸거나 직접 처리하며 샌드박스 없이 사용자 권한으로 실행됩니다.