클로드 코드(Claude Code) 사용법: CLAUDE.md와 MCP·플러그인으로 10배 강화하기

핵심 메시지

• 클로드 코드는 터미널이나 커서·VS코드 같은 에디터 확장에서 쓰면 생성되는 파일과 디렉터리 구조를 눈으로 확인할 수 있어 경험이 좋아진다.
• 프로젝트 루트에 CLAUDE.md를 만들어 기술 스택·개발 명령·코드 규칙 등 장기 기억을 적어두면 새 세션마다 일관된 맥락을 유지한다.
• 플레이라이트(브라우저 자동화), 슈퍼파워(브레인스토밍·서브에이전트), 컨텍스트7(최신 문서) 세 가지 플러그인이 기본으로 권장된다.
• 깃허브 MCP 서버를 개인 액세스 토큰으로 연결하면 클로드가 원격 저장소 생성과 코드 푸시를 대신 처리한다.
• /model로 모델 전환, /compact로 컨텍스트 압축, /insights로 사용 패턴 분석 리포트를 생성할 수 있다.

쉽게 이해하기

테크 위드 팀이 클로드 코드(Claude Code)를 '몇 분 만에 10배' 더 잘 쓰는 간단한 설정들을 정리했다. 첫걸음은 사용 환경이다. 터미널에서 쓰든, 커서·VS코드·윈드서프 같은 에디터의 확장으로 쓰든, 클로드가 실제로 만드는 파일과 디렉터리 구조를 볼 수 있게 하는 것이 핵심이다. 무엇이 생성되는지 이해하면 결과 통제가 훨씬 쉬워진다.

다음은 프로젝트 루트에 두는 CLAUDE.md 파일이다. 클로드 코드는 기본적으로 세션 간 기억이 없어, 새 세션을 열면 이전 작업이나 사용자가 정한 규칙을 알지 못한다. CLAUDE.md에 기술 스택, 개발 명령, 프로젝트 구조, 코드 컨벤션, API 참고 등을 적어두면 새 세션마다 이를 참조한다. 작업하면서 중요한 내용을 계속 이 파일에 갱신하도록 시키면 시간이 갈수록 맥락이 풍부해진다.

플러그인과 커넥터는 클로드의 힘을 키운다. 영상은 세 가지를 기본 권장한다. 플레이라이트(Playwright)는 브라우저 자동화로 웹앱 로그인·클릭 같은 흐름을 재사용 가능한 스크립트로 자동화하고 테스트한다. 슈퍼파워(Superpowers)는 브레인스토밍, 서브에이전트 기반 개발, 체계적 디버깅 같은 스킬과 코드 리뷰 에이전트, 세션 시작 훅을 더해준다. 컨텍스트7(Context7)은 최신 문서를 가져와 폐기된 코드나 환각을 줄인다. 플러그인은 프로젝트 단위 또는 전역으로 설치할 수 있어, 필요할 때만 도구를 붙여 비대해지지 않게 할 수 있다.

깃허브 MCP 서버 연결도 다룬다. 기본 제공 플러그인이 동작하지 않는 경우를 대비해 수동 설치법을 안내하는데, 깃허브 설정의 개발자 메뉴에서 클래식 개인 액세스 토큰을 repo 범위로 발급해 명령에 끼워 넣는다. 전역으로 쓰려면 --scope user 플래그를 붙인다. 연결되면 클로드에게 '원격 저장소를 만들고 현재 코드를 푸시해'라고 시키는 식으로 버전 관리를 위임할 수 있다. 비슷하게 DBHub MCP를 붙이면 클로드가 포스트그레스 데이터베이스에 직접 쿼리하고 테이블을 살펴 더 나은 코드를 쓴다.

마지막으로 알아두면 좋은 명령들이다. /model은 소네트·오푸스·오푸스 100만 컨텍스트·하이쿠 중에서 작업에 맞게 모델을 바꾼다. 대부분은 소네트, 복잡하면 오푸스, 빠른 작업엔 하이쿠가 권장된다. /compact는 길어진 컨텍스트를 요약해 새 세션 없이 대화를 이어가게 하며 한도 근처에서 자동 실행된다. /insights는 사용 횟수·세션·잘하는 점·개선점을 담은 사용 분석 리포트를 웹 페이지로 만들어준다. 영상은 이런 설정이 초보자도 쉽게 더할 수 있는 '적은 노력 대비 큰 효과'라고 강조한다.

주요 인사이트

• 클로드 코드의 약점인 '기억 없음'은 CLAUDE.md 한 파일로 상당 부분 보완된다. 규칙과 맥락을 문서로 남겨 팀과 공유하는 것이 핵심이다.
• 플러그인은 무조건 많이 까는 것이 아니라 프로젝트·전역 범위를 구분해 필요한 곳에만 붙여 도구 과부하를 피하는 것이 좋다.
• MCP 서버는 클로드를 코드 작성기에서 깃허브·데이터베이스까지 다루는 실행 주체로 확장한다. 권한 범위(scope) 설정이 중요하다.
• AI로 개발해도 빅테크 취업의 코딩 면접은 여전히 AI 없이 자료구조·알고리즘 문제를 직접 푸는 별개의 역량을 요구한다.
• /insights 같은 메타 분석 기능은 도구 사용 습관을 객관적으로 돌아보게 해 더 효율적인 활용으로 이어진다.

자주 묻는 질문

관련 AI 소식