claude 명령어 한 줄로 AI 코딩 시작하기 (입문자 첫걸음)

AI 코딩을 시작해 보려고 Claude Code를 설치했는데, 막상 "그래서 이걸 어떻게 켜지?" 하고 막히는 분이 많아요. 답은 의외로 싱겁습니다. 터미널에 claude라고 치면 끝이에요. 다만 그 한 줄에 숨은 중요한 규칙이 하나 있는데, 이걸 알면 처음부터 헷갈리지 않아요.

정의 (뭐냐면)

claude는 Claude Code를 켜는 가장 기본 명령이에요. 터미널(명령 프롬프트)에 claude만 치면, 지금 들어가 있는 폴더를 작업 공간으로 삼아 대화창이 열립니다. 여기서 핵심은 "현재 폴더 = 작업 대상"이라는 점이에요. 즉 Claude는 여러분이 명령을 친 그 폴더 안의 파일들을 보고 작업해요. 그래서 어떤 폴더에서 켜느냐가 무척 중요합니다.

어떻게 쓰나 (난이도별)

시작 전에: 터미널을 열고, 작업하려는 프로젝트 폴더로 먼저 이동해야 해요. 이동은 cd 폴더경로 명령으로 합니다(cd = change directory, 폴더 이동). 처음 실행하면 로그인을 요구할 수 있는데, 그건 아래 "흔한 함정"에서 다룰게요.

기초 — 폴더로 이동 후 실행

cd ~/projects/my-blog
claude

먼저 블로그 폴더로 이동한 뒤 claude를 켜는 흐름이에요. ~는 내 홈 폴더를 뜻하는 줄임 기호인데, 윈도우에서는 C:\Users\사용자명\ 자리예요. 그래서 윈도우라면 cd C:\Users\사용자명\projects\my-blog 처럼 적습니다. 실행하면 화면이 대화 모드로 바뀌고, 아래에 입력창이 생겨 채팅하듯 명령을 적을 수 있어요. 끝낼 때는 /exit를 입력하거나 Ctrl+C를 두 번 누르면 됩니다.

응용 — 켜면서 첫 일까지 시키기

claude "이 프로젝트 구조를 설명해줘"

claude 뒤에 따옴표로 할 일을 붙이면, 켜자마자 그 일을 바로 시작해요. 새 프로젝트를 처음 열었을 때 "전체가 어떻게 생겼는지" 파악하는 데 특히 좋아요.

심화 — 모델·추가 폴더를 정해서 시작

claude --model opus --add-dir ../shared-lib

--model opus는 어떤 AI 모델로 작업할지 고르는 옵션이고, --add-dir는 현재 폴더 말고 추가로 더 들여다볼 폴더를 알려주는 옵션이에요(../shared-lib는 상위 폴더 안의 공용 라이브러리 폴더를 가리켜요). 여러 폴더에 걸친 프로젝트를 다룰 때 유용합니다.

흔한 함정

처음 claude를 켜면 로그인을 요구할 수 있어요. 그럴 때는 당황하지 말고 claude auth login을 입력해 Anthropic 계정으로 로그인하면 됩니다. 로그인은 보통 한 번만 해두면 그 다음부터는 바로 켜져요.

또 하나, 엉뚱한 폴더에서 켜면 Claude가 엉뚱한 파일을 보게 돼요. 켜기 전에 "내가 지금 맞는 폴더에 있나"를 pwd(현재 폴더 경로 보기) 명령으로 확인하는 습관을 들이면 좋아요.

실전 사례

새 노트북에서 블로그 코드를 처음 열었을 때, 해당 폴더로 이동한 뒤 claude "README 읽고 프로젝트 요약해줘" 한 줄로 5분 만에 프로젝트 전체 그림을 파악한 사례가 있어요. 직접 파일을 하나하나 열어 읽는 것보다 훨씬 빠릅니다.

이렇게 더 씁니다

• 폴더 단위로 작동하니, 프로젝트마다 폴더를 나눠두면 대화 기록·설정이 깔끔하게 분리돼요.
• 자주 쓰는 프로젝트는 폴더 위치를 메모해 두고 cd로 바로 이동하는 흐름을 익혀두면 편해요.

다른 사람들은 이렇게 씁니다

• Anthropic이 권장하고 제작자도 매일 쓰는 4단계 흐름(탐색 → 계획 → 구현 → 커밋)이 공식 문서에 정리돼 있어요: Common workflows — Claude Code Docs
• 실제 개발자가 Claude Code를 매일 어떻게 쓰는지 정리한 글도 참고할 만해요: How I Use Claude Code — Boris Tane

정리

claude는 AI 코딩의 시작 버튼이에요. "현재 폴더가 곧 작업 대상"이라는 규칙만 기억하면, 맞는 폴더로 이동해 claude 한 줄로 작업을 시작할 수 있어요. 로그인 요구가 떠도 claude auth login이면 해결되니 겁먹지 마세요.

기준: Claude Code v2.1.154 (2026.05)