시작하기 전에
다음을 확인하십시오:- 열려 있는 터미널 또는 명령 프롬프트
- 작업할 코드 프로젝트
- Claude 구독 (Pro, Max, Team 또는 Enterprise), Claude Console 계정 또는 지원되는 클라우드 제공자를 통한 액세스
다음 경우는 다른 페이지에서 다룹니다:
- 터미널을 처음 사용하는 경우: 터미널 가이드부터 시작하십시오
- 터미널이 아닌 다른 곳에서 Claude Code를 사용하려는 경우: Claude Code는 웹, 데스크톱 앱, VS Code 및 JetBrains IDE, Slack, GitHub Actions 및 GitLab의 CI/CD에서도 사용할 수 있습니다. 모든 인터페이스를 참조하십시오.
단계 1: Claude Code 설치
Claude Code를 설치하려면 터미널을 열고 시스템에 맞는 명령을 실행하십시오. 이전에 터미널을 사용해본 적이 없다면 터미널 가이드에서 터미널을 열고 명령을 붙여넣는 방법을 확인할 수 있습니다.- 기본 설치 (권장)
- Homebrew
- WinGet
macOS, Linux, WSL:Windows에서 PowerShell에 있을 때는 프롬프트에 Windows CMD:설치 명령은 Claude Code를 다운로드하는 동안 진행 상황을 표시하지 않습니다. 설치 프로그램이 완료되면 새 터미널 창을 열고
PS C:\가 표시되고, CMD에 있을 때는 PS 없이 C:\만 표시됩니다.Windows PowerShell:claude --version을 실행하십시오. 설치가 제대로 되었으면 버전 번호가 출력됩니다. 셸에서 claude를 찾을 수 없거나 인식되지 않는다고 표시되면 설치 디렉토리가 아직 PATH에 없는 것입니다. PATH 수정을 참조하십시오.The token '&&' is not a valid statement separator 오류가 표시되면 CMD가 아닌 PowerShell에 있는 것입니다. 'irm' is not recognized as an internal or external command 오류가 표시되면 PowerShell이 아닌 CMD에 있는 것입니다.설치 명령이 syntax error near unexpected token '<', 403 또는 다른 오류로 실패하면 설치 문제 해결을 참조하여 오류를 수정 방법과 일치시키고 대체 설치 방법을 확인하십시오.Git for Windows는 Claude Code가 Bash 도구를 사용할 수 있도록 기본 Windows에서 권장됩니다. Git for Windows가 설치되지 않은 경우 Claude Code는 대신 PowerShell을 셸 도구로 사용합니다. WSL 설정에는 Git for Windows가 필요하지 않습니다.기본 설치는 최신 버전으로 유지하기 위해 백그라운드에서 자동으로 업데이트됩니다.
(Claude Code)를 출력합니다.
2단계: 첫 번째 세션 시작하기
아무 프로젝트 디렉터리에서 터미널을 열고 Claude Code를 시작합니다:/path/to/your/project를 작업하려는 프로젝트의 경로로 바꿉니다.
Claude Code는 처음 사용할 때 로그인을 요청합니다. Claude 구독 또는 Console 계정의 경우 안내에 따라 브라우저에서 인증을 완료합니다. ANTHROPIC_API_KEY 환경 변수를 설정했고 Claude Code가 해당 키를 사용할지 물을 때 승인하면 Claude Code는 로그인 프롬프트를 건너뜁니다.
다음 계정 유형 중 하나로 로그인할 수 있습니다:
- Claude Pro, Max, Team 또는 Enterprise(권장)
- Claude Console(선불 크레딧을 사용하는 API 액세스). 처음 로그인하면 중앙 집중식 비용 추적을 위해 Console에 “Claude Code” 워크스페이스가 자동으로 생성됩니다.
- Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry(엔터프라이즈 클라우드 제공업체)
- 조직에서 운영하는 경우 자체 호스팅 Claude apps gateway: 관리자가 게이트웨이 URL을 미리 구성하며,
/login을 실행하면 바로 Cloud gateway 화면이 열려 회사 SSO로 로그인할 수 있습니다
/help를, 이전 대화를 이어가려면 /resume을 입력합니다. 나중에 계정을 전환하거나 다시 인증하려면 실행 중인 세션 안에서 /login을 입력합니다.
3단계: 첫 번째 질문하기
다음 명령 중 하나를 시도해 보세요:Claude Code는 필요에 따라 프로젝트 파일을 읽습니다. 컨텍스트를 수동으로 추가할 필요가 없습니다.
4단계: 첫 번째 코드 변경하기
간단한 작업을 시도해 보세요:Shift+Tab을 눌러 현재 세션의 권한 모드를 전환할 수 있습니다.
5단계: Claude Code로 Git 사용하기
Claude Code를 사용하면 대화하듯이 Git 작업을 수행할 수 있습니다:6단계: 버그 수정 또는 기능 추가
원하는 작업을 자연어로 설명합니다:7단계: 다른 일반적인 워크플로 테스트하기
몇 가지 프롬프트를 더 시도해 보세요. Claude에게 코드 리팩터링, 테스트 작성, 문서 업데이트, 변경 사항 리뷰를 요청할 수 있습니다.필수 명령
일상적인 사용을 위한 가장 중요한 명령을 실행 위치별로 분류하면 다음과 같습니다.셸 명령
Claude Code를 시작하거나 재개하려면 터미널에서 다음 명령을 실행합니다.
전체 셸 명령 목록은 CLI 참조를 참조하십시오.
세션 명령
Claude Code가 시작된 후 내부에서 다음 명령을 실행합니다.
전체 세션 명령 목록은 명령 참조를 참조하십시오.
초보자를 위한 팁
자세한 내용은 모범 사례 및 일반적인 워크플로우를 참조하십시오.요청을 구체적으로 하기
요청을 구체적으로 하기
대신: “버그 수정”시도: “사용자가 잘못된 자격 증명을 입력한 후 빈 화면을 보는 로그인 버그 수정”
단계별 지침 사용
단계별 지침 사용
복잡한 작업을 단계로 나누기:
Claude가 먼저 탐색하도록 하기
Claude가 먼저 탐색하도록 하기
변경하기 전에 Claude가 코드를 이해하도록 하기:
바로가기로 시간 절약
바로가기로 시간 절약
/를 입력하여 모든 명령 및 skills 보기- Tab을 사용하여 명령 완성
- ↑를 눌러 명령 기록 보기
Shift+Tab을 눌러 권한 모드 순환
다음 단계
이제 기본 사항을 배웠으므로 더 고급 기능을 살펴보십시오:- Claude Code 작동 방식: 에이전틱 루프, 기본 제공 도구 및 Claude Code가 프로젝트와 상호 작용하는 방식 이해
- 모범 사례: 효과적인 프롬프팅 및 프로젝트 설정으로 더 나은 결과 얻기
- 일반적인 워크플로: 일반적인 작업에 대한 단계별 가이드
- Claude Code 확장: CLAUDE.md, 스킬, 훅, MCP 등으로 사용자 정의
도움 받기
- Claude Code에서:
/help를 입력하거나 “어떻게…”를 물어보기 - 문서: 이 사이트의 다른 가이드 찾아보기
- 강좌: Claude Code 101을 수강하고 Claude Academy에서 다른 무료 자습형 강좌를 수강하기
- 커뮤니티: 팁과 지원을 위해 Discord 서버에 참여하기