Hatena
Claude Code 추천 환경 전체 가이드: 하네스, 스킬, MCP의 작동 방식과 실제 예시
AI처음 오른 때 점수 393
일본 작가가 Claude Code를 중심으로 만든 자기 컴퓨터의 AI 시스템을 설명한 글입니다. 모든 요청은 다른 AI, 도구, 외부 서비스로 보내지기 전에 '하네스'라고 부르는 검사와 권한 규칙을 먼저 통과합니다.
무슨 일이 있었나
이 작가는 명령을 내리는 곳을 Claude Code 하나로 정했습니다. 작업이 시작되기 전에 요청은 하네스를 거칩니다. 하네스는 요청이 무엇인지, 그 행동이 허용되는지, 안전한지 확인합니다. 그다음 요청은 다른 AI, 기술 묶음(스킬), 도구 연결 장치(MCP), 외부 서비스 같은 알맞은 도우미에게 전달됩니다. 작은 도우미 AI인 서브에이전트가 일을 하고 결과를 점검하며, 최종 결과는 마지막 층에서 나옵니다.
주요 숫자와 사실
- 2026년 11월 기준 설정: Claude Opus 5.5 모델, 스킬 147개, 서브에이전트 150개, 플러그인 17개
- Claude Code에 접속하는 방법은 4가지: 휴대폰 앱, 터미널, 디스코드, 예약 작업
- 하네스는 5개 부분으로 구성: 판단 AI 'Jev', 훅 11개, settings.json의 권한 규칙, 한 개의 .env 파일에 담긴 API 키, CLAUDE.md 파일
- Jev는 약 0.2~0.35초 만에 답합니다
- 2026년 11월 기준 .env 파일에는 API 키 27개가 들어 있습니다
하네스란 무엇인가
하네스는 모든 요청이 통과해야 하는 검사 묶음입니다. 판단 AI는 글이나 이미지를 읽고 점수나 예/아니오 답을 줍니다. 훅은 특정 일이 생기면 정해진 작업을 자동으로 시작합니다. 권한 규칙은 Claude Code가 무엇을 해도 되는지, 무엇을 하기 전에 확인을 받아야 하는지, 무엇이 금지인지 정합니다. API 키는 외부 도구를 쓰기 위한 비밀번호와 같습니다. 작가는 이 키를 한 파일에 모아 두고, 비밀번호 관리 프로그램인 1Password로 안전하게 보관합니다.
왜 중요한가
많은 사람은 결과가 나쁜 이유를 나쁜 지시 탓으로 봅니다. 이 글은 AI 주변의 시스템도 그만큼 중요하다고 주장합니다. 모든 단계를 검사하는 하네스는 결과의 품질을 더 일정하게 만들 수 있습니다. 또한 위험한 행동이 피해를 일으키기 전에 막을 수 있습니다. 학생이 기억할 핵심은 간단합니다. 좋은 AI 도구는 명확한 규칙, 검사, 요청에서 결과까지 이어지는 분명한 길이 있을 때 가장 잘 작동합니다.
앞으로 지켜볼 점
- 디스코드 봇 'Kuro'는 2026년 11월 5일에 중단되었고, 앞으로 쓰일지는 불분명합니다
- Grok 봇은 사용량 한도가 있어서, 작가는 대부분의 작업을 클라우드 PC의 Claude Code로 옮겼습니다
- 작가는 지식 층을 계속 쌓을 계획입니다. 글에 따르면 더 좋은 지식은 그 위의 모든 층을 개선합니다
용어 풀이
- Claude Code
- Anthropic이 만든 AI 코딩 도구로, 이 글에서는 작가가 명령을 내리는 유일한 곳입니다.
- MCP
- AI가 외부 도구나 서비스에 연결되도록 돕는 연결 장치입니다.
- 1Password
- 비밀번호와 API 키 같은 민감한 정보를 안전하게 보관하는 비밀번호 관리 프로그램입니다.
- Kuro
- 작가가 쓰던 디스코드 봇으로, 2026년 11월 5일에 중단되었습니다.