Claude Code 초기 30분 설정 가이드 — 「일단 실행하기」에서 「실전 활용」까지

Claude Code를 설치해 보았지만, 다음과 같은 상태에서 멈춰 있지는 않으신가요?

• 실행은 했지만, 처음에 무엇을 부탁해야 할지 모르겠다
• 일단 채팅처럼 사용하고 있지만, 일반적인 AI 채팅과 무엇이 다른지 실감이 나지 않는다
• 「대단하다」는 말을 듣고 설치했는데, 효과를 잘 체감할 수 없다
• 설정 항목이 다양하지만, 처음에 무엇을 건드려야 할지 모르겠다

Claude Code는 **터미널에서 동작하는 AI 코딩 에이전트 (AI Coding Agent)**입니다. 일반적인 채팅 AI와 달리, 파일을 읽고 쓰며, 명령어를 실행하고, 여러 단계의 작업을 스스로 진행할 수 있습니다. 다만, 그 능력을 최대한 끌어낼 수 있느냐는 초기 설정에 따라 크게 달라집니다.

이 기사에서는 Claude Code를 설치한 직후, 초기 30분 동안 해두어야 할 설정과 사용법을 순서대로 직접 따라 할 수 있는 형태로 정리합니다. 어려운 이야기는 뒤로 미루고, 우선 「실전에서 사용할 수 있는 상태」로 만드는 것을 목표로 합니다.

가장 먼저 사고방식을 전환해야 할 부분입니다. 많은 사람이 처음에는 Claude Code를 챗봇처럼 다룹니다. 「이 코드 어떻게 생각해?」라고 묻고, 돌아온 문장을 직접 복사해서 붙여넣는 방식입니다.

그렇게 해도 동작은 하지만, 본래의 사용법은 아닙니다. Claude Code는 스스로 파일을 열고, 편집하고, 테스트를 실행하며, 결과를 보고 다음 수를 둘 수 있는 에이전트입니다. 즉, 「답을 알려주는 상대」가 아니라 「작업을 맡기는 동료」로 대하는 것이 정답입니다.

사용법	예시	평가
채팅 방식	「로그인 처리 작성법을 알려줘」 → 답변을 직접 복사/붙여넣기	아까움
에이전트 방식	「src/auth/에 로그인 처리를 구현하고, 테스트도 작성해줘」	본래의 사용법

이 차이를 의식하는 것만으로도 부탁하는 방식이 달라집니다. 「알려줘」가 아니라 「해줘」. 이것이 출발점입니다.

의외로 간과하기 쉽지만, 어느 디렉토리에서 실행하는가가 첫 번째 분수령입니다.

Claude Code는 실행한 디렉토리를 작업의 기점으로 삼습니다. 프로젝트의 루트( package.json 이나 .git 이 있는 계층)에서 실행하지 않으면, 파일의 위치 관계를 정확하게 파악할 수 없습니다.

# 좋은 예: 프로젝트 루트에서 실행
cd ~/projects/my-app
claude
...

실행했다면, 먼저 현황을 파악하게 합니다. 갑자기 구현을 부탁하기보다, 처음에 「이 프로젝트를 이해해줘」라고 말하는 것이 그 이후의 정확도를 높입니다.

먼저 이 프로젝트의 구성을 파악해줘.
주요 디렉토리의 역할과 사용된 기술 스택을
3~5줄로 설명해줘.

Claude Code에는 CLAUDE.md라는 메커니즘이 있습니다. 이것은 프로젝트 취급 설명서로, 실행할 때마다 자동으로 읽어 들여집니다. 기술 스택, 코딩 규약, 금지 사항 등을 여기에 적어두면 매번 다시 설명해야 하는 번거로움이 사라집니다.

처음부터 직접 쓸 필요는 없습니다. /init 명령어를 사용하면 프로젝트를 분석하여 CLAUDE.md의 초안을 자동으로 생성해 줍니다.

/init

실행하면 프로젝트 구성, 사용 언어, 빌드 명령어 등을 조사하여 CLAUDE.md를 만들어 줍니다. 생성된 후에는 자신의 운영 방식에 맞춰 몇 줄 추가해 두면 효과가 높아집니다.

# CLAUDE.md (추가 예시)
## 이 프로젝트의 규칙
- 패키지 매니저는 npm을 사용한다 (yarn 금지)
...

포인트는, 「매번 구두로 말하고 있는 것」을 이곳으로 옮기는 것입니다. 「테스트는 vitest로」, 「DB는 Postgres로」와 같은 매번의 전제 조건을 적어두면 대화가 깔끔해지고 지시 사항을 놓치는 일도 줄어듭니다.

Claude Code는 파일 편집이나 명령어 실행을 할 때마다 「실행해도 될까요?」라고 확인을 요청합니다. 안전을 위한 장치이지만, 매번 y를 누르는 것은 은근히 스트레스입니다.

