터미널에서 AI와 코딩하기: Claude Code CLI 필수 명령어 20선

 

 

요즘 AI 코딩 어시스턴트들 많이 사용하시죠?

개발자들은 좀 더 심도 깊은 개발이나 혼자서 하기 어려웠던 일들을 혼자서도 할 수 있게 되었고,

비개발자들은 그동안 꿈에만 그리던 앱 개발을 말로만으로 쉽게 만들 수 있게 되었습니다.

실제로 디자이너인 지인은 며칠 만에 앱을 후딱 만들어내더라고요.

이제는 아이디어만 있으면 누구나 앱을 만들 수 있는 시대가 온 것 같습니다.

 

제가 요즘 가장 많이 사용하는 AI 코딩 어시스턴트는 Claude Code CLI입니다.

Claude Code CLI는 개발자들의 코딩 워크플로우를 혁신적으로 바꾸고 있는 도구예요.

터미널에서 직접 AI 코딩 어시스턴트와 상호작용할 수 있어서, 별도의 브라우저나 통합개발환경을 실행할 필요가 없거든요.

 

물론 Cursor도 있고, 특히 최근 새로 나온 Google의 Antigravity가 강력하다고 하지만...

전체적인 기획력이나 디자인 결과물에서는 Claude Code CLI가 더 좋은 성과를 보여주고 있어요.

다만 세부적인 문제 해결 능력은 Cursor나 Antigravity가 더 뛰어날 수도 있습니다.

 

그래서 많은 개발자들이 상황에 따라 여러 AI 코딩 어시스턴트를 번갈아 사용하기도 하죠.

 

그럼 제가 Claude Code CLI를 사용하면서 꼭 필요하다고 느낀 핵심 명령어들을 자세히 알아보고,

각각이 어떻게 개발 생산성을 극대화할 수 있는지 살펴보겠습니다.

 

 

기본 설치 및 설정 명령어들

 

1. Claude Code 설치

> npm install -g claude-code

 

Claude Code를 전역으로 설치하는 첫 번째 명령어입니다.

설치가 완료되면 어느 디렉토리에서든 `claude` 명령어를 사용할 수 있게 됩니다.

 

별도의 브라우저 탭을 열 필요 없이 터미널에서 바로 AI 코딩 어시스턴트를 호출할 수 있으니까... 정말 편리하죠!

 

2. 작업 완료 알림

> claude config set --global preferredNotifChannel terminal_bell

 

장시간 작업이 완료되면 터미널 벨 소리로 알려주는 설정입니다.

Claude가 복잡한 작업을 처리하는 동안 다른 일을 하다가도 완료 알림을 받을 수 있어서 멀티태스킹이 가능해집니다.

 

3. 자동 권한 승인

> claude --dangerously-skip-permissions

 

이 명령어는 제가 아주 유용하게 사용하는 건데요...

매번 파일 편집이나 명령어 실행할 때마다 권한을 묻는 것이 번거로울 때 사용합니다.

이 플래그를 사용하면 Cursor의 YOLO 모드처럼 자동으로 권한을 승인해줍니다.

 

물론 보안 리스크가 있을 수 있지만, 신뢰할 수 있는 프로젝트에서는 개발 속도를 크게 향상시킬 수 있습니다.

 

 

세션 관리 명령어들

 

4. 새로운 세션 시작

> claude

 

새로운 세션을 시작하는 기본 명령어입니다.

깨끗한 컨텍스트에서 새로운 작업을 시작할 때 완벽하죠.

어제의 버그나 이전 작업의 컨텍스트에 얽매이지 않고 새롭게 시작할 수 있습니다.

 

5. 세션 이어서 시작

> claude --resume

 

마지막 세션을 그대로 이어서 시작합니다.

이전 대화 내용과 컨텍스트가 모두 유지되므로, 중단했던 작업을 다시 설명할 필요가 없어요.

 

6. 세션 목록 보기

> claude --sessions

 

과거 세션 목록을 보여주고 특정 세션으로 돌아갈 수 있습니다.

프로젝트별로 별도의 AI 어시스턴트를 두는 것처럼 활용할 수 있어서 정말 유용합니다.

 

 

프로젝트 초기화 및 컨텍스트 관리

 

7. 프로젝트 초기화

> /init

 

프로젝트 루트에 CLAUDE.md 파일을 생성합니다.

이 파일은 Claude가 프로젝트의 아키텍처, 의존성, 코딩 컨벤션 등을 이해하는 데 사용됩니다.

 

Claude에게 프로젝트의 "기억"을 제공하는 것과 같아서, 더 정확하고 상황에 맞는 도움을 받을 수 있습니다.

 

8. 현재 세션 초기화

> /clear

 

현재 세션의 대화 기록과 컨텍스트를 리셋합니다.

새로운 작업을 시작할 때마다 사용하는 것을 추천합니다.

 

불필요한 기록이 토큰을 낭비하는 것을 방지하고, Claude가 압축 호출을 실행해서 오래된 대화를 요약할 필요도 없어집니다.

 

9. 대화 요약

> /compact

 

현재 대화를 요약해서 핵심 정보는 유지하면서 전체 토큰 수를 줄입니다.

컨텍스트 한계에 도달하지 않고 더 길고 복잡한 상호작용을 할 수 있게 해줍니다.

 

좋은 메모를 작성하는 똑똑한 어시스턴트처럼 핵심만 정리해주니까 큰 그림에 집중할 수 있어요.

 

 

코드 리뷰 및 품질 관리

 

10. 코드 리뷰

> /review

 

풀 리퀘스트나 특정 파일, 코드 블록을 리뷰해달라고 요청합니다.

Claude가 잠재적인 버그를 발견하고, 개선사항을 제안하며, 스타일 가이드 준수 여부를 몇 초 만에 확인해줍니다.

 

사람이 놓치기 쉬운 로직 오류나 보안 이슈를 찾아내는 능력이 정말 뛰어납니다.

 

11. GitHub 앱 설치

> /install-github-app

 

GitHub 앱을 설치해서 PR을 자동으로 리뷰하도록 설정합니다.

AI 도구 사용량이 늘어나면서 PR 볼륨도 증가하는데, 이때 정말 유용한 기능이에요.

 

기본 리뷰 프롬프트가 너무 자세하다면 claude-code-review.yml 파일을 수정해서 리뷰 스타일을 커스터마이징할 수 있습니다.

 

 

개발 워크플로우 최적화

 

12. 권한 설정

> /permissions

 

Claude가 권한 요청 없이 실행할 수 있는 명령어들을 추가합니다.

반복적인 권한 승인 과정을 생략해서 개발 속도를 크게 향상시킬 수 있습니다.

 

13. 복원

> /rewind

 

현재 세션에서 보낸 메시지 목록을 보여주고, 특정 시점으로 되돌아갈 수 있습니다.

Claude가 잘못된 방향으로 진행했을 때 이전 상태로 쉽게 복원할 수 있어요.

 

마치 변경사항이 전혀 없었던 것처럼 되돌려주니까 안심하고 실험해볼 수 있습니다.

 

14. 토큰 사용량 관리

> /context

 

현재 토큰 사용량을 모니터링하고 비용을 효과적으로 관리할 수 있습니다.

긴 세션이나 토큰 집약적인 작업을 할 때 특히 중요하죠.

 

프롬프트를 최적화하고 예산 내에서 작업할 수 있도록 도와줍니다.

 

 

고급 커스터마이징 명령어들

 

15. 에이전트 설정

> claude --agents

 

커스텀 서브에이전트를 JSON 객체로 정의해서 사용할 수 있습니다.

코드 리뷰어, 디버깅 전문가 등 특정 역할에 특화된 에이전트를 만들어서 작업 효율성을 높일 수 있어요.

claude --agents '{
  "code-reviewer": {
    "description": "코드 변경 후 자동으로 사용되는 전문 코드 리뷰어",
    "prompt": "시니어 코드 리뷰어로서 코드 품질, 보안, 베스트 프랙티스에 집중하세요",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  }
}'

 

16. Claude Code 설정

> /config

 

Claude Code 설정을 위한 구성 인터페이스를 엽니다.

도구 권한, 모델 선택, 응답 형식 등 다양한 환경설정을 수정할 수 있습니다.

 

개발 환경에 맞게 Claude의 동작을 세밀하게 조정할 수 있어서 생산성 향상에 큰 도움이 됩니다.

 

17. 자동화

> /hooks

 

특정 시점에 자동으로 실행되는 사용자 정의 셸 명령어를 설정합니다.

파일 편집 후 린터 실행, 커밋 전 코드 포맷팅, 변경 후 테스트 실행 등을 자동화할 수 있어요.

 

코드 품질을 강제하고 반복적인 작업을 자동화하는 데 완벽한 기능입니다.

 

 

모델 및 출력 최적화

 

18. Claude 모델 변경

> /switch-model

 

세션 도중에 다른 Claude 모델로 전환할 수 있습니다.

복잡한 추론이 필요할 때는 Opus로, 빠른 반복 개발이 필요할 때는 Sonnet으로 전환해서 상황에 맞는 최적의 성능을 얻을 수 있어요.

 

복잡한 아키텍처 결정이나 어려운 디버깅에는 Opus, 일상적인 코딩 작업이나 빠른 반복이 필요할 때는 Sonnet을 사용하면 됩니다.

 

19. 응답 형식 조정

> /output-style

 

Claude의 응답 형식을 커스터마이즈할 수 있습니다.

상세도 수준, 코드 포맷팅 선호도, 응답 스타일 등을 프로젝트 요구사항이나 개인 취향에 맞게 조정할 수 있어요.

 

 

헤드리스 모드 및 자동화

 

20. 헤드리스 모드

> claude -p "프롬프트" --json

 

비대화형 컨텍스트에서 사용할 수 있는 헤드리스 모드입니다.

CI, 사전 커밋 훅, 빌드 스크립트, 자동화에 완벽하죠.

 

ex)
> claude -p "린팅 오류가 있다면 수정하고 커밋 메시지를 제안해주세요" --json | your_command

 

GitHub 이벤트로 트리거되는 자동화를 구축할 수 있어서, 새로운 이슈가 생성되면 적절한 라벨을 자동으로 할당하는 등의 작업이 가능합니다.

 

 

커스텀 슬래시 명령어 만들기

 

Claude Code의 진짜 매력은 커스터마이징에 있습니다.

`.claude/commands/` 폴더에 마크다운 파일을 생성해서 자신만의 슬래시 명령어를 만들 수 있어요.

 

예를 들어 `.claude/commands/test.md` 파일을 다음과 같이 작성하면:

# 테스트 생성하기
$ARGUMENTS에 대한 포괄적인 테스트를 생성해주세요.

테스트 요구사항:
- Jest와 React Testing Library 사용
- __tests__ 디렉토리에 테스트 배치
- Firebase/Firestore 의존성 모킹
- 모든 주요 기능 테스트
- 엣지 케이스와 에러 시나리오 포함

 

 

이제 `/test MyComponent`라고 입력하면 자동으로 해당 컴포넌트에 대한 테스트를 생성해줍니다.

 

 

실전 활용 팁

 

1) 프로젝트별 CLAUDE.md 파일 관리

각 프로젝트의 루트에 CLAUDE.md 파일을 두고 아키텍처, 코딩 컨벤션, 자주 사용하는 명령어 등을 문서화하세요.

Claude가 프로젝트 컨텍스트를 더 잘 이해해서 정확한 도움을 제공할 수 있습니다.

 

2) 권한 설정 최적화

개발 환경에 맞는 권한 설정을 `.claude/settings.json`에 정의하세요:

{
  "permissions": {
    "allowedTools": [
      "Read",
      "Write(src/**)",
      "Bash(git *)",
      "Bash(npm *)"
    ],
    "deny": [
      "Read(.env*)",
      "Write(production.config.*)",
      "Bash(rm *)",
      "Bash(sudo *)"
    ]
  }
}

 

 

3) 효과적인 파일 참조

프롬프트에서 `@파일명` 형식으로 파일을 참조하면 Claude가 해당 파일의 내용을 컨텍스트에 포함시켜서 더 정확한 답변을 제공합니다.

 

정확한 파일명을 모르더라도 Claude가 grep으로 찾아줄 수 있어요.

 

4) 셸 명령어 직접 실행

Claude 세션에서 `!` 를 사용하면 셸 명령어를 직접 실행할 수 있습니다.

대화 모드를 우회해서 토큰을 절약하면서 같은 결과를 얻을 수 있죠.

 

 

마무리하며...

 

Claude Code CLI의 20가지 핵심 명령어들을 살펴봤습니다.

이 도구의 진정한 가치는 개발자의 워크플로우에 자연스럽게 통합되어서 반복적인 작업을 줄이고, 코드 품질을 높이며, 개발 속도를 향상시키는 데 있습니다.

 

단순히 명령어를 외우는 것보다는 각자의 개발 패턴에 맞게 커스터마이징해서 사용하는 것이 중요해요.

커스텀 슬래시 명령어, 훅, 그리고 적절한 권한 설정을 통해서 Claude Code를 진정한 개발 파트너로 만들어보세요.

 

앞으로는 혼자서 키보드만 두드리며 코딩하는 시대가 아니라, AI와 함께 협업하는 시대입니다.

Claude Code CLI로 여러분의 개발 생산성을 한 단계 높여보시기 바랍니다!

 

 

 

 

#ClaudeCode #CLI #명령어 #Command #개발자도구 #AI코딩 #생산성향상 #터미널 #개발워크플로우 #코딩어시스턴트