클로드 코드 빠른 시작

클로드 코드 빠른 시작

https://docs.anthropic.com/ko/docs/claude-code/quickstart

시작하기 전에


다음 사항을 확인하세요:

  • 터미널 또는 명령 프롬프트가 열려 있음 (리눅스, 윈도우즈, 맥 모두 동일)
  • 작업할 코드 프로젝트가 있음
  • Claude pro 또는 max 이상 계정 가입
  • Claude.ai (권장) 또는 Anthropic Console 계정

1단계: Claude Code 설치

NPM 설치

Node.js 18 이상이 설치되어 있다면: 없으면 링크로 가서 다운로드하고 설치 할 것

npm install -g @anthropic-ai/claude-code

네이티브 설치 (중요)

현재 베타 버전인 새로운 네이티브 설치가 가능함. 

윈도우즈 power shell이나 command 창에서 실행 할 수 있음. 

WSL에서 실행하는 것을 윈도우즈로 변환할 수 있음(경로 및 사용 프로그램 재설정 필요) 

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

2단계: 계정에 로그인

Claude Code를 사용하려면 계정이 필요합니다. claude 명령으로 대화형 세션을 시작할 때 로그인해야 합니다:

claude
# 처음 사용할 때 로그인하라는 메시지가 표시됩니다

/login
# 프롬프트에 따라 계정으로 로그인하세요

다음 두 가지 계정 유형 중 하나로 로그인할 수 있습니다:

  • Claude.ai (구독 플랜 - 권장, pro나 max 사용 max는 $100, $200 두가지 옵션있음. (vat 별도))
  • Anthropic Console (선불 크레딧으로 API 액세스, 코딩을 많이 할 것이면 비용이 매우 많이 소요될 수 있음. 구독으로 pro또는 max로 할 경우 충분히 사용 가능)

로그인하면 자격 증명이 저장되어 다시 로그인할 필요가 없습니다. 만약에 문제가 되면 claude 에서 /login 옵션으로 수정 할 수 있음.

** Anthropic Console 계정으로 Claude Code를 처음 인증하면 "Claude Code"라는 작업 공간이 자동으로 생성됩니다. 이 작업 공간은 조직의 모든 Claude Code 사용에 대한 중앙 집중식 비용 추적 및 관리를 제공합니다. 

** 동일한 이메일 주소로 두 계정 유형을 모두 가질 수 있습니다. 다시 로그인하거나 계정을 전환해야 하는 경우 Claude Code 내에서 /login 명령을 사용하세요. </Note>

3단계: 첫 번째 세션 시작

프로젝트 디렉토리에서 터미널을 열고 Claude Code를 시작하세요: 바로 터미널에서 사용이 가능하며, VS code 나 커서와 같은 외부 에디터 이용시 "code ." 입력 후 vs code terminal 에서 claude 입력

cd /path/to/your/project
claude

새로운 대화형 세션 내에서 Claude Code 프롬프트를 볼 수 있습니다:

✻ Welcome to Claude Code!

...

> Try "create a util logging.py that..."

<Tip> 로그인 후(2단계), 자격 증명이 시스템에 저장됩니다. 자격 증명 관리에서 자세히 알아보세요. </Tip>

4단계: 첫 번째 질문하기

코드베이스를 이해하는 것부터 시작해보겠습니다. 다음 명령 중 하나를 시도해보세요:

> what does this project do?

Claude가 파일을 분석하고 요약을 제공합니다. 더 구체적인 질문도 할 수 있습니다:

> what technologies does this project use?

> where is the main entry point?

> explain the folder structure

Claude의 자체 기능에 대해서도 질문할 수 있습니다:

> what can Claude Code do?

> how do I use slash commands in Claude Code?

> can Claude Code work with Docker?

<Note> Claude Code는 필요에 따라 파일을 읽습니다 - 수동으로 컨텍스트를 추가할 필요가 없습니다. Claude는 또한 자체 문서에 액세스할 수 있으며 기능과 능력에 대한 질문에 답할 수 있습니다. </Note>

5단계: 첫 번째 코드 변경하기

이제 Claude Code가 실제 코딩을 하도록 해보겠습니다. 간단한 작업을 시도해보세요:

> add a hello world function to the main file

Claude Code는:

  1. 적절한 파일을 찾습니다
  2. 제안된 변경 사항을 보여줍니다
  3. 승인을 요청합니다
  4. 편집을 수행합니다

<Note> Claude Code는 파일을 수정하기 전에 항상 허가를 요청합니다. 개별 변경 사항을 승인하거나 세션에 대해 "모두 승인" 모드를 활성화할 수 있습니다. </Note>

6단계: Claude Code와 Git 사용

Claude Code는 Git 작업을 대화형으로 만듭니다:

> what files have I changed?

> commit my changes with a descriptive message

더 복잡한 Git 작업도 요청할 수 있습니다:

> create a new branch called feature/quickstart

> show me the last 5 commits

> help me resolve merge conflicts

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

Claude는 디버깅과 기능 구현에 능숙합니다.

자연어로 원하는 것을 설명하세요:

> add input validation to the user registration form

또는 기존 문제를 수정하세요:

> there's a bug where users can submit empty forms - fix it

Claude Code는:

  • 관련 코드를 찾습니다
  • 컨텍스트를 이해합니다
  • 솔루션을 구현합니다
  • 사용 가능한 경우 테스트를 실행합니다

8단계: 다른 일반적인 워크플로우 테스트

Claude와 작업하는 여러 가지 방법이 있습니다:

코드 리팩토링

> refactor the authentication module to use async/await instead of callbacks

테스트 작성

> write unit tests for the calculator functions

문서 업데이트

> update the README with installation instructions

코드 리뷰

> review my changes and suggest improvements

 기억하세요: Claude Code는 당신의 AI 페어 프로그래머입니다. 도움이 되는 동료에게 말하듯이 대화하세요 - 달성하고자 하는 것을 설명하면 목표에 도달할 수 있도록 도와줄 것입니다. 

기억하세요2: claude.ai 또는 desktop을 이용하여 클로드 코드로 만들 프로그램의 전략을 먼저 수립하세요. 전략을 충분히 최적화 후 이를 .md 파일로 다운 받아, project folder에 저장하고 이를 기반으로 프로그램을 작성할 것을 제안하세요. 

 ** 코드가 완성되면 완성되면 직접 실행해서 문제점을 수정하라고 하세요 ** 로그를 작성하라고 하여 어느 부분에서 문제점이 있는지 파악하기 용이하게 하세요 

** 수정과 변경을 반복하다보면, 다르게 개발이 진행될 수 있으므로, .md 파일에 맞게 수정할 수 있게 체크 하세요 

** .md 파일에 포트, API 번호, 데이터베이스 위치와 어떤 데이터베이스를 이용할 것인지 등 기본 적인 내용을 넣어 이를 이용하게 해주세요 

** 가상 데이터를 만들지 못하게 해주세요. 진행 시 테스트를 위해 가상 데이터를 만들어 사용하려고 합니다. 이를 하지 못하게 하세요. 

claude --dangerously-skip-permissions

위의 명령어를 기억해주세요 ^^

필수 명령어

일상적인 사용을 위한 가장 중요한 명령어들입니다:

명령어기능예시
claude대화형 모드 시작claude
claude "task"일회성 작업 실행claude "fix the build error"
claude -p "query"일회성 쿼리 실행 후 종료claude -p "explain this function"
claude -c가장 최근 대화 계속claude -c
claude -r이전 대화 재개claude -r
claude commitGit 커밋 생성claude commit
/clear대화 기록 지우기> /clear
/help사용 가능한 명령어 표시> /help
exit 또는 Ctrl+CClaude Code 종료> exit

전체 명령어 목록은 CLI 참조를 참조하세요.

초보자를 위한 프로 팁

<AccordionGroup> <Accordion title="요청을 구체적으로 하세요"> 대신에: "fix the bug"

시도해보세요: "fix the login bug where users see a blank screen after entering wrong credentials"

</Accordion>

<Accordion title="단계별 지침 사용"> 복잡한 작업을 단계로 나누세요:

```
> 1. create a new database table for user profiles
```

```
> 2. create an API endpoint to get and update user profiles
```

```
> 3. build a webpage that allows users to see and edit their information
```

</Accordion>

<Accordion title="Claude가 먼저 탐색하도록 하세요"> 변경하기 전에 Claude가 코드를 이해하도록 하세요:

```
> analyze the database schema
```

```
> build a dashboard showing products that are most frequently returned by our UK customers
```

</Accordion>

<Accordion title="단축키로 시간 절약"> * 명령어 완성을 위해 Tab 사용 * 명령어 기록을 위해 ↑ 누르기 * 모든 슬래시 명령어를 보려면 / 입력 </Accordion> </AccordionGroup>

도움 받기

  • Claude Code 내에서: /help를 입력하거나 "how do I..."라고 질문하세요
  • 문서: 여기 있습니다! 다른 가이드를 둘러보세요
  • 커뮤니티: 팁과 지원을 위해 Discord에 참여하세요

댓글

댓글 쓰기

이 블로그의 인기 게시물

Claude AI의 생명과학 적용: 최신 자료 종합 리뷰

Claude AI의 생명과학 적용: 최신 자료 종합 리뷰 📌 개요 Anthropic은 2025년 10월 20일 "Claude for Life Sciences"를 공식 출시하며 생명과학 분야에 본격 진출했습니다. 이는 생명과학 연구 전 과정을 지원하는 특화된 AI 플랫폼으로, 약물 발견부터 규제 제출까지 과학적 발견 프로세스 전체를 가속화하는 것을 목표로 합니다. 1️⃣ Claude AI의 생명과학 적용 방법 1.1 기술적 성능 향상 Claude Sonnet 4.5는 Protocol QA 벤치마크에서 0.83점을 기록해 인간 기준선 0.79를 초과했으며, 이는 실험실 프로토콜 이해 능력이 인간 수준을 넘어섰음을 의미합니다. BixBench 평가에서도 생물정보학 작업에서 이전 모델 대비 상당한 개선을 보였습니다. 1.2 과학 도구 통합 (MCP Connectors) Claude for Life Sciences의 핵심은 Model Context Protocol (MCP) 기반 커넥터를 통한 실험실 도구와의 직접 통합입니다: 통합된 플랫폼: Benchling : 실험 노트북, 실험 기록에 대한 소스 링크 제공 PubMed : 수백만 개의 생물의학 연구 논문 접근 10x Genomics : 자연어로 단일 세포 및 공간 분석 수행 Scholar Gateway (Wiley) : 권위 있는 동료 검토 과학 콘텐츠 접근 Synapse.org : 공개/비공개 프로젝트에서 데이터 공유 및 분석 BioRender : 검증된 과학 그림, 아이콘, 템플릿 라이브러리 또한 Databricks와 Snowflake와도 연동되어 대규모 생물정보학 연구 분석과 자연어 쿼리를 통한 대용량 데이터셋 검색이 가능합니다. 1.3 Agent Skills 기능 Skills는 Claude가 특정 프로토콜과 절차를 일관되고 예측 가능하게 따를 수 있도록 하는 지침, 스크립트, 리소스를 포함한 폴더입니다. 첫 번째 공식 Skill: single-ce...
자세한 내용 보기

Claude Code를 사용할 때 유용한 명령어와 팁

C laude Code를 사용할 때 가장   유용한 명령어와 팁 은 다음과 같습니다.[1][2][3][5] 필수 명령어 모음 /init : 프로젝트 설정 초기화, CLAUDE.md 파일 자동 생성.[5] /clear : 대화 내역 초기화, 성능 최적화와 컨텍스트 정리에 효과적.[3][1] /model : AI 모델 변경, Sonnet ↔ Opus 전환 지원.[2][5] /permissions : 파일/폴더 수정 권한 및 허가 자동화.[5] /claude-md : 프로젝트 메모리 파일 생성 및 컨텍스트 공유.[5] /status : 현재 상태(버전, 모델, 계정 등) 확인.[5] /cost : 토큰 사용량 확인, 비용 관리에 유용.[5] claude --continue 또는 claude -c : 이전 세션에서 중단한 작업을 재개.[7][3] claude --help 또는 /help : 사용 중인 환경의 명령어 및 키 바인딩 정보 확인.[10] /exit 또는 Ctrl + C 두번 : 세션 종료.[2][7] 작업 및 컨텍스트 관리 팁 @파일명 : 프롬프트에서 @ 뒤에 파일명을 입력하면 해당 파일을 참조 가능.[1][2] #태그: 작업 내역을 기록할 때 # 사용.[1] 클립보드 이미지 삽입 : Ctrl + V (스크린샷 등 이미지도 첨부 가능).[2][1] 줄바꿈 : Ctrl + J (또는 /terminal-setup으로 불편함 해결).[2] Shift + Tab : 작업 모드 변경(일반/자동수락/계획).[7][2] Esc 키 : 작업 중단 또는 이전 세션 내용 보기.[7][2] 위 화살표 : 이전 대화 내용 탐색.[1][2] 고급 사용 팁 대화 시작 전에는  항상 /clear  명령어 사용해서 불필요한 컨텍스트 제거.[3][1] 맥락이 충분한 자연어 요청 으로 더 똑똑한 답변 유도 (예: “로그인 기능 구현”이 아닌 “JWT 기반 로그인 API를 Express + MongoDB로 구현해줘”).[5] IDE(터미널, VSCode 등)에서 플...
자세한 내용 보기