자주 사용하는 안전한 명령어는 사전에 허용해 둘 수 있습니다. /permissions로 설정 화면을 열 수 있습니다.

/permissions

예를 들어 다음과 같은 읽기 전용 또는 저위험 명령어는 허용해 두면 작업이 매끄러워집니다.

허용해 두면 쾌적한 명령어 예시
├─ npm test / npm run build 등의 빌드·테스트 계열
├─ git status / git diff 등의 읽기 계열
...

반대로, rm -rf 나 git push --force와 같은 파괴적·비가역적인 명령어는 허용 리스트에 넣지 않고 매번 확인하도록 설정하는 것이 안전합니다. "읽기·확인 계열은 허용, 파괴 계열은 매번 확인"이라는 기준을 처음에 정해 두세요.

주의: 허용 설정은 프로젝트 단위로 .claude/settings.json에 저장됩니다. 팀에서 공유할 경우에는 멤버 전원이 안전하다고 납득할 수 있는 범위로 한정하세요.

여기서부터는 사용 팁입니다. 초보자들이 흔히 하는 실수는 갑자기 큰 구현을 통째로 맡겨버리는 것입니다.

나쁜 예: "사용자 등록 기능을 전부 만들어줘"
→ 갑자기 대량의 파일을 쓰기 시작하며, 예상과 어긋난 구현이 되기 쉬움

추천하는 방식은, 구현 전에 계획을 세우게 하고 그것을 확인한 뒤에 착수하게 하는 방법입니다. Claude Code에는 계획을 먼저 세우는 모드 (Plan Mode)가 있지만, 우선은 말로 부탁하는 것만으로도 충분히 효과가 있습니다.

좋은 예:
"사용자 등록 기능을 구현하고 싶어.
아직 코드는 쓰지 마.
...

계획을 보고 "이 부분은 달라", "이 순서로 해"라고 수정한 뒤 착수시키면 재작업 (rework)이 급격히 줄어듭니다. **"갑자기 만들게 하지 말고, 먼저 계획부터"**는 처음에 익혀야 할 습관 중 하나입니다.

마지막으로, 오래 사용할수록 효과를 발휘하는 습관입니다. Claude Code는 대화, 읽어들인 파일, 실행 결과 등을 모두 기억에 쌓아갑니다. 이것이 넘치게 되면, 긴 세션에서 갑자기 지시 사항을 놓치기 시작합니다.

대책은 간단합니다. 태스크가 바뀌면 대화를 리셋하는 것입니다.

명령어	역할	사용하는 상황
/clear	대화 이력을 통째로 폐기한다	다른 태스크로 넘어갈 때
/compact	대화 이력을 요약본으로 압축한다	같은 작업을 계속하지만 대화가 길어졌을 때

"인증 버그 수정이 끝났다 → 다음은 README를 작성한다"와 같이 테마가 바뀔 때는 /clear를 사용하세요. 같은 작업의 연속으로 대화가 길어진다면 /compact를 사용하세요. 이 차이를 기억해 두면, 오후에 갑자기 정확도가 떨어지는 현상을 상당히 방지할 수 있습니다.

단계	할 일	소요 시간
1	프로젝트 루트에서 실행하여 구성을 파악하게 한다	5분
2	/init으로 CLAUDE.md를 생성하고 규칙을 몇 줄 추가한다	10분
3	/permissions로 안전한 명령어를 허용하고, 파괴 계열은 매번 확인한다	5분
4	큰 작업은 "먼저 계획"을 세우게 한 뒤 착수한다	습관
5	태스크의 구분점에서 /clear 또는 /compact를 사용한다	습관

Claude Code는 처음에 설정을 조금만 정돈해도 체감 성능이 확 달라집니다. 특히 단계 2의 CLAUDE.md와 단계 4의 계획 우선 (Plan First) 방식은 오늘부터 바로 효과를 느낄 수 있을 것입니다.

우선 설치가 완료된 프로젝트를 하나 열어서 /init부터 시작해 보세요. 그것만으로도 "일단 실행하기"에서 "실전 활용"으로 한 걸음 나아갈 수 있습니다.

CLAUDE.md를 처음부터 쓰는 것이 번거롭다면, 설계 형식을 해설한 스킬을 활용하면 원활합니다. 제가 사용하는 스킬을 무료로 공개하고 있습니다.

무료 스타터 (GitHub · CC BY 4.0):

Claude Code를 실전에 투입하기 위한 4가지 스킬 (CLAUDE.md 설계 · 계획 우선 개발 (PIV) · AI 커밋 전략 · 애자일한 프롬프트 설계)이 일본어와 영어로 포함되어 있습니다. CLAUDE.md 설계 스킬을 읽으면서 /init의 결과를 자신에게 맞게 다듬는 데 사용할 수 있습니다. 우선 무료 리포지토리에서 시도해 보세요.

최신 팁은 X에서도 발신하고 있습니다: @k___n___t_1125