클로드 코드 입문 강좌 총정리 — 네 가지 권한 모드·스킬·컨텍스트 관리·MCP 연결과 배포까지

핵심 메시지

• 강사는 데스크톱 앱보다 VS 코드 터미널에서 쓰기를 권한다. 커스터마이즈 여지가 넓고 바뀐 파일을 눈으로 확인하기 쉽기 때문이다.
• 권한 모드는 계획·편집 승인·자동·우회 네 단계로 나뉘며, 자동 모드는 실행할 스크립트를 별도로 한 번 걸러준다.
• 스킬은 반복 작업을 정리한 표준 작업 절차에 가깝고, 마크다운 문서 하나로 에이전트의 실행 순서를 지정한다.
• 컨텍스트 사용률이 절반을 넘어가면 새 세션을 시작하거나 대화를 압축해 성능 저하를 피하라고 권한다.
• MCP는 보안과 접근 통제에, CLI는 토큰 효율에 유리하다는 것이 도구 연결 방식을 고르는 기준으로 제시된다.

쉽게 이해하기

freeCodeCamp가 아마존과 마이크로소프트에서 일했던 개발자 에릭이 진행하는 클로드 코드 입문 강좌를 공개했다. 개발 경력이 없어도 따라올 수 있도록 설치부터 배포까지를 한 편에 담았고, 노트북과 구독 계정 외에는 사전 준비가 필요 없다고 밝힌다. 강좌는 설치, 기본 사용, 파일 구조, 컨텍스트, 슬래시 명령, 버전 관리, 외부 도구 연결, 자주 묻는 질문 순으로 이어진다. 도입부의 선택지는 어디에서 쓸 것인가인데, 데스크톱 앱은 바로 쓸 수 있지만 설정 폭이 좁고 터미널만 쓰면 화면이 불친절하다는 것이 강사의 진단이다. 그는 절충안으로 VS 코드를 권한다. 편집기 안의 터미널에서 세션을 열면 바뀐 파일을 왼쪽 탐색기에서 바로 확인할 수 있고, 세션을 닫았다가도 resume 명령으로 직전 대화를 되살릴 수 있기 때문이다.

가장 실질적인 부분은 권한 모드 설명이다. 계획 모드는 파일을 고치지 않고 무엇을 할지부터 정리해 사용자의 승인을 받는 단계로, 대규모 리팩터링이나 새 프로젝트 설계에 어울린다. 편집 승인 모드는 파일 수정은 하되 명령 실행에는 확인을 요구하고, 자동 모드는 스크립트 실행까지 맡기되 위험해 보이는 명령은 별도 판정을 거쳐 사용자에게 알린다. 우회 모드는 그 검사마저 건너뛰므로, 강사는 민감한 정보가 없는 테스트 환경에서만 쓰라고 못 박는다.

강좌는 화면을 캡처한 이미지와 참고 링크를 주고 티어 목록 웹앱을 복제하는 과제로 기능을 엮는다. 계획 모드에서 기술 스택과 완성도 기준 같은 질문에 답해 요구사항을 확정하고, 아이콘 이미지를 먼저 내려받게 계획을 수정한 뒤 실행에 들어가는 흐름이다. 여기서 쓰인 goal 명령은 결과를 곧바로 내놓는 대신 초기 요구사항에 맞는지 평가하고 어긋나면 다시 고치는 루프를 돌린다.

스킬은 이 강좌가 가장 공들여 설명하는 개념이다. 강사는 자신이 쓰는 버그 처리 스킬을 예로 들어, 티켓을 읽고 브라우저 자동화로 재현한 뒤 원인 조사와 수정, 검토, 배포, 티켓 이동까지 아홉 단계를 하나의 문서로 묶었다고 소개한다. 앤트로픽이 공개한 프런트엔드 디자인 스킬을 플러그인 목록에서 설치해 앞서 만든 앱의 화면을 다시 손보는 과정도 보여주는데, 설치 범위를 개인 전역으로 할지 프로젝트 단위로 할지 고르는 부분이 함께 나온다. 이어지는 폴더 구조 설명에서는 에이전트 공통 설정과 특정 도구 전용 설정을 가르는 기준이 등장한다. 여러 도구가 함께 읽는 문서는 공용 폴더에 두고 클로드 코드 전용 설정 파일은 전용 폴더에 남기는 식인데, 강사의 화면에서는 전용 폴더의 스킬이 공용 폴더의 원본을 가리키는 참조로 잡혀 있었다. 시스템 프롬프트도 같은 원칙으로 공용 문서와 전용 문서를 나눠 쓴다.

후반부는 운영에 가까운 주제들이다. 컨텍스트 명령으로 시스템 프롬프트와 스킬, 대화가 각각 얼마를 쓰는지 확인하고, 사용률이 올라갈수록 정확도가 떨어지는 현상을 근거로 절반 지점을 기준선으로 삼으라고 조언한다. 이어 깃허브로 변경 이력을 남기는 방법, 커밋 아이디를 알려주고 특정 시점으로 되돌리는 방법, 그리고 MCP나 CLI로 외부 서비스를 연결해 만든 앱을 배포하고 다시 지우는 과정까지 실제 화면으로 이어진다.

주요 인사이트

• 권한 모드를 계정 설정이 아니라 작업 단계에 맞춰 바꾸는 습관이 핵심이다. 설계는 계획 모드, 구현은 편집 승인, 반복 실행은 자동 모드처럼 나누면 확인 요청과 사고 위험을 동시에 줄일 수 있다.
• goal 명령의 핵심은 자동화가 아니라 판정 기준이다. 강사가 '픽셀 단위로 맞추고 차이를 2% 이내로'처럼 확인 가능한 조건을 먼저 고른 뒤 루프를 돌린 점이 결과를 갈랐다.
• 컨텍스트를 압축하면 사용률은 떨어지지만 대화 내용이 요약되면서 정보가 빠질 수 있다. 강사가 임계값을 미리 정해두라고 말하는 이유는, 한계에 부딪힌 뒤 압축하면 잃는 것이 더 많기 때문이다.
• MCP와 CLI 중 무엇을 쓸지는 취향이 아니라 요건의 문제다. 팀 단위 권한 통제와 감사 기록이 필요하면 MCP가, 토큰을 아껴야 하면 CLI가 낫다는 것이 강사의 정리다.
• 강사는 프레임워크와 모델을 구분해서 보라고 말한다. 도구를 비교할 때 어떤 모델을 쓰느냐와 어떤 실행 환경을 쓰느냐는 별개의 선택이며, 실행 환경은 기능과 플러그인 생태계로 판단해야 한다는 것이다.

자주 묻는 질문

관련 AI 소식