← 블로그

오마이 클로드 코드: 터미널 명령어·단축키·설정 완전 정복

2026년 10월 22일

Claude Code 터미널 슬래시 명령어 20개, 키보드 단축키, settings.json 디자인 설정을 한 곳에 정리한 실전 치트시트입니다.

오마이 클로드 코드 — 터미널에서 이렇게까지 된다고?

클로드 코드 터미널에서는 /clear, /model, /status 등 슬래시 명령어 20여 개로 모델 전환·컨텍스트 초기화·토큰 확인을 즉시 실행할 수 있다. 클로드 코드 디자인은 settings.json 한 파일에서 테마·폰트 크기·레이아웃을 바꾸고 팀 전체에 공유할 수 있다. 설치 직후 이 두 가지를 모르면 Claude Code의 자동화·코드 리뷰·멀티 에이전트 기능 대부분을 그냥 지나치게 된다.

Claude Code는 CLI 터미널 외에도 Mac·Windows 데스크탑 앱, VS Code·JetBrains IDE 확장, 그리고 claude.ai/code 웹 앱으로도 사용할 수 있다. 어떤 환경에서 접근하든 슬래시 명령어와 settings.json 설정 방식은 동일하게 적용된다. 이 글은 설치 첫날부터 북마크해 두고 꺼내 쓸 수 있는 실전 치트시트다.

클로드 코드 터미널 핵심 슬래시 명령어, 무엇이 있나?

터미널에서 /를 입력하면 사용 가능한 명령어 목록이 자동 완성됩니다. 기능별로 분류해 정리합니다.

컨텍스트·세션 관리

  • /clear — 현재 대화 컨텍스트를 초기화합니다. 새 작업을 시작하거나 토큰 누적이 많아졌을 때 가장 먼저 실행합니다. 이전 대화 내용은 사라지므로 중요한 결과는 미리 파일에 저장해 두는 것이 좋습니다.
  • /status — 현재 사용 중인 모델, 남은 컨텍스트 토큰, 세션 토큰 사용 현황을 한눈에 확인합니다. 대규모 코드베이스 작업 중에 주기적으로 확인하는 습관이 도움이 됩니다.
  • /init — 프로젝트 루트에 CLAUDE.md 파일을 생성하고 프로젝트 맥락을 초기화합니다. 신규 프로젝트에서 처음 한 번 실행하면 이후 모든 세션에서 이 파일의 컨텍스트를 자동으로 불러옵니다.

모델 전환

  • /model — 대화 중에 사용할 모델을 즉시 전환합니다. 빠른 단순 작업에는 claude-haiku-4-5, 복잡한 코딩·추론에는 claude-opus-4-8으로 바꾸는 식으로 토큰 비용과 품질을 유연하게 조절합니다.
  • /fast — Fast 모드를 켜고 끕니다. Opus 모델에서 더 빠른 출력을 원할 때 토글합니다. /fast로 활성화 상태를 언제든 확인하거나 전환할 수 있습니다.

코드 품질·자동화

  • /code-review — 현재 브랜치의 변경사항을 리뷰합니다. /code-review ultra를 붙이면 멀티 에이전트 클라우드 리뷰가 실행되어 더 심층적인 피드백을 제공합니다. PR 번호를 지정해 특정 PR을 리뷰할 수도 있습니다.
  • /loop — 반복 자율 작업 루프를 시작합니다. 인터벌 없이 사용하면 Claude가 스스로 페이스를 조절합니다. 긴 마이그레이션이나 대규모 리팩터링에 유용합니다.

설정·도움말

  • /config — 현재 적용된 설정을 확인하거나 즉시 수정합니다. 전역 설정과 프로젝트 설정 중 어느 쪽이 우선 적용 중인지 파악할 때도 씁니다.
  • /help — 사용 가능한 전체 명령어 목록과 사용법을 터미널에 출력합니다. 처음 설치했을 때 한 번 훑어 두면 전체 기능 구조를 파악하기 좋습니다.

팁: 명령어를 입력한 뒤 Tab을 누르면 하위 옵션이 자동 완성됩니다. 예를 들어 /model을 치고 Tab을 누르면 현재 사용 가능한 모델 ID 목록이 바로 뜹니다.

키보드 단축키만으로 Claude Code를 쓰려면 무엇을 알아야 하나?

마우스 없이도 Claude Code 작업을 끊김 없이 이어갈 수 있습니다. 터미널과 데스크탑 앱 공통으로 사용하는 핵심 단축키를 정리합니다.

