터미널에서 Claude Code를 어떻게 쓰나요?

…

한줄 요약

터미널에서 프로젝트 폴더로 이동한 뒤 claude를 입력하면 시작된다. 그 다음은 Claude.ai와 대화하듯 한국어로 무엇을 해달라고 말하면 된다.

Q: 터미널에서 Claude Code를 어떻게 쓰나요?

A: 간단 답변

claude 명령어 하나로 시작한다. 실행하면 대화 화면이 열리고, 원하는 작업을 자연어로 입력하면 Claude가 파일을 직접 읽고 수정해준다. 매번 파일 내용을 복사해서 붙여넣을 필요가 없다.

상세 설명

기본 사용 흐름

# 1. 작업할 프로젝트 폴더로 이동
cd /Users/이름/프로젝트폴더

# 2. Claude Code 실행
claude

# 3. 대화 화면에서 작업 요청
> 이 폴더에 있는 파일 구조를 파악하고 README.md를 작성해줘

Claude가 폴더 안의 파일들을 읽고, 분석한 뒤, README.md를 만들어준다.

자주 쓰는 실행 방법

대화 모드 (기본)

claude

터미널 안에 대화 인터페이스가 열린다. 여러 번 주고받을 수 있다.

한 번만 실행하고 끝내기

claude -p "이 코드의 버그를 찾아줘"

단발성 질문에 쓴다. 대화 없이 결과만 출력하고 종료된다.

특정 파일을 직접 넘기기

claude "이 파일을 분석해줘" < main.py

터미널 초보자를 위한 설명

“터미널”이 낯설다면: Mac은 Spotlight에서 “터미널”을 검색해 열면 된다. Windows는 WSL Ubuntu를 쓴다.

폴더 이동은 cd 폴더이름 이다. 현재 위치 확인은 pwd다.

pwd
# /Users/이름/Desktop 같은 경로가 나옴

cd Desktop/내프로젝트
pwd
# /Users/이름/Desktop/내프로젝트

여기서 claude를 치면 이 폴더 기준으로 Claude Code가 작동한다.

Claude Code가 실행되면 뭘 볼 수 있나

╭─────────────────────────────╮
│ Claude Code v1.x.x          │
│ 현재 폴더: /Users/이름/프로젝트 │
╰─────────────────────────────╯

>

이 > 프롬프트에 원하는 작업을 입력한다.

실제 요청 예시

  • 이 프로젝트에 어떤 파일들이 있어?
  • app.py에서 오류가 나고 있어. 원인 찾아줘
  • 함수명을 모두 영어에서 한국어로 바꿔줘
  • 테스트 코드 작성해줘

종료 방법

/exit 입력하거나 Ctrl + C를 누르면 종료된다.

핵심 정리

  • 프로젝트 폴더에서 claude 입력으로 시작
  • 한국어로 자연스럽게 작업 요청 가능
  • -p "질문" 옵션으로 단발성 실행 가능
  • /exit 또는 Ctrl+C로 종료

관련 글

← FAQ 전체 보기