Claude Code 치트시트
명령어 · 스킬 · 훅 · 에이전트를 한 페이지에.
최근 주요 변경
3VoiceOver·NVDA 같은 스크린 리더로 Claude Code를 쓰기 위한 모드다.
기본은 꺼져 있고 직접 켠다.
켜면 박스 문자·진행 애니메이션·화면 다시 그리기를 전부 끄고, 라벨이 붙은 평문을 줄 단위로 출력한다.
화살표 키로 고르던 메뉴까지 번호 목록으로 바뀌어, 대화·권한 승인·출력 확인을 처음부터 끝까지 스크린 리더만으로 진행할 수 있다. 메시지마다you:·claude:·tool:같은 라벨이 붙어, 스크롤백 검색으로 원하는 턴을 바로 찾는다.
응답 완료·권한 프롬프트·5초 넘게 걸린 툴 종료 때는 터미널 벨이 울린다.활용
- 한 세션만 켜기 →
claude --ax-screen-reader - 지금 쉘에서 시작하는 세션 전부 →
export CLAUDE_AX_SCREEN_READER=1(PowerShell은$env:CLAUDE_AX_SCREEN_READER = "1") - 이 머신의 모든 세션에 적용 (VS Code 통합 터미널 포함) → 사용자 설정 파일
~/.claude/settings.json에:{ "axScreenReader": true } - 설정으로 켜둔 머신에서 이 세션만 끄기 →
CLAUDE_AX_SCREEN_READER=0— 우선순위는 플래그 > 환경변수 > 설정 순 - 권한 프롬프트 같은 메뉴 → 번호 목록으로 출력된다. 번호를 입력하고 Enter로 선택. 예/아니오 질문은
y또는n입력 - 스크린 리더 없이 화면 확대기·모션 축소만 필요할 때 →
CLAUDE_CODE_ACCESSIBILITY=1(터미널 커서를 유지해 확대기가 따라감),prefersReducedMotion설정(애니메이션 축소)
주의
- 모드 자체는 (v2.1.181~) — 그 이전 버전은
--ax-screen-reader를unknown option오류로 거부한다. 릴리스 노트 공식 발표는 v2.1.208. - 모드가 켜지면
tui설정(fullscreen 렌더링)은 무시된다. 단 attach한 백그라운드 세션은 여전히 fullscreen으로 렌더링된다. - 스크린 리더 실행을 자동으로 감지하지 않는다 — 항상 직접 켜야 한다.
- SSH로 쓸 때는 Claude Code가 실제로 도는 원격 머신 쪽에 환경변수나 설정을 넣는다.
claude -p(비대화형) 출력은 이 모드와 무관하다 — 원래부터 평문이다.
- 한 세션만 켜기 →
/config의 Dynamic workflow size 설정으로, Claude가 작성하는 동적 워크플로우 스크립트가 목표로 삼을 에이전트 수를 정한다(v2.1.202~). 값은unrestricted(기본값, 기준 없음) ·small(5개 미만) ·medium(15개 미만) ·large(50개 미만) 네 가지다.
Claude Code가 이 값을 Claude에게 조언으로 전달하므로 강제 상한이 아니고, 규모를 직접 요구하는 프롬프트가 있으면 프롬프트를 따른다.
워크플로우 기능을 끄지 않고도 평소 실행 규모만 줄여 토큰 비용을 낮출 수 있다.활용
- 평소엔 작은 규모로 유지 →
/config에서 Dynamic workflow size를small로 — 스크립트가 에이전트 5개 미만을 목표로 짜인다 - 큰 감사·마이그레이션만 예외로 → 프롬프트에서 규모를 직접 요구 — 설정은 조언이라 프롬프트가 우선한다
- 값별 기준 —
small5개 미만 ·medium15개 미만 ·large50개 미만 ·unrestricted기준 없음(기본값)
주의
- 강제 상한이 아니다 — 런타임 에이전트 캡은 이 설정과 무관하게 따로 적용된다.
- 변경은 다음 프롬프트부터 적용된다.
- 워크플로우 자체를 끄려면 [[disable-workflows]]를 쓴다.
- 평소엔 작은 규모로 유지 →
(v2.1.202~) 워크플로우가 띄운 에이전트가 내보내는 API·도구 이벤트와 span에
workflow.run_id·workflow.nameOTEL 속성이 붙는다.workflow.run_id는wf_접두사가 붙은 런 식별자로, Workflow 도구 결과에 보고되는 값과 같다.
스크립트가 직접 띄운 에이전트만이 아니라 그 에이전트가 다시 띄운 에이전트(스킬 호출 포함)까지 같은 값을 받는다.workflow.name은 스크립트의meta.name이다.
run_id 하나로 이벤트를 필터하면 그 런의 API 요청·도구 결과 전체를 재구성할 수 있다 — 워크플로우 단위 비용·활동 분석의 기초가 된다.활용
- 특정 런의 활동 전체 재구성 → 이벤트를
workflow.run_id = "wf_..."로 필터 — Workflow 도구 결과의 run identifier와 같은 값 - 워크플로우 종류별 비용 집계 →
workflow.name으로 묶기 — 내장 워크플로우는 이름이 그대로 나온다 - 사용자 작성 워크플로우 이름까지 보기 →
OTEL_LOG_TOOL_DETAILS=1— 게이트가 없으면custom으로 치환된다
주의
- 워크플로우 밖에서 만들어진 이벤트에는 두 속성 모두 부재 — 쿼리에서 부재를 허용해야 한다.
- 사용자 작성 이름은 기본이
custom이다 — 내장 스크립트를 수정한 사본도custom취급. - subagent 단위 추적은 [[otel-agent-id]]와 조합하면 위임 트리까지 복원할 수 있다.
- 특정 런의 활동 전체 재구성 → 이벤트를