입력·편집

  • Enter — 메시지 전송
  • Shift+Enter — 줄바꿈. 전송 없이 여러 줄을 입력할 때 씁니다. 긴 코드 조각이나 단계별 지시를 한 번에 붙여 넣을 때 유용합니다.
  • ↑ / ↓ — 이전·다음 입력 히스토리 탐색. 자주 쓰는 명령어나 프롬프트를 재사용할 때 편리합니다.
  • Ctrl+C — 현재 실행 중인 작업을 즉시 중단합니다.
  • Ctrl+L — 터미널 화면만 지웁니다. 컨텍스트는 그대로 유지되므로 /clear와 다릅니다.

응답 처리

  • Esc — 스트리밍 중인 응답을 즉시 중지합니다. 잘못된 방향으로 가고 있다고 판단되면 기다리지 않고 바로 중단하고 프롬프트를 수정할 수 있습니다.

IDE 확장 (VS Code · JetBrains)

  • Ctrl+Shift+P (Mac: Cmd+Shift+P) → Claude: Open Panel — Claude 사이드 패널을 엽니다.
  • 에디터에서 코드를 선택한 뒤 우클릭 → Ask Claude — 선택한 코드에 대해 직접 질의합니다. 함수 설명 요청이나 버그 분석에 바로 활용합니다.

단축키가 기억나지 않을 때는 터미널에서 /help를 입력하거나, 데스크탑 앱에서 메뉴 → Keyboard Shortcuts를 확인하면 됩니다.

클로드 코드 디자인 설정: 테마·폰트·레이아웃을 어떻게 바꾸나?

Claude Code의 UI 환경설정은 settings.json 파일 하나에서 관리합니다. 설정 파일의 위치는 사용 환경에 따라 다릅니다.

  • macOS / Linux: ~/.claude/settings.json
  • Windows: %APPDATA%\Claude\settings.json
  • 프로젝트별 적용: 프로젝트 루트의 .claude/settings.json

주요 설정 키 예시

{
  "theme": "dark",
  "fontSize": 14,
  "preferredModel": "claude-opus-4-8",
  "autoApprove": false,
  "verbose": false
}
  • theme: "dark" | "light" | "system" — 터미널 및 데스크탑 앱 테마를 지정합니다. "system"은 OS 다크 모드 설정을 따릅니다.
  • fontSize: 데스크탑 앱의 폰트 크기를 픽셀 단위로 설정합니다. 기본값은 13이며 14–16 범위가 가독성이 좋습니다.
  • preferredModel: 세션을 시작할 때 기본으로 로드할 모델 ID를 지정합니다. claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5 중 하나를 씁니다. 세션 중에는 언제든 /model로 덮어쓸 수 있습니다.
  • autoApprove: true로 설정하면 파일 수정·터미널 명령 실행 시 확인 없이 자동 진행합니다. 로컬 개발 환경에서 속도를 높일 때 쓰지만, 프로덕션 환경이나 민감한 저장소에서는 반드시 false로 유지합니다.
  • verbose: true로 설정하면 내부 처리 과정의 상세 로그를 출력합니다. 문제 디버깅 시에만 임시로 켜고, 평소에는 false를 권장합니다.

변경 사항은 파일 저장 즉시 반영됩니다. Claude Code를 재시작할 필요가 없습니다.

설정 파일을 팀 전체에 공유하는 방법은?

프로젝트 루트에 .claude/settings.json을 두고 Git으로 커밋하면 팀 전체가 동일한 Claude Code 환경으로 작업합니다. 개인 API 키나 개인 테마 같은 사용자별 설정은 전역 ~/.claude/settings.json에만 두고, 프로젝트 파일에는 팀 공통 값만 남깁니다.

mkdir -p .claude
cat > .claude/settings.json << 'EOF'
{
  "preferredModel": "claude-sonnet-4-6",
  "autoApprove": false,
  "verbose": false
}
EOF
git add .claude/settings.json
git commit -m "Add Claude Code team settings"

우선순위는 프로젝트 설정 > 전역 설정 순입니다. 같은 키가 두 파일에 존재하면 프로젝트 파일 값이 전역 값을 덮어씁니다. API 키, 인증 토큰, 개인 경로 등 민감 정보는 절대 프로젝트 파일에 포함하지 않습니다. 실수로 커밋해도 .gitignore가 잡아 주지 않으며, 코드 리뷰 때도 놓치기 쉽습니다.

CLAUDE.md 파일도 함께 커밋하면 효과가 배가됩니다. 프로젝트 구조, 코딩 컨벤션, 자주 쓰는 명령어, 빌드 방법 등 팀 공통 지식을 이 파일에 적어 두면 Claude Code가 매 세션마다 해당 맥락을 자동으로 불러옵니다. 새 팀원의 온보딩 시간도 줄어듭니다.

자주 막히는 터미널 오류, 어떻게 해결하나?

claude: command not found

PATH 설정 문제가 대부분입니다. npm install -g @anthropic-ai/claude-code로 설치했다면 ~/.npm-global/bin이 $PATH에 포함되어 있는지 확인합니다. which claude로 설치 경로를 먼저 확인하고, 경로가 나오지 않으면 쉘 프로필(~/.zshrc 또는 ~/.bashrc)에 해당 경로를 추가한 뒤 터미널을 재시작합니다.

컨텍스트 초과 오류

긴 대화 중 context window exceeded 오류가 발생하면 /clear로 컨텍스트를 초기화합니다. 이때 이전 대화 내용은 사라지므로 중요한 코드나 답변은 반드시 먼저 파일에 저장합니다. 대규모 코드베이스를 다룰 때는 /status로 토큰 사용량을 주기적으로 확인해 한계에 도달하기 전에 /clear를 실행하는 습관이 효과적입니다.

모델 전환이 반영되지 않을 때

/model로 전환했는데도 이전 모델이 계속 사용된다면 settings.json의 preferredModel 값이 강제 고정되어 있을 수 있습니다. /config를 실행해 현재 적용 중인 설정 파일과 값을 확인하고, 충돌하는 키를 원하는 값으로 수정합니다.

설정이 저장 후에도 반영되지 않을 때

전역 설정과 프로젝트 설정이 동시에 존재할 때 어느 쪽이 적용되는지 혼동되는 경우입니다. /config에서 어느 파일이 우선 적용 중인지 확인합니다. 프로젝트 .claude/settings.json에 해당 키를 명시적으로 지정하면 전역 설정과 무관하게 원하는 값이 적용됩니다.

슬래시 명령어와 settings.json 설정을 익히면 Claude Code로 할 수 있는 작업의 범위가 크게 넓어집니다. 이런 실전 지식은 CCA-F(Claude Certified Associate – Foundations) 시험 준비의 탄탄한 기반이 됩니다. 더 체계적으로 준비하고 싶다면 Plinth Prep을 방문해 보세요. Plinth Prep은 Anthropic과 제휴·후원·인증 관계가 없는 독립 학습 사이트입니다. plinthprep.com에서 CCA-F 학습 자료를 확인하세요.

자주 묻는 질문

클로드 코드 터미널에서 가장 많이 쓰는 슬래시 명령어는 무엇인가요?
/clear(컨텍스트 초기화), /status(토큰·모델 현황 확인), /model(모델 즉시 전환), /code-review(브랜치 변경사항 리뷰), /init(CLAUDE.md 생성) 이 다섯 가지가 가장 자주 씁니다. /clear는 새 작업을 시작할 때마다 습관적으로 실행하면 불필요한 토큰 소모를 줄일 수 있습니다.
클로드 코드 settings.json 파일은 어디에 있나요?
macOS와 Linux는 ~/.claude/settings.json, Windows는 %APPDATA%\Claude\settings.json에 있습니다. 프로젝트별 설정은 프로젝트 루트의 .claude/settings.json에 둡니다. 프로젝트 파일이 전역 파일보다 우선 적용되며, theme·fontSize·preferredModel·autoApprove 등을 JSON 형식으로 설정합니다.
클로드 코드 디자인(테마·폰트)을 바꾸려면 무엇을 수정해야 하나요?
settings.json 파일의 theme 키를 "dark", "light", "system" 중 하나로 지정하고, fontSize에 픽셀 숫자를 입력합니다. 데스크탑 앱 기준이며 변경 사항은 저장 즉시 반영됩니다. preferredModel에 원하는 모델 ID를 적으면 세션 시작마다 해당 모델이 기본으로 로드됩니다.
클로드 코드 터미널에서 컨텍스트 초과 오류가 나면 어떻게 해결하나요?
/clear 명령어로 컨텍스트를 초기화합니다. 이전 대화 내용은 사라지므로 중요한 코드나 결과는 먼저 파일에 저장해야 합니다. 큰 코드베이스를 다룰 때는 /status로 토큰 사용량을 주기적으로 확인하면 한계에 도달하기 전에 미리 대처할 수 있습니다. 오류가 반복된다면 /init으로 CLAUDE.md를 생성해 프로젝트 맥락을 파일로 분리하는 방법도 컨텍스트 누적 속도를 줄이는 데 효과적입니다.

이 글 공유하기

Plinth Prep는 독립적인 학습 자료이며 Anthropic과 제휴, 보증, 후원 관계가 없습니다. 연습 문제는 Plinth Prep가 직접 제작한 것이며 실제 시험 문제를 옮긴 것이 아닙니다.