처음 만나는 AI와 Claude Code

Gabriel Yang

작성일: 2026년 10월 21일이 서재에서 책을 만든 날
공개판 업데이트: 2026년 10월 25일이 판본을 만든 날

AI와 LLM을 처음 배우는 독자를 위한 짧은 실습서. 생성형 모델의 특징을 이해한 뒤, Claude Code로 독서모임 안내와 여러 장의 준비 카드를 만들며 문제 정의부터 시험·개선까지 경험한다.

AI와 지침·스킬·MCP의 연결 보기

6장 첫째 페이지. AI와 지침·스킬·MCP의 연결 보기

앞 장에서는 작업이 커질 때 공통 기준을 반복하고, 여러 단계를 챙기며, 대화 밖의 자료를 확인하는 일이 불편해질 수 있음을 보았습니다. 이제 그런 상황에서 어떤 도움을 받을 수 있는지 큰 그림으로 살펴볼까요?

이럴 때 살펴볼 이름이 CLAUDE.md, AGENTS.md, 스킬, MCP입니다. 이들은 AI 모델을 새로 만드는 기술이 아닙니다. Claude Code CLI가 작업할 때 참고할 기준과 절차를 주거나, 필요한 외부 도구를 연결하는 방법입니다. 아래 그림은 이 책에서 사용하는 Claude Code CLI를 중심으로, 여러분의 요청이 결과 확인으로 이어지는 흐름을 보여 줍니다.

나의 요청을 Claude Code CLI가 처리해 답변과 파일을 만들고 내가 확인하는 흐름. 지침은 공통 기준, 스킬은 반복 순서, MCP는 외부 자료와 도구 연결을 돕는다.

가운데의 큰 흐름부터 읽어 볼까요?

여러분의 요청 → Claude Code CLI: 목표와 조건, 참고할 자료를 전합니다. Claude Code CLI는 Claude를 사용해 요청을 처리합니다.
Claude Code CLI가 작업: 필요한 지침과 스킬을 참고하고, 파일을 읽거나 바꿀 수 있습니다. 외부 자료가 필요하면 MCP로 연결된 도구를 사용할 수도 있습니다.
답변과 파일 → 여러분의 확인: Claude Code CLI가 답과 작업 결과를 보여 주면, 여러분이 실제 파일과 화면이 조건에 맞는지 확인합니다.

그림 아래쪽의 세 상자는 큰 작업에서 자주 필요한 도움을 보여 줍니다. 지침은 공통 기준을, 스킬은 반복할 순서를 보탭니다. MCP는 대화 밖의 자료나 도구에 연결할 통로입니다. 그림은 CLI를 예로 들지만, 이런 도움은 지원되는 다른 Claude 인터페이스에서도 사용할 수 있습니다.

예를 들어 책상을 정리한다면 지침 파일은 늘 보이는 공통 안내문이고, 스킬은 특정 일을 할 때 펼치는 순서표와 같습니다. MCP는 책상 밖 자료실이나 도구함으로 이어지는 통로에 가깝습니다. Claude Code CLI에서는 이 세 가지를 작업에 필요할 때 활용할 수 있습니다. 모두 써야 하는 것은 아니며, 필요한 것만 고르면 됩니다.

같은 기준을 반복한다면: CLAUDE.md와 AGENTS.md

여러 안내 페이지에서 “처음 오는 사람도 이해할 말로 쓰고, 정해지지 않은 시간과 장소는 ‘추후 안내’로 표시한다”는 기준을 계속 쓴다고 해 봅시다. 이런 프로젝트 공통 지침을 파일에 적어 둘 수 있습니다. CLAUDE.md는 Claude Code가 프로젝트 맥락으로 읽는 지침 파일입니다. AGENTS.md도 여러 코딩 도구에서 프로젝트 지침으로 쓰입니다. Claude Code는 기본 설정에서 해당 위치에 CLAUDE.md가 없을 때 AGENTS.md를 읽으며, 설정에 따라 둘 다 읽을 수도 있습니다. 어떤 도구가 언제 읽는지는 각각 확인해야 합니다. Claude Code의 지침 문서에서 현재 동작을 확인할 수 있습니다.

같은 순서를 반복한다면: 스킬

안내 페이지를 만들 때마다 “정보 확인 → 초안 작성 → 미정 정보 표시 → 실제 화면 점검”을 거친다면 그 절차를 스킬로 정리할 수 있습니다. 스킬은 AI가 관련 작업을 할 때 참고하거나 호출해 쓰는 재사용 가능한 설명과 작업 순서입니다. 지침이 프로젝트 전체에 적용할 기준이라면, 스킬은 특정 일을 진행하는 방법을 알려 줍니다. Claude Code의 스킬 문서가 사용 방식을 설명합니다.

대화 밖의 최신 자료나 도구가 필요하다면: MCP

다음 모임의 실제 일정을 온라인 일정표에서 읽어야 한다고 해 봅시다. AI는 대화에 없는 최신 일정을 저절로 알 수 없습니다. MCP는 Claude Code CLI 같은 인터페이스가 외부 서비스의 자료와 도구에 연결할 수 있게 하는 방식입니다. 연결이 마련되고 접근이 허용되면 일정을 읽어 답변에 반영할 수 있습니다. MCP가 사실을 보증하거나 모든 외부 서비스를 자동으로 연결하는 것은 아닙니다. 어떤 자료에 접근하는지 확인하고, 반영된 안내도 사람이 점검해야 합니다. Claude Code의 MCP 문서를 참고할 수 있습니다.

다음 책에서는

프로젝트 지침으로 공통 기준을 남기고, 스킬로 반복 절차를 정리하며, MCP로 필요한 자료나 도구를 연결하는 법을 차례로 살펴봅니다. 더 많은 기능을 묶어 공유할 때 쓰는 플러그인이나 일을 나누는 에이전트도 그다음에 만날 수 있습니다. 지금은 이름을 외우기보다 반복할 기준, 반복할 절차, 외부 연결이 각각 다른 어려움을 해결한다는 큰 그림을 기억하세요.