▲

Claude Code 창시자의 커스터마이징 팁 12가지

 (x.com/bcherny)
20P by neo 5시간전 | ★ favorite | 댓글과 토론
  • 엔지니어마다 도구 사용 방식이 다르다는 점에 착안해, 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