🗺️도구

Claude Code 하네스 설정을 한눈에 보는 harness-map

Claude Code의 지시 파일, 도구, 권한 등 모든 설정을 폴더별·실행 방식별로 시각화해주는 분석 도구

#Claude Code#설정 관리#시각화#개발 도구

개요

harness-map은 Claude Code의 '하네스(harness)' 설정을 한 장의 조립도로 보여주는 도구입니다. 하네스란 모델을 둘러싼 모든 설정(CLAUDE.md, 자동 기억, MCP 도구, 권한, 훅 등)을 의미하며, 같은 설정이라도 시작 폴더나 에이전트 실행 방식에 따라 실제 동작이 달라질 수 있습니다.

주요 기능

▸

폴더별 설정 비교: 여러 작업 폴더의 하네스 설정을 한번에 확인

▸

실행 방식별 차이 분석: 메인, 포크, 서브에이전트 등 실행 방식에 따른 설정 차이 파악

▸

안전한 읽기 전용: 파일을 읽기만 하고 어떤 설정도 변경하지 않음

▸

민감 정보 보호: 환경변수 값, 토큰 등 민감한 정보는 결과에 포함하지 않음

사용 방법

에이전트에게 맡기기

Claude Code에 다음 프롬프트를 입력하면 자동으로 실행됩니다:

https://github.com/Dominic-DK/harness-map 의 README 를 읽고 "직접 실행" 순서대로 실행해 줘.
내가 자주 작업을 시작하는 폴더는 ~/work/a 와 ~/work/b 야.
3단계의 에이전트 점검은 안내에 적힌 안전 규칙을 지켜서 직접 수행하고 기록해 줘.
끝나면 만들어진 harness-map.html 을 브라우저로 열고, 결과를 쉬운 문어체로 다섯 문장 안팎으로 요약해 줘.

직접 실행하기

bash

# 저장소 클론
git clone https://github.com/Dominic-DK/harness-map.git
cd harness-map

# 1. 하네스 설정 수집
python3 harness-map.py --cwd ~/work/a --cwd ~/work/b -o harness.json

# 2. 점검 계획 확인
python3 harness-map.py --probe-plan

# 3. 점검 수행 (선택사항)
# 에이전트가 직접 수행하며 probes.json에 결과 저장

# 4. 점검 결과 통합
python3 harness-map.py --cwd ~/work/a --cwd ~/work/b --probes probes.json -o harness.json

# 5. HTML 생성 및 열기
python3 build.py harness.json
open harness-map.html

주의사항

▸

일반 사용자 권한으로 실행: sudo 사용 금지 (홈 폴더가 변경되어 다른 사용자 설정을 읽을 수 있음)

▸

각 폴더를 개별 지정: 상위 폴더에서 한 번 실행해도 하위 프로젝트 설정은 확인 불가

▸

결과 파일 공유 전 확인: harness.json에 폴더 이름과 플러그인 목록이 포함되므로 공유 전 검토 필요

수집되는 정보

포함되는 정보:

▸CLAUDE.md 경로, 줄 수, 읽히는 시점

▸권한 모드, 규칙 개수, 환경변수 이름

▸훅 이벤트, MCP 서버 이름

제외되는 정보:

▸파일 본문, 환경변수 값

▸토큰, 명령 인자

▸홈 폴더 실제 경로

활용 시나리오

▸여러 프로젝트의 Claude Code 설정을 한눈에 비교

▸새 프로젝트 설정 시 기존 설정 참고

▸에이전트가 다르게 동작하는 이유 파악

▸팀원과 설정 구조 공유