CPN 한국어 자습서 · Claude Certified Developer — Foundations Prep
3-1 · 모듈 3 소개
Module Introduction · Claude Code, MCP & Integration
Claude Code는 터미널 안에서 함께 일하는 개발 파트너입니다. 앞선 모듈에서 다룬 프롬프트·도구 스키마·컨텍스트·에이전트 루프 위에, 이번 모듈은 권한 관리와 설정, 팀 공유, 그리고 외부 서비스 연결을 얹습니다. 이 첫 레슨은 본격적인 실습에 앞서 모듈 전체의 지도를 펼쳐 봅니다 — 무엇을 할 수 있게 되는지, 어떤 문제를 반복해서 풀게 되는지, 그리고 이 모듈이 누구를 위한 것인지.
이 장에서 살펴보는 것In this orientation
약 2분이 모듈을 마치면 할 수 있게 되는 여섯 가지
모듈을 관통하는 하나의 문제 — "내 컴퓨터에서는 됐는데"
이 모듈의 대상과, 다시 다루지 않는 내용
모듈 3 전체의 차례 — 아홉 단계
Claude Code는 지금까지 API로 다루던 같은 모델을, 이번에는 터미널 환경에서 그대로 실행할 수 있게 해 줍니다. 여기에는 권한을 다루는 계층, 설정을 관리하는 시스템, 그리고 팀과 나눠 쓰는 기능이 함께 들어 있습니다.
앞선 모듈에서 프롬프트, 도구 스키마, 컨텍스트 엔지니어링, 에이전트 루프, 멀티모달 입력 같은 API의 기본 구성 요소를 세워 두었습니다. 이번 모듈은 그 위에 바로 이어집니다. 새로 배우는 것은 그 구성 요소들을 설정하고, 나누고, 실제 시스템에 안전하게 연결하는 방법입니다.
여기에 MCP가 더해집니다. MCP는 Claude를 외부 서비스와 안전하게 연결하도록 해 주는 규약(protocol)인데, 자세한 내용은 모듈 후반부에서 다룹니다. 이 레슨에서 기억해 둘 것은, 이번 모듈의 목표가 결국 하나로 모인다는 점입니다 — 동작하는 통합을 어떻게 설정하고, 어떻게 안전하게 배포하는가.
이번 모듈을 마치면 다음 여섯 가지를 할 수 있게 됩니다. 지금 전부 이해할 필요는 없고, 각 레슨이 하나씩 맡아 자세히 설명합니다.
CLAUDE.md, 규칙 파일, 훅(hook), 서브에이전트 같은 장치로 Claude Code에 오래 유지되는 프로젝트 맥락을 넣어 둡니다.여섯 가지가 서로 달라 보이지만, 공통점이 하나 있습니다. 전부 동작하던 것을 다른 환경에서도 버티게 만드는 결정이라는 점입니다. 바로 다음에 그 이야기를 합니다.
이 모듈의 모든 내용은 하나의 문제를 중심으로 짜여 있습니다. 내 컴퓨터에서, 내 세션에서, 스테이징에서 잘 되던 코드가, 다른 사람이 실행하고 프로덕션에서 실제 회사 시스템을 상대할 때에도 버텨야 한다는 것입니다.
내 컴퓨터에서는 모든 것이 편했습니다. 권한 모드는 안전해 보였고, 프로젝트 규칙은 눈으로 따라갈 만큼 짧았고, 스킬은 자기 스크립트를 잘 찾았고, 인증 키는 설정 파일에 그대로 있었고, 연결은 스테이징 시험에서 잘 됐습니다. 그런데 작업이 내 컴퓨터를 떠나는 순간, 편했던 그 하나하나가 오히려 문제가 되기 쉽습니다.
CONVENIENCE → FAILURE — 편할 때 놓치기 쉬운 지점
| 내 컴퓨터에서는 편했던 것 | 환경이 바뀌면 이렇게 문제가 될 수 있다 |
|---|---|
| 권한 모드가 안전해 보였다. | 범위에 없던 파일까지 지우는 권한 모드. |
| 프로젝트 규칙이 눈으로 따라갈 만큼 짧았다. | 정작 필요한 규칙 하나가 수백 줄 아래에 묻힘. |
| 스킬이 자기 스크립트를 잘 찾았다. | 다른 어느 컴퓨터에도 없는 경로를 가리키는 스킬. |
| 인증 키가 설정 파일에 그대로 있었다. | 커밋한(저장소에 올린) 키가 몇 시간 안에 새어 나감. |
| 연결이 스테이징 시험에서 잘 됐다. | 스테이징에서만 하던 설정 한 단계가 프로덕션 연결을 끊음. |
그래서 이 모듈에서 배우는 것은, 어떤 설정 결정이 어떤 실패를 막아 주는지입니다. 그것도 동료나 보안 검토 담당자 앞에서 문제가 드러나기 전에 말입니다.
"내 컴퓨터에서는 됐는데"라는 말, 개발하다 보면 자주 듣습니다. 이 모듈은 바로 그 상황을 미리 막는 설정을 하나씩 익히는 과정입니다.
이 모듈은 이미 Claude로 코드를 다뤄 본 개발자를 위한 것입니다. 실무적이고, 코드를 앞세우고, 패턴으로 생각하는 데 익숙한 분을 가정합니다.
모듈 2에서 다룬 API 패턴에 익숙하다는 전제 위에서 시작합니다. 그래서 에이전트 루프, 도구 스키마, 컨텍스트 엔지니어링은 다시 설명하지 않습니다. 대신 동작하는 통합 주변의 엔지니어링 결정을 다룹니다 — 권한 모델 아래에서 터미널의 Claude Code를 실행하는 법, 오래가는 프로젝트 맥락을 넘겨주는 법, 동료가 그대로 설치할 수 있게 작업 흐름을 묶는 법, 그리고 인증 정보를 흘리거나 보안 검토에서 걸리지 않으면서 Claude를 외부·기업 시스템에 연결하는 법입니다.
MODULE 3 · 9 STEPS — 이 모듈의 차례
| 01 | 모듈 소개 (지금 이 레슨) |
|---|---|
| 02 | 권한 모드와 사람의 검토 지점 |
| 03 | 오래가는 프로젝트 맥락 |
| 04 | 작업 흐름 묶기 |
| 05 | MCP 서버 |
| 06 | 기업 시스템 통합 |
| 07 | 통합 종합 과제 |
| 08 | 핵심 정리 |
| 09 | 모듈 마무리 |
레슨마다 강의로 개념을 익히고, 흔히 놓치는 지점을 주의점으로 짚은 뒤, 점검으로 확인하는 흐름이 이어집니다. 그리고 07번에서 그동안 배운 것을 하나로 모으는 종합 과제를 풉니다.
본격적인 실습에 들어가기 전에, 방금 펼쳐 본 모듈의 지도를 두 문항으로 짧게 확인해 봅니다. 정답을 먼저 떠올려 본 뒤 골라 보세요. 맞히면 설명이 나옵니다.
Q1이 모듈이 다시 가르치지 않는다고 밝힌 것은 무엇일까요?
이 모듈은 모듈 2의 API 패턴(에이전트 루프·도구 스키마·컨텍스트 엔지니어링)에 익숙하다는 전제에서 출발하며, 그 내용은 다시 설명하지 않습니다. 권한 모드나 MCP 서버는 오히려 이번 모듈에서 새로 배우는 부분입니다.
Q2이 모듈 전체를 관통하는 하나의 문제를 가장 잘 설명한 것은?
이 모듈은 "동작하던 것을 다른 환경에서도 버티게 만드는" 설정 결정을 중심으로 짜여 있습니다. 권한 모드, 프로젝트 규칙, 스킬 경로, 인증 키, 스테이징 설정이 환경이 바뀔 때 어떻게 문제가 되는지, 그리고 그것을 미리 막는 설정이 무엇인지를 하나씩 다룹니다.
다음 레슨은 작업의 위험도에 맞춰 권한 모드를 고르고, 사람이 개입하는 검토 지점을 어디에 둘지를 다룹니다. → 권한 모드와 사람의 검토 지점
전 코스는 계속 무료입니다. 등록하면 이 코스의 남은 38개 레슨을 끝까지 읽을 수 있습니다.
이미 등록하셨다면 그때 쓰신 이메일을 넣어 주세요.