Claude Code 사용 가이드 > 프로젝트 가이드 | AI 창작자를 위한 바이브 코딩 커뮤니티

소개: Claude Code란?

Claude Code는 Anthropic의 강력한 AI 모델을 활용하여 개발자의 터미널 및 IDE(통합 개발 환경)에 직접 통합될 수 있도록 설계된 도구입니다. 코딩 워크플로우를 간소화하고, 생산성을 향상시키며, 개발자가 코드 작성, 디버깅, 이해, 테스트 등 다양한 작업을 보다 효율적으로 수행할 수 있도록 돕습니다.

이 가이드는 Claude Code를 설정하고 기본적인 사용 방법을 익히는 데 필요한 정보를 제공합니다. 이를 통해 Claude의 코딩 능력을 여러분의 개발 환경에 바로 적용할 수 있습니다.

1. 설치 및 초기 설정

1.1. Claude Code 설치하기

Claude Code는 npm을 통해 쉽게 설치할 수 있습니다. 터미널을 열고 다음 명령어를 실행해주세요:

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

이 명령어는 Claude Code를 전역으로 설치하여 어느 디렉토리에서든 `claude` 명령어를 사용할 수 있게 합니다.

1.2. Claude Code 인증

설치 후, Claude Code를 Anthropic 계정과 연결해야 합니다. 다음 명령어를 실행하면 인증 절차가 시작됩니다:

claude

명령어를 실행하면 웹 브라우저가 열리면서 Anthropic 로그인 페이지로 이동합니다. 로그인하거나 계정을 생성한 후, Claude Code에 권한을 부여하면 터미널로 돌아와 성공적으로 인증되었음을 확인할 수 있습니다.

1.3. 모델 선택 (선택 사항)

기본적으로 Claude Code는 적절한 모델을 자동으로 선택하지만, 필요에 따라 특정 모델을 지정할 수 있습니다. 예를 들어, 가장 강력한 코딩 능력을 위해 Claude Opus를 사용하려면 다음 명령어를 입력하세요:

/model claude-opus-20240229

또는 사용 가능한 모델 목록을 확인하려면:

/model

을 입력하면 됩니다. (모델명은 업데이트될 수 있으니 최신 문서를 참조하는 것이 좋습니다.)

2. Claude Code 기본 사용법

Claude Code는 터미널 내에서 대화형으로 작동합니다. `claude` 명령어를 실행하면 AI와 대화를 시작할 수 있습니다.

2.1. 코드 요청하기

특정 코드 스니펫이나 함수의 구현을 요청할 수 있습니다. 예를 들어, 피보나치 수열을 계산하는 파이썬 함수를 요청하려면 다음과 같이 입력합니다:

claude
> Python으로 피보나치 수열을 계산하는 함수를 작성해 줘.

Claude Code는 요청에 따라 코드를 생성하여 보여줄 것입니다.

2.2. 파일과 상호작용

Claude Code는 로컬 파일 시스템에 접근하여 파일을 읽고, 수정하고, 생성할 수 있습니다. 이는 복잡한 코딩 작업에 매우 유용합니다.

파일 내용 읽기:특정 파일의 내용을 AI에게 보여주어 분석하거나 수정하도록 지시할 수 있습니다.
```
/read [파일명]
```
예시:
```
/read src/main.js
```
파일 수정 제안 및 적용:AI가 제안하는 코드 변경 사항을 파일에 직접 적용할 수 있습니다. Claude Code는 변경될 내용을 명확히 보여주고 확인을 요청합니다.
```
claude
> src/utils.js 파일에서 `calculateSum` 함수를 최적화해 줘.
```
AI가 변경 사항을 제안하면, `y` 또는 `yes`를 입력하여 적용하거나, `n` 또는 `no`를 입력하여 거부할 수 있습니다.

새 파일 생성:새로운 파일을 만들고 내용을 채우도록 지시할 수 있습니다.

claude
> `test/user_test.py` 파일을 생성하고 `User` 클래스의 간단한 단위 테스트 코드를 작성해 줘.

2.3. 터미널 명령 실행

Claude Code는 직접 터미널 명령을 실행하고 그 결과를 해석할 수 있습니다. 이는 디버깅이나 빌드 과정에서 유용합니다.

/run [명령어]

예시:

/run npm test
/run git status

명령어 실행 후, AI는 출력 결과를 분석하고 다음 단계를 제안하거나 문제 해결을 도울 수 있습니다.

2.4. 대화 종료

Claude Code와의 대화를 종료하려면 `exit` 또는 `quit`를 입력합니다.

/exit

3. 통합 개발 환경(IDE) 확장

Claude Code는 Visual Studio Code, JetBrains IDEs(IntelliJ IDEA, PyCharm 등)와 같은 인기 있는 IDE를 위한 확장 프로그램으로도 제공됩니다. IDE 확장을 사용하면 터미널을 오가지 않고도 개발 환경 내에서 직접 AI의 도움을 받을 수 있습니다.

VS Code 확장: VS Code 마켓플레이스에서 "Claude Code"를 검색하여 설치합니다. 설치 후 사이드바에 Claude Code 아이콘이 나타납니다.
JetBrains 플러그인: JetBrains IDEs의 플러그인 마켓플레이스에서 "Claude Code"를 검색하여 설치합니다.

IDE 확장은 다음과 같은 기능을 제공합니다:

코드 자동 완성 및 제안
선택된 코드 블록에 대한 설명 또는 리팩토링
파일 탐색기에서 직접 파일 수정 요청
통합된 채팅 인터페이스

참고: IDE 확장의 구체적인 기능과 사용법은 각 IDE의 환경에 따라 약간 다를 수 있으므로, 해당 확장 프로그램의 문서를 참조하는 것이 좋습니다.

4. 추가 팁 및 활용

명확한 프롬프트: AI에게 명확하고 구체적인 지시를 내릴수록 더 정확하고 유용한 결과를 얻을 수 있습니다. 원하는 코드의 언어, 목적, 예시 등을 상세히 설명해 주세요.
문제 디버깅: 오류 메시지, 관련 코드, 예상되는 동작 등을 Claude Code에 제공하여 버그 진단 및 해결책을 요청할 수 있습니다.
코드 리뷰: 작성한 코드에 대한 피드백, 개선 사항, 잠재적 오류 등을 AI에게 검토 요청할 수 있습니다.
새로운 기술 학습: 특정 프레임워크나 라이브러리 사용법에 대해 질문하고, 관련 코드 예시를 요청하여 학습에 활용할 수 있습니다.