빠른 시작

클로드를 처음 시작할 때 8단계를 통해 차근차근 알아보자.

단계 1: Claude Code 설치

Claude Code는 터미널에서도, 익스텐션으로도 설치 가능하지만 Native Install을 추천(Recommended)한다.

네이티브 설치가 권장되는 이유는

1. 자동 업데이트: 백그라운드에서 자동으로 업데이트되어 항상 최신 버전 유지

   • Native installations automatically update in the background to keep you on the latest version.

   • Homebrew installations do not auto-update. Run brew upgrade claude-code periodically to get the latest features and security fixes.

2. 충돌 방지: 여러 설치(npm 혹은 homebrew 등) 버전 불일치나 예기치 않은 동작이 있을 수 있음

3. Node.js 불필요

의 이유가 있는데, 제일 큰 건 자동 업데이트. homebrew로 설치한 Claude는 옆에 계속 업데이트가 되었으니 brew로 업데이트하라는 문구가 뜬다.

버전 관리 하고 싶은 사람은 homebrew, 항상 최신 유지하고 싶으면 native를 사용하면 되겠다.

단계 2: 계정에 로그인

claude, /login을 통해 계정에 로그인이 가능하다.

vscode에 익스텐션으로 설치하면 GUI를 통해 로그인이 가능함.

계정을 하나로 통일한다면 터미널, vscode, 앱 이 세 가지를 동일한 아이디 아래에서 지휘할 수 있음.

계정을 전환하려면 /login을 통해 전환하면 된다.

Q) 계정을 전환한다고 했을 때 세션은 그대로 유지가 되나?

세션은 로컬에 저장되기 때문에, /login으로 계정을 전환해도 대화 기록 자체는 로컬 디스크에 남는다.

claude app과 claude 페이지에서 대화한 내역은 로컬이 아닌 서버에 남기 때문에 대화 기록이 저장됨.

claude code(터미널, vscode)만! 세션이 로컬에 저장됨!

단계 3: 첫 번째 세션 시작

프로젝트 디렉토리에서 터미널을 열고 Claude Code를 시작한다.

cd /path/to/your/project
claude

이전 대화를 계속하려면 /resume를 입력한다.

단계 4, 5: 첫 번째 질문하기 & 첫 번째 코드 변경 수행

여기서부터는 짧은 프롬프트를 통해 코드베이스를 이해하는 명령을 보여 준다.

• 이 프로젝트는 무엇을 하나요?

• 어떤 기술을 사용하나요?

• 주요 진입점은 어디인가요?

• 폴더 구조를 설명해 주세요

• Claude Code는 무엇을 할 수 있나요?

• 사용자 정의 skills를 만드는 법

등등...

사용자 정의 Skills?

Claude Code의 기능을 확장하는 커스텀 명령어/지침 (Skills의 상세 가이드에서 공부)

Claude Code는 필요에 따라 프로젝트 파일을 읽기 때문에, 수동으로 컨텍스트를 추가할 필요가 없다.

~.tsx 파일에 hello world 써줘 같은 명령으로 코드를 변경시킬 수도 있다.

해당 주문이 들어오면 Claude Code는 아래처럼 수행한다.

1. 적절한 파일 찾기

2. 제안된 변경 사항 표시

3. 승인 요청

4. 편집 수행

Claude Code는 파일을 수정하기 전에 항상 권한을 요청하나, 변경 사항 승인이나 세션에 대해 재차 물어보지 않도록 "모두 수락"모드를 켤 수도 있다.

모두 수락 모드는 사용자의 컨펌을 받지 않기 때문에 조심히 사용해야 한다...

단계 6: Claude Code와 함께 Git 사용

Git 작업또한 할 수 있다. 브랜치를 생성하거나 커밋을 날리는 등의 작업이 가능하다.

단계 7: 버그 수정 또는 기능 추가

사용자는 단계 4, 5와의 차이점 없이 그냥 버그나 기능을 추가하게 하면 된다.

Claude Code는 다음과 같은 내용으로 수행한다.

1. 관련 코드 찾기

2. 컨텍스트 이해

3. 솔루션 구현

4. 사용 가능한 경우 테스트 실행

단계 8: 다른 일반적인 워크플로우 시도

• 코드 리팩토링

• 테스트 작성

• 문서 업데이트

• 코드 검토

클로드 코드를 사용하여 하나의 작은 개발팀을 꾸리는 게 가능하다는 이야기.

필수 명령

여러 가지 명령들이 있겠지만, 초보자를 위한 명령은 10개 내외로 좁혀진다.

이 명령어들은 CLI에서 사용하는 명령어고, 익스텐션에서는 명령어 없이 자연어로 작성하면 된다.

• claude : 대화형 모드 시작

• claude "task(여기에 원하는 것 작성)" : 일회성 작업 실행 -> 대화형 모드를 시작하면서 첫 질문을 바로 전달하는 단축 방법

• claude -p "query" : 일회성 쿼리 실행 후 종료 -> -p를 사용하면 실행 후 클로드가 종료된다

• claude -c : 현재 디렉토리에서 가장 최근 대화 지속

• claude -r : 이전 대화 재개 -> 특정 과거 세션을 선택 가능함

• claude commit : Git 커밋 생성

• /claer : 대화 기록 지우기

• /help : 사용 가능 명령 표시

• exit : 종료

초보자를 위한 팁

자세하게 들어가기 전 짧은 팁을 안내한다.

요청을 구체적으로 작성하기

yes : 사용자가 잘못된 아이디/PW를 입력한 후 빈 화면을 보는 로그인 버그 수정

no : 버그 수정

단계별 지침 사용

거의 이 수준으로 작업하면 훨씬 좋겠지... 역시 클래식은 영원하다.

복잡한 작업을 단계로 나누면 좋다.

1. 사용자 프로필을 위한 새 DB 테이블 생성

2. 사용자 프로필을 가져오고 업데이트하는 API 엔드포인트 생성

3. 사용자가 자신의 정보를 보고 편집할 수 있는 웹페이지 구축

Claude가 먼저 탐색하도록 하기

작업 시작 전 코드 이해를 먼저 하면 실수를 줄일 수 있다.

1. 데이터베이스 스키마 분석하고

2. 고객이 자주 반품하는 제품을 보여 주는 대시보드를 구축해 줘

바로가기로 시간 절약

• ?를 눌러 사용 가능한 모든 키보드 바로가기 보기

• 명령 완성을 위해 Tab 사용

• ⬆️를 눌러 명령 기록 보기

• /를 입력하여 모든 명령 및 skills 보기

빠른 시작인 만큼 대체적으로 클로드가 할 수 있는 일에 대해서 간략하게 설명한 느낌이 크다.

skills나 작동방식, 모범 사례 같은 것들이 궁금해지는 페이지였다.

그래서 그런지, Docs에서도 이러한 것들을 추가로 배워 보는 것을 추천해 주고 있다.

Docs를 보면서 옆에 어시스턴트를 켜 놓고 하는데, 생각보다 편리하고 좋다.