클로드 코드(Claude Code)를 설치까지는 했는데, 막상 실행한 뒤 무엇부터 해야 할지 막막한 경우가 많습니다. 이 단계에서는 기능을 전부 외우기보다, 어떻게 시작하고, 어떤 식으로 질문하고, 어떤 명령을 자주 쓰는지만 먼저 잡아도 사용감이 훨씬 좋아집니다.
이 글은 클로드 코드를 처음 실행한 뒤 바로 써먹을 수 있는 사용법만 추려서 정리한 초보자용 가이드입니다. 설치는 끝났고, 이제 실제로 어떻게 쓰는지 궁금한 분에게 맞춰서 구성했습니다.
Table of Contents
가장 먼저 하는 사용 흐름
처음에는 복잡하게 생각할 필요가 없습니다. 보통은 아래 순서로 시작하면 됩니다.
- 작업할 프로젝트 폴더로 이동
claude실행- 자연어로 하고 싶은 작업 설명
- 변경안 확인 후 계속 진행
즉 IDE처럼 메뉴를 찾는 방식이 아니라, 터미널에서 바로 대화하며 작업을 맡기는 흐름에 가깝다고 보면 됩니다.
가장 먼저 해볼 만한 질문 예시
처음에는 너무 큰 작업보다, 짧고 명확한 요청부터 해보는 편이 좋습니다.
이 프로젝트 구조를 먼저 설명해줘README 초안을 만들어줘이 폴더에서 중요한 파일만 먼저 정리해줘버그가 날 만한 부분을 먼저 찾아줘
이렇게 시작하면 클로드 코드가 프로젝트를 어떻게 읽고 반응하는지 감을 잡기 쉽습니다.
자주 쓰는 명령
claude
claude -c
claude -p "질문"
/help
/login
claude commitclaude
가장 기본적인 시작 명령입니다. 대화형으로 들어가서 작업을 이어갈 때 가장 많이 씁니다.
claude -c
최근 대화를 이어서 작업하고 싶을 때 유용합니다. 흐름을 끊지 않고 다시 붙는 느낌이라 자주 쓰게 됩니다.
claude -p “질문”
짧은 답만 받고 끝내고 싶을 때 편합니다. 대화형으로 오래 들어가기보다, 한 번 물어보고 바로 결과만 보고 싶을 때 유용합니다.
/help
현재 쓸 수 있는 명령을 확인할 때 씁니다. 처음엔 이 명령 하나만 알아도 훨씬 편합니다.
/login
로그인 상태가 꼬이거나 다시 인증해야 할 때 씁니다.
claude commit
변경 내용을 바탕으로 커밋 메시지를 만들 때 유용합니다.
어떤 식으로 요청해야 잘 동작할까
클로드 코드는 짧은 키워드만 던질 때보다, 무엇을 원하는지, 어디까지 바꾸길 원하는지, 무엇은 건드리지 말아야 하는지를 같이 말해줄 때 훨씬 안정적으로 반응합니다.
예를 들면 이런 식입니다.
이 파이썬 프로젝트 구조를 먼저 설명하고,
중복 파일이 있으면 알려줘.
아직 코드는 수정하지 말고 분석만 해줘.이렇게 요청하면 무작정 수정부터 들어가는 일을 줄일 수 있습니다.
처음에는 작은 작업부터 맡기는 게 좋습니다
처음부터 “앱 하나 통째로 만들어줘”처럼 큰 작업을 맡기면 결과가 오히려 산만해질 수 있습니다. 대신 아래처럼 나누는 편이 좋습니다.
- 프로젝트 구조 설명
- 특정 파일 요약
- 함수 하나 개선
- 에러 원인 분석
- 테스트 코드 초안 작성
이런 작은 단위로 써보면, 어떤 작업에서 잘 맞고 어떤 부분은 직접 보는 게 좋은지 금방 감이 옵니다.
이럴 때 특히 편합니다
- 처음 들어온 프로젝트 구조를 빠르게 파악할 때
- 긴 파일을 요약하고 핵심만 보고 싶을 때
- 리팩터링 방향을 먼저 잡고 싶을 때
- 커밋 메시지나 설명 문서를 정리할 때
처음 쓸 때 자주 헷갈리는 점
대화형이 너무 길어질 때
이럴 때는 새로 claude를 시작하거나, 짧은 질문은 claude -p로 분리하는 편이 좋습니다.
프로젝트 바깥 작업을 시키고 싶을 때
기본적으로는 현재 폴더 기준으로 생각하는 편이 안전합니다. 처음에는 작업 폴더를 명확하게 잡고 시작하는 습관이 중요합니다.
무엇을 요청해야 할지 막막할 때
처음에는 “설명”, “요약”, “정리”, “분석” 같은 요청부터 시작하는 편이 좋습니다. 바로 수정 명령부터 던지기보다, 먼저 읽게 하는 쪽이 훨씬 안정적입니다.
설치 글 다음에 이 글을 보는 이유
설치 글에서는 실행까지가 목표였다면, 이 글은 실제로 어떻게 써야 덜 헤매는지를 정리한 글입니다. 설치가 끝난 다음 바로 이어서 보면 가장 이해가 잘 됩니다.
정리
클로드 코드는 기능을 한꺼번에 다 익히려 하기보다, 프로젝트 폴더에서 시작하기, 짧고 명확하게 질문하기, 자주 쓰는 명령 몇 개만 먼저 익히기 이 세 가지만 잡아도 훨씬 편하게 쓸 수 있습니다.
처음에는 작은 작업부터 맡겨보면서, 어디까지 맡기면 좋은지 감을 잡는 편이 가장 현실적입니다.
함께 보면 좋은 글:
참고한 공식 문서
- Claude Code Quickstart
- Claude Code Common Workflows