클로드 코드(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