TIL/Claude Code

[TIL] Claude Code 설정 #1 - 자주 사용하는 명령어, 유용한 서비스

아람2 2025. 12. 24. 12:09
반응형

 Claude Code Init 

 

init 을 실행하면 Claude Code 가 프로젝트를 분석하고, CLAUDE.md 파일을 자동으로 생성한다 

CLAUDE.md 파일에는 Project Overview, Essential Commands, Running Tests 등이 포함된다 

여기에 내가 주로 사용하는 스타일이나 네이밍 규칙을 함께 정리해 두면,

Claude Code 가 시스템 프롬프트 최상단에서 CLAUDE.md 를 먼저 참고한 뒤 요청을 처리하기 때문에
프로젝트 전반에 대한 이해도를 크게 높일 수 있다

Cursur 의 Cursor Rules 와 유사한 역할을 하는 기능이라고 이해하면 된다 

 

 

MCP List 확인

내가 설치한 MCP List 는 Terminal 에서 아래 명령어로 확인하거나, Claude 에서 /mcp 로 확인 가능하다 

claude mcp list

 

 

Claude Code 모드 변경 

Shift + Tab Key 를 누르면 Claude Code 의 모드를 변경할 수 있다 

 

Plan Mode - 전체적인 프로젝트 설계 및 계획 수립 

Accept Mode - 실제 코드 변경 및 적용 

 

Config 

Claude Code 기본 세팅값을 변경할 수 있다 

 

Output Style 을 Learning 으로 설정하면, 

사용자가 학습할 수 있도록 작은 코드 단우의 설명과 설정 예시를 함께 제공한다 

 

커스텀 Output Style 생성

나만의 Output Style 을 만들고 싶다면,

.claude 폴더 내에 output-style 폴더를 생성하고 Markdown 파일을 작성하면 된다 

 

Sub Agent

여러가지 Sub Agent 를 만들 수 있다 

원하는 페르소나를 입력하고 모델, 색상 등을 선택하면 Claude Code 가 해당 Agent 를 생성한다 

생성된 Agent 를 병렬로 실행해서 빠르게 개발을 진행할 수 있다 

 

Slash Commands 

/clear

하나의 세션 내부에서 개발을 지속하면 컨텍스트 내용이 섞일 수 있으므로 

새로운 기능을 개발할 때는 기존 세션을 초기화한 후 진행하는 것이 좋다

/compact 

대화를 요약하고 압축해서 컨텍스트 윈도우를 확보한다 

긴 세션을 유지하면서도 토큰 사용량을 줄이고 싶을 때 유용하다 

/resume

이전에 진행했던 대화 내역을 다시 불러온다 
중단했던 작업을 이어서 진행할 때 유용하다 

/help

Claude Code 에서 제공하는 슬래시 명령어 및 사용 방법에 대한 도움말을 확인할 수 있다 

/model

현재 사용 중인 Claude 모델을 확인하거나 변경할 수 있다 
작업 성격에 따라 성능/ 속도 중심의 모델 선택이 가능하다 

/status 

Claude Code 의 현재 상태 및 활성 설정 정보를 확인할 수 있다

/doctor

설치 상태, 환경 변수, 의존성 등을 점검하여 설치 또는 실행 환경에 문제가 있는지 진단한다

/memory

Claude Code 가 사용하는 프로젝트/ 유저 메모리 관리 기능,
저장된 메모리를 확인하거나 수정·삭제할 수 있다

/permissions 

Claude Code가 접근 가능한 파일, 디렉터리, 권한 설정을 확인 및 관리한다 
보안 또는 접근 범위 제어가 필요할 때 사용한다

/review 

현재 코드에 대해 Claude Code 가 Code Review 를 수행한다 
구조, 가독성, 개선 포인트 등을 자동으로 피드백해 준다

/vim

Claude Code 를 Vim 스타일 키 바인딩으로 사용할 수 있다 
터미널 기반 편집 환경에 익숙한 사용자에게 적합하다

 /statusline

터미널 하단에 현재 모드, 모델, 상태 정보를 표시하는 Status Line 을 활성화한다 
작업 중 컨텍스트를 빠르게 파악할 수 있다

 

커스텀 슬래시 명령어 생성 

반복적으로 사용하는 프롬프트를 슬래시 명령어로 등록하여 사용할 수 있다

🐣 지금은 토큰 다 써서 추후 다시 진행할 예정 

 

유용한 CLI 명령어 

Session 선택 

/resume 과 동일하게, 기존 대화 내역 불러오기 

claude --resume
cluade -r

Headless 모드 실행 

claude -p "Commmand"

상세 로그 출력 

상세한 로그를 출력해줘서 디버깅에 유용

claude --verbose

 

 

유용한 서비스 

1. ccusage

Claude Code 사용량을 확인할 수 있는 서비스

npx ccusage

2. Super Claude

Claude Code 에 전문화된 명령어, 인지 페르소나, 개발 방법론을 추가해 주는 설정 프레임워크

https://github.com/SuperClaude-Org/SuperClaude_Framework

 

GitHub - SuperClaude-Org/SuperClaude_Framework: A configuration framework that enhances Claude Code with specialized commands, c

A configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies. - SuperClaude-Org/SuperClaude_Framework

github.com

3. Claude Code Templates

슈퍼 클로드와 다르게, 특정 명령어, 훅, 에이전트를 선택적으로 적용할 수 있는 템플릿 제공 서비스

https://www.aitmpl.com/agents

 

Claude Code Templates - Supercharge Your AI Development with Anthropic Claude

Professional templates for Anthropic's Claude Code. Deep coding at terminal velocity with Claude Opus 4.1. Install 100+ agents, commands, settings & hooks. Transform your AI-powered development workflow.

www.aitmpl.com

 

참고한 강의

https://youtu.be/Ek_I0iFyyZU?si=A28iin-aJd5Arn_4

https://www.youtube.com/watch?v=a1a9wV88MSM

 

반응형