Claude Code 창시자 Boris Cherny의 Claude Code 커스터마이징 팁 12가지
- 엔지니어마다 도구 사용 방식이 다르다는 점에 착안해, Claude Code는 처음부터 뛰어난 기본값과 높은 커스터마이징 자유도를 동시에 갖추도록 설계됨
- 터미널 테마, 알림, Vim 모드부터 에이전트, 플러그인, MCP, 스킬까지 거의 모든 동작을 사용자가 조정 가능
- 37개 설정 항목과 84개 환경 변수를 지원하며, settings.json을 Git에 기록하면 팀 전체에 설정 공유 가능
- 개인 취향에 맞는 스피너 동사, 상태 표시줄, 출력 스타일까지 세밀하게 조정할 수 있어 개발자 경험(DX) 극대화
터미널 설정
/config명령으로 라이트/다크 모드 테마 전환 가능- iTerm2 알림 활성화 또는 커스텀 알림 훅 사용 가능
- IDE 터미널, Apple Terminal, Warp, Alacritty 사용 시
/terminal-setup을 실행하면 shift+enter로 줄바꿈 가능 (백슬래시 입력 불필요) /vim명령으로 Vim 모드 활성화- Optimize your terminal setup
Effort 레벨 조정
/model명령으로 에포트 레벨 선택 가능- Low: 토큰 사용량 적고 응답 속도 빠름
- Medium: 균형 잡힌 동작
- High: 토큰 사용량 많지만 더 높은 지능 수준
- Boris는 모든 작업에 High를 사용
플러그인, MCP, 스킬 설치
- 플러그인을 통해 LSP(모든 주요 언어 지원), MCP, 스킬, 에이전트, 커스텀 훅 설치 가능
- Anthropic 공식 플러그인 마켓플레이스에서 설치하거나, 회사 전용 마켓플레이스를 직접 생성 가능
- settings.json을 코드베이스에 체크인하면 팀에 마켓플레이스 자동 추가
/plugin명령으로 시작- Discover and install prebuilt plugins through marketplaces
커스텀 에이전트 생성
.claude/agents디렉터리에 .md 파일을 추가하면 커스텀 에이전트 생성 가능- 각 에이전트에 이름, 색상, 도구 세트, 사전 허용/차단 도구, 권한 모드, 모델을 개별 지정 가능
- settings.json의 "agent" 필드 또는
--agent플래그로 기본 에이전트 설정 가능 (잘 알려지지 않은 기능) /agents명령으로 시작- Create custom subagents
권한 사전 승인
- Claude Code는 프롬프트 인젝션 탐지, 정적 분석, 샌드박싱, 휴먼 오버사이트를 결합한 권한 시스템 사용
- 기본적으로 소수의 안전한 명령만 사전 승인되어 있으며,
/permissions로 허용/차단 목록 추가 가능 - 와일드카드 문법 지원 — 예:
Bash(bun run *),Edit(/docs/**) - 팀의 settings.json에 체크인하여 공유 가능
- Configure permissions
샌드박싱 활성화
- Claude Code의 오픈소스 샌드박스 런타임을 활용해 안전성 향상과 권한 프롬프트 감소를 동시에 달성
/sandbox명령으로 활성화하며, 로컬 머신에서 실행- 파일 격리와 네트워크 격리 모두 지원
- Windows 지원은 곧 예정
- Sandboxing
상태 표시줄 추가
- 커스텀 상태 표시줄은 컴포저 바로 아래에 표시
- 모델명, 디렉터리, 남은 컨텍스트, 비용 등 원하는 정보를 자유롭게 구성 가능
- Claude Code 팀 구성원마다 각기 다른 상태 표시줄을 사용 중
/statusline명령 실행 시.bashrc/.zshrc기반으로 Claude가 상태 표시줄 자동 생성- Customize your status line
키바인딩 커스터마이징
- Claude Code의 모든 키 바인딩을
/keybindings로 재매핑 가능 - 설정이 실시간 리로드되어 즉시 확인 가능
훅 설정
- 훅은 Claude의 라이프사이클에 결정론적으로 개입하는 방식
- 활용 예시:
- 권한 요청을 Slack이나 Opus로 자동 라우팅
- 턴 종료 시 Claude가 계속 진행하도록 넛지 (에이전트 실행이나 프롬프트 기반 판단 가능)
- 도구 호출의 전처리/후처리 — 예: 커스텀 로깅 추가
- Hooks reference
스피너 동사 커스터마이징
- 기본 스피너 동사 목록에 자신만의 동사를 추가하거나 교체 가능
- settings.json을 소스 컨트롤에 체크인하면 팀과 공유 가능
출력 스타일 설정
/config에서 출력 스타일을 설정하면 Claude의 응답 톤과 포맷 변경 가능- "explanatory" 스타일: 새 코드베이스 파악 시 프레임워크와 코드 패턴을 설명하며 작업
- "learning" 스타일: 코드 변경 과정을 코칭 형태로 안내
- 직접 커스텀 출력 스타일 생성도 가능
- Output styles
전체 커스터마이징 하기
- Claude Code는 기본 상태에서도 잘 작동하도록 설계되어 있으나, 커스터마이징 시 settings.json을 Git에 체크인하여 팀 공유 권장
- 코드베이스 단위, 서브폴더 단위, 개인 단위, 엔터프라이즈 전체 정책 단위로 설정 가능
- 총 37개 설정 항목과 84개 환경 변수 지원
- settings.json의 "env" 필드를 활용하면 래퍼 스크립트 없이 환경 변수 설정 가능
- Claude Code settings
원문
출처 / GeekNews
알려드립니다
이 글은 국내외 IT 소식들을 공유하는 GeekNews의 운영자이신 xguru님께 허락을 받아 GeekNews에 게제된 AI 관련된 소식을 공유한 것입니다.
출처의 GeekNews 링크를 방문하시면 이 글과 관련한 추가적인 의견들을 보시거나 공유하실 수 있습니다! 
아래
쪽에 좋아요
를 눌러주시면 새로운 소식을 정리하고 공유하는데 힘이 됩니다~ 