Claude Code 가이드
MoAI-ADK가 올라타는 플랫폼, Claude Code를 처음부터 이해하는 학습 경로. 기초·컨텍스트와 메모리·확장·에이전트와 자동화 네 그룹으로 세 가지 핵심 가치의 토대를 다집니다.
정보소속 가치: 에이전틱 하네스 · 에이전틱 루프 엔지니어링
터미널에 앉아 자연어로 말을 건네면 코드를 고치고, 명령을 실행하고, 파일을 뒤져 주는 동료 — 그게 Claude Code입니다. 이 섹션은 그 동료가 어떻게 일하는지, 그리고 그 위에 MoAI-ADK가 어떤 층을 더 얹는지를 처음부터 차근차근 펼쳐 놓은 학습 경로입니다.
배경 참조이 문서는 MoAI-ADK가 올라타 있는 플랫폼인 Claude Code 자체를 다루는 배경 자료입니다. MoAI-ADK 자체 기능은 사이드바 위쪽 섹션에서 다룹니다.
Claude Code는 터미널에서 실행되는 코딩 에이전트로, 에이전틱 루프(agentic loop)를 돌며 코드를 읽고 고치고 셸 명령을 실행하며 사용자와 대화합니다. 2026년 8월을 기준으로 Claude Code는 Fable 5·Opus 5·Sonnet 5·Haiku 4.5의 모델 라인업 위에서 동작하고, 서브에이전트(sub-agent)는 기본적으로 백그라운드에서 실행되며 깊이 3까지 중첩해 spawn할 수 있습니다. MoAI-ADK는 이 플랫폼이 제공하는 루프·도구·확장점 위에 올라탄 오케스트레이션 계층입니다.
세 가지 핵심 가치 — 토크노믹스 (Token Economics), 에이전틱 루프 엔지니어링 (Agentic Loop Engineering), 에이전틱 하네스 (Agentic Harness) — 는 모두 이 섹션이 짚어 주는 기본 메커니즘에서 출발합니다. 컨텍스트 윈도우와 프롬프트 캐싱을 모르면 토크노믹스를 설계할 수 없고, 서브에이전트와 /goal을 모르면 에이전틱 루프를 말할 수 없으며, 스킬·훅·MCP를 모르면 하네스를 지을 수 없습니다.
정보한 줄 요약: 이 섹션은 도구이자 플랫폼인 Claude Code 자체를 익히는 단계입니다. MoAI-ADK가 이 바탕 위에서 세 가지 핵심을 어떻게 쌓아 올리는지는 핵심 개념과 심화 학습 섹션에서 이어집니다.
flowchart TD
A[기초
작동 원리와 사용법] --> B[컨텍스트와 메모리
토큰·메모리·캐싱]
B --> C[확장
스킬·훅·MCP·플러그인]
C --> D[에이전트와 자동화
서브에이전트·팀·워크플로우]먼저 기초 그룹에서 Claude Code의 에이전틱 루프가 어떻게 도는지 익히고, 컨텍스트와 메모리 관리로 토큰 경제의 기본기를 다집니다. 이어서 확장 그룹에서 하네스의 재료를 갖추고, 마지막으로 에이전트와 자동화 그룹에서 자율 실행 루프까지 나아갑니다.
| 문서 | 설명 | 이어지는 MoAI 핵심 |
|---|---|---|
| 기초 | Claude Code의 작동 원리와 기본 사용법 | 세 가지 핵심 공통 토대 |
| 컨텍스트와 메모리 | 토큰·컨텍스트·메모리·캐싱·체크포인트 관리 | 토크노믹스 |
| 확장 | 스킬·훅·MCP·플러그인으로 기능 확장 | 에이전틱 하네스 |
| 에이전트와 자동화 | 서브에이전트·팀·워크플로우·자율 실행 | 에이전틱 루프 엔지니어링 |
네 그룹을 차례로 마치면 Claude Code 플랫폼 전반을 이해하게 됩니다. 그다음에는 MoAI-ADK의 핵심 개념 섹션으로 이동해, 이 토대 위에서 SPEC 기반 개발과 토큰 효율 설계가 어떻게 결합되는지 살펴보시기 바랍니다.