Installation & First Run - Claude Code 101

설치 방법

터미널 CLI, VS Code, JetBrains, 데스크톱 앱, 웹 — 5가지 방법 중 원하는 것을 선택하세요.

Installation

Terminal CLI, VS Code, JetBrains, Desktop App, or Web — choose from 5 installation methods.

🖥️ Terminal CLI

파일 편집, 명령 실행, 전체 프로젝트 관리를 명령줄에서 직접 수행하는 풀기능 CLI입니다.A full-featured CLI for editing files, running commands, and managing entire projects directly from the command line.

⭐ 네이티브 설치 (권장) — 자동 업데이트 지원Native Install (Recommended) — Auto-updates included

macOS Linux WSL

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

Windows PowerShell

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

Windows CMD

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

🔄

네이티브 설치는 백그라운드에서 자동 업데이트됩니다. 항상 최신 버전을 유지합니다. Windows에서는 먼저 Git for Windows를 설치하세요. The native installer updates automatically in the background, keeping you on the latest version at all times. On Windows, install Git for Windows first.

패키지 매니저로 설치 — 수동 업데이트 필요Install via Package Manager — Manual updates required

🍎

Homebrew (macOS / Linux)

Terminal
brew install --cask claude-code

# 수동 업데이트:
brew upgrade claude-code

Homebrew는 자동 업데이트를 지원하지 않습니다. 주기적으로 수동 업데이트하세요.Homebrew does not support automatic updates. Remember to update manually on a regular basis.

🪟

WinGet (Windows)

PowerShell
winget install Anthropic.ClaudeCode

# 수동 업데이트:Manual update:
winget upgrade Anthropic.ClaudeCode

WinGet도 자동 업데이트를 지원하지 않습니다. 주기적으로 수동 업데이트하세요.WinGet also does not support automatic updates. Remember to update manually on a regular basis.

📐 VS Code 확장 프로그램Extension

인라인 diff, @-멘션, 계획 검토, 대화 기록을 에디터 안에서 바로 사용할 수 있습니다. Cursor에서도 동작합니다.Use inline diffs, @-mentions, plan review, and conversation history directly inside your editor. Also works with Cursor.

방법 1: 링크로 바로 설치Option 1: Install via link

방법 2: 확장 프로그램 검색Option 2: Search Extensions

확장 프로그램 보기를 열고 (Cmd+Shift+X / Ctrl+Shift+X)
"Claude Code" 검색 후 설치 클릭.

설치 후 명령 팔레트 (Cmd+Shift+P) 에서 "Claude Code" 입력 → 새 탭에서 열기 선택.

Open the Extensions view (Cmd+Shift+X / Ctrl+Shift+X)
Search for "Claude Code" and click Install.

After installation, open the Command Palette (Cmd+Shift+P), type "Claude Code", and select Open in new tab.

⚙️ JetBrains 플러그인Plugin

IntelliJ IDEA, PyCharm, WebStorm 등 JetBrains IDE에서 대화형 diff 보기와 선택 컨텍스트 공유 기능을 사용할 수 있습니다.Use interactive diff views and selection-based context sharing in IntelliJ IDEA, PyCharm, WebStorm, and other JetBrains IDEs.

JetBrains Marketplace에서 설치Install from JetBrains Marketplace

JetBrains Marketplace에서 Claude Code Beta 플러그인을 설치하고 IDE를 재시작합니다.

또는 IDE에서 Settings → Plugins → Marketplace 탭에서 "Claude Code"를 검색하여 설치할 수도 있습니다.

Install the Claude Code Beta plugin from JetBrains Marketplace and restart your IDE.

Alternatively, search for "Claude Code" under Settings → Plugins → Marketplace from within your IDE.

IntelliJ IDEA PyCharm WebStorm 그 외 JetBrains IDEOther JetBrains IDEs

🖥️ 데스크톱 앱Desktop App

IDE나 터미널 없이도 Claude Code를 실행하는 독립 실행형 앱입니다. diff를 시각적으로 검토하고, 여러 세션을 나란히 실행할 수 있습니다.A standalone app that runs Claude Code without an IDE or terminal. Review diffs visually and run multiple sessions side by side.

🍎

macOS

Intel 및 Apple Silicon 지원Intel & Apple Silicon

다운로드Download

🪟

Windows

x64 지원x64 supported

다운로드Download

🪟

Windows ARM64

원격 세션 전용Remote sessions only

다운로드Download

💡

데스크톱 앱 사용 방법: 설치 후 Claude를 실행하고 로그인한 다음 Code 탭을 클릭하여 코딩을 시작합니다. 유료 구독이 필요합니다. How to use the Desktop App: After installation, launch Claude, sign in, then click the Code tab to start coding. A paid subscription is required.

🌐 웹 (설치 불필요!)Web (No installation needed!)

로컬 설치 없이 브라우저에서 바로 Claude Code를 사용할 수 있습니다. 데스크톱 브라우저와 Claude iOS 앱에서 사용 가능합니다.Use Claude Code directly in your browser without any local installation. Available on desktop browsers and the Claude iOS app.

claude.ai/code 열기Open claude.ai/code 로그인 후 바로 사용 가능Ready to use after sign-in

설치 불필요No installation 장시간 작업 지원Long-running tasks iOS 앱 연동iOS app support /teleport 로 터미널 이동to terminal

오래 실행되는 작업을 시작하고 완료되면 다시 확인할 수 있습니다. 로컬에 없는 리포지토리에서 작업하거나, 여러 작업을 병렬로 실행할 수 있습니다. /teleport 명령어로 웹 세션을 터미널로 가져올 수 있습니다. Start long-running tasks and check back when they finish. Work on repositories not stored locally or run multiple tasks in parallel. Use the /teleport command to bring a web session into your terminal.

로그인 & 인증

Claude Code를 사용하려면 인증이 필요합니다. 개인 사용자와 팀/기업 환경에 맞는 방법을 선택하세요.

Login & Authentication

Authentication is required to use Claude Code. Choose the method that fits your situation — individual user or team/enterprise environment.

개인 사용자Individual Users

⭐

Claude Pro / Max 플랜 (추천)

Claude의 Pro 또는 Max 플랜을 구독하면 웹과 CLI를 모두 포함하는 통합 구독을 받습니다. Claude.ai 계정으로 로그인합니다.

Claude Pro / Max Plan (Recommended)

Subscribing to Claude Pro or Max gives you an all-in-one subscription covering both the web interface and CLI. Sign in with your Claude.ai account.

구독 페이지Pricing page

🔑

Anthropic Console

Console을 통해 연결하고 OAuth 프로세스를 완료합니다. Anthropic Console에서 활성 청구가 필요합니다. "Claude Code" 워크스페이스가 자동 생성됩니다.Connect through the Console and complete the OAuth process. Active billing on Anthropic Console is required. A "Claude Code" workspace is created automatically.

Console 열기Open Console

팀 & 조직Teams & Organizations

👥

Claude for Teams / Enterprise (추천)

중앙 집중식 청구, 팀 관리, Claude Code와 웹 Claude에 대한 액세스를 제공합니다.

Claude for Teams / Enterprise (Recommended)

Provides centralized billing, team management, and access to both Claude Code and web Claude.

📄

Console 팀 청구

공유 Console 조직을 설정하고 팀 멤버를 초대합니다. 역할 할당으로 사용 추적이 가능합니다.

Console Team Billing

Set up a shared Console organization and invite team members. Usage tracking is available via role assignment.

☁️

클라우드 제공자

Amazon Bedrock, Google Vertex AI, Microsoft Foundry를 통해 기존 클라우드 인프라와 통합합니다.

Cloud Providers

Integrate with your existing cloud infrastructure via Amazon Bedrock, Google Vertex AI, or Microsoft Foundry.

첫 로그인 방법 (Terminal CLI)First Login (Terminal CLI)

claude 실행

터미널에서 claude를 입력하면 처음 사용 시 로그인 화면이 나옵니다.

Run claude

Type claude in your terminal. On first use, a login screen will appear.

Terminal
claude

브라우저에서 인증

자동으로 브라우저가 열리고, Claude.ai 계정으로 로그인하면 인증이 완료됩니다.

Authenticate in your browser

Your browser will open automatically. Sign in with your Claude.ai account to complete authentication.

완료!

터미널로 돌아오면 바로 사용할 수 있습니다. 인증 정보는 로컬에 안전하게 저장됩니다.

All done!

Return to your terminal and you're ready to go. Your credentials are stored securely on your local machine.

🎯

어떤 플랜을 선택할지 모르겠다면? Claude Pro 구독이 가장 간편합니다. API 키(Anthropic Console)는 사용량에 따라 비용이 달라지고, 클라우드 제공업체(Bedrock / Vertex)는 기업 환경에 적합합니다. 자세한 가격은 claude.com/pricing에서 확인하세요. Not sure which plan to pick? A Claude Pro subscription is the simplest choice. API keys (Anthropic Console) are billed by usage, and cloud providers (Bedrock / Vertex) are best suited for enterprise environments. See claude.com/pricing for details.

첫 대화 해보기

설치와 인증이 끝났으니, 이제 Claude Code와 첫 번째 대화를 해봅시다.

Your First Conversation

Installation and authentication are complete. Now let's have your first conversation with Claude Code.

프로젝트 폴더로 이동

Claude Code는 현재 폴더를 기준으로 동작합니다. 먼저 작업할 프로젝트 폴더로 이동하세요.

Navigate to your project folder

Claude Code operates relative to your current directory. First, navigate to the project you want to work on.

Terminal
# 기존 프로젝트로 이동하거나 새로 만들기Navigate to an existing project or create a new one
mkdir my-project
cd my-project

claude 실행

터미널에 claude만 입력하면 대화 모드가 시작됩니다.

Run claude

Type claude in your terminal to start conversation mode.

Terminal
claude

# Claude Code가 시작되면 이런 화면이 나옵니다:
╭────────────────────────────────────╮
│  Claude Code          v1.x.x      │
│  Type your message...              │
╰────────────────────────────────────╯

CLAUDE.md 초기화 (선택 사항)

프로젝트에 맞는 지침 파일을 만들어두면 Claude가 매 세션마다 참고합니다.

Initialize CLAUDE.md (optional)

Create a project-specific instructions file that Claude will reference at the start of every session.

Claude Code
/init
# CLAUDE.md 파일을 생성하여 프로젝트 지침을 설정합니다Creates a CLAUDE.md file with project instructions

/help
# 사용 가능한 모든 명령어 보기View all available commands

첫 번째 질문하기

아무거나 물어보세요! 예를 들어 간단한 HTML 페이지를 만들어달라고 해봅시다.

Ask your first question

Ask anything! For example, let's ask Claude to create a simple HTML page.

Claude Code
이 폴더에 간단한 HTML 페이지를 만들어줘

# Claude가 파일을 생성하겠다고 제안합니다
Claude: index.html 파일을 생성하겠습니다.
       [Allow] [Deny]

결과 확인

권한을 승인하면 Claude가 파일을 생성합니다. 폴더를 확인해보세요!

Check the result

Once you approve the permission prompt, Claude will create the file. Check your folder!

Terminal
# 생성된 파일 확인Check the created file
ls
index.html

# 브라우저에서 열어보기 (macOS)Open in browser (macOS)
open index.html

# 설치된 버전 확인Check installed version
claude --version

🚨

권한 승인이 나오면 Y를 누르세요. Claude Code는 파일을 생성하거나 수정하기 전에 항상 허락을 구합니다. 안전하다고 판단되면 Y(Allow)를 눌러 승인하세요. 원하지 않는 작업이면 N(Deny)을 누르면 됩니다. Press Y when a permission prompt appears. Claude Code always asks for approval before creating or modifying files. Press Y (Allow) if the action looks safe. Press N (Deny) if you want to cancel.

IDE & 앱 연동 정리

각 환경은 동일한 Claude Code 엔진에 연결되므로 CLAUDE.md 파일, 설정, MCP 서버가 모든 환경에서 작동합니다.

IDE & App Integration Summary

All environments connect to the same Claude Code engine, so your CLAUDE.md files, settings, and MCP servers work across all of them.

환경Environment	주요 특징Key Features	설치 방법How to Install
Terminal CLI	파일 편집, 명령 실행, git 통합, MCP, 자동화File editing, command execution, git integration, MCP, automation	`curl -fsSL https://claude.ai/install.sh \| bash`
VS Code	인라인 diff, @-멘션, 계획 검토, 대화 기록Inline diff, @-mentions, plan review, conversation history	Extensions에서 "Claude Code" 검색 또는 Search "Claude Code" in Extensions or 직접 설치install directly
Cursor	VS Code 확장 프로그램과 동일한 기능Same features as the VS Code extension	Cursor용 설치 링크Cursor install link
JetBrains	대화형 diff 보기, 선택 컨텍스트 공유Interactive diff view, selection-based context sharing	JetBrains Marketplace에서 "Claude Code Beta" — search "Claude Code Beta"
Desktop App	시각적 diff 검토, 여러 세션 병렬 실행, 클라우드 세션Visual diff review, multiple parallel sessions, cloud sessions	claude.ai에서 macOS / Windows 다운로드 — download for macOS / Windows
Web	설치 불필요, 장시간 작업, iOS 앱 연동No installation, long-running tasks, iOS app integration	claude.ai/code 방문 후 바로 사용 — use immediately after sign-in

💡

CLI 자체만으로도 충분합니다. IDE 연동은 선택사항입니다. 많은 개발자들이 터미널에서 claude만으로 모든 작업을 합니다. IDE 연동과 데스크톱 앱은 편의성을 높여줄 뿐, 필수가 아닙니다. The CLI alone is perfectly sufficient. IDE integrations are optional. Many developers do everything from the terminal with just claude. IDE integrations and the Desktop App add convenience, but are not required.

트러블슈팅 & FAQ

설치 중 문제가 생겼나요? 가장 흔한 문제와 해결 방법을 모았습니다.

Troubleshooting & FAQ

Running into trouble during installation? Here are the most common issues and how to fix them.

이 에러는 Claude Code가 시스템 PATH에 등록되지 않았을 때 발생합니다.

해결 방법:
1. 터미널을 완전히 닫고 다시 열어보세요.
2. claude doctor를 실행하여 설치 타입과 버전을 확인하세요.
3. 네이티브 설치의 경우 ~/.local/bin이 PATH에 포함되어 있는지 확인하세요.
4. Homebrew로 설치했다면 brew link --cask claude-code를 시도해보세요.
5. Windows에서 Git Bash 경로를 지정하려면: $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

This error occurs when Claude Code is not registered in the system PATH.

How to fix:
1. Fully close your terminal and reopen it.
2. Run claude doctor to check the installation type and version.
3. For native installs, verify that ~/.local/bin is included in your PATH.
4. If you installed via Homebrew, try brew link --cask claude-code.
5. On Windows, to specify the Git Bash path: $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

로그인 문제는 대부분 브라우저 또는 네트워크 설정과 관련이 있습니다.

확인 사항:
1. 기본 브라우저가 정상적으로 열리는지 확인하세요.
2. Claude.ai에 유효한 구독(Pro / Max / Team / Enterprise) 또는 Anthropic Console 계정이 있는지 확인하세요.
3. VPN이나 프록시를 사용 중이라면 일시적으로 끄고 시도해보세요.
4. claude logout 후 claude를 다시 실행하여 재인증을 시도하세요.

Login issues are most commonly related to browser or network settings.

Things to check:
1. Make sure your default browser opens normally.
2. Verify that you have a valid subscription (Pro / Max / Team / Enterprise) or an Anthropic Console account on Claude.ai.
3. If you are using a VPN or proxy, try disabling it temporarily.
4. Run claude logout, then run claude again to re-authenticate.

Claude Code를 사용하려면 다음 중 하나가 필요합니다:

· Claude Pro — 개인 사용자에게 추천. 충분한 사용량이 제공됩니다.
· Claude Max — 더 높은 사용량이 필요한 개인 사용자용.
· Claude Team — 팀 협업이 필요할 때.
· Claude Enterprise — 대규모 조직용. 관리 기능 포함.
· Anthropic Console — 사용량 기반 API 과금. 구독 없이도 사용 가능.

무료 플랜으로는 Claude Code를 사용할 수 없습니다. 자세한 가격은 claude.com/pricing을 확인하세요.

To use Claude Code, you need one of the following:

· Claude Pro — Recommended for individual users. Comes with generous usage.
· Claude Max — For individuals who need higher usage limits.
· Claude Team — For teams that need to collaborate.
· Claude Enterprise — For large organizations. Includes admin features.
· Anthropic Console — Pay-as-you-go API billing. Works without a subscription.

The free plan does not include Claude Code access. See claude.com/pricing for full pricing details.

네이티브 설치는 기본적으로 자동 업데이트됩니다. 다음 방법으로 비활성화하거나 채널을 변경할 수 있습니다.

자동 업데이트 비활성화:
export DISABLE_AUTOUPDATER=1

릴리스 채널 변경 (stable 채널 권장 - 약 1주 지연):
settings.json에 추가: { "autoUpdatesChannel": "stable" }

또는 /config → 자동 업데이트 채널에서 변경합니다.

수동 업데이트:
claude update

The native installer enables automatic updates by default. You can disable them or change the channel as follows.

Disable automatic updates:
export DISABLE_AUTOUPDATER=1

Change release channel (stable recommended — ~1 week delay):
Add to settings.json: { "autoUpdatesChannel": "stable" }

Or go to /config → Auto-update channel.

Manual update:
claude update

네, 가능합니다. 다만 몇 가지 설정이 필요할 수 있습니다.

· Claude Code는 api.anthropic.com에 HTTPS(443 포트)로 통신합니다. 이 도메인을 허용 목록에 추가하세요.
· 프록시 환경이라면 HTTPS_PROXY 환경변수를 설정하세요.
· AWS Bedrock이나 GCP Vertex를 사용하면 회사 내부 네트워크만으로도 사용 가능합니다.
· 인증 시 브라우저 접근이 필요하므로, 최초 인증은 외부 네트워크에서 하고 이후에는 토큰이 로컬에 저장됩니다.

Yes, it is possible, though some configuration may be required.

· Claude Code communicates with api.anthropic.com over HTTPS (port 443). Add this domain to your allowlist.
· If you are in a proxy environment, set the HTTPS_PROXY environment variable.
· Using AWS Bedrock or GCP Vertex allows operation entirely within your corporate network.
· Initial authentication requires browser access to the internet, but the token is stored locally afterward.

설치 방법에 따라 제거 방법이 다릅니다:

네이티브 설치 (macOS / Linux / WSL):
rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude

네이티브 설치 (Windows PowerShell):
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force

macOS (Homebrew):
brew uninstall --cask claude-code

Windows (WinGet):
winget uninstall Anthropic.ClaudeCode

npm (레거시):
npm uninstall -g @anthropic-ai/claude-code

설정 파일까지 삭제하려면: rm -rf ~/.claude ~/.claude.json (모든 설정, MCP, 기록이 삭제됩니다)

The uninstall method depends on how you installed Claude Code:

Native install (macOS / Linux / WSL):
rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude

Native install (Windows PowerShell):
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force

macOS (Homebrew):
brew uninstall --cask claude-code

Windows (WinGet):
winget uninstall Anthropic.ClaudeCode

npm (legacy):
npm uninstall -g @anthropic-ai/claude-code

To also delete config files: rm -rf ~/.claude ~/.claude.json (removes all settings, MCP configs, and history)

설치 & 첫 실행 Installing Claude Code

시스템 요구사항

System Requirements

운영체제

Operating System

필수 조건

Prerequisites

설치 방법

Installation

🖥️ Terminal CLI

⭐ 네이티브 설치 (권장) — 자동 업데이트 지원Native Install (Recommended) — Auto-updates included

패키지 매니저로 설치 — 수동 업데이트 필요Install via Package Manager — Manual updates required

Homebrew (macOS / Linux)

WinGet (Windows)

📐 VS Code 확장 프로그램Extension

방법 1: 링크로 바로 설치Option 1: Install via link

방법 2: 확장 프로그램 검색Option 2: Search Extensions

⚙️ JetBrains 플러그인Plugin

JetBrains Marketplace에서 설치Install from JetBrains Marketplace

🖥️ 데스크톱 앱Desktop App

macOS

Windows

Windows ARM64

🌐 웹 (설치 불필요!)Web (No installation needed!)

로그인 & 인증

Login & Authentication

개인 사용자Individual Users

Claude Pro / Max 플랜 (추천)

Claude Pro / Max Plan (Recommended)

Anthropic Console

팀 & 조직Teams & Organizations

Claude for Teams / Enterprise (추천)

Claude for Teams / Enterprise (Recommended)

Console 팀 청구

Console Team Billing

클라우드 제공자

Cloud Providers

첫 로그인 방법 (Terminal CLI)First Login (Terminal CLI)

claude 실행

Run claude

브라우저에서 인증

Authenticate in your browser

완료!

All done!

첫 대화 해보기

Your First Conversation

프로젝트 폴더로 이동

Navigate to your project folder

claude 실행

Run claude

CLAUDE.md 초기화 (선택 사항)

Initialize CLAUDE.md (optional)

첫 번째 질문하기

Ask your first question

결과 확인

Check the result

IDE & 앱 연동 정리

IDE & App Integration Summary

트러블슈팅 & FAQ

Troubleshooting & FAQ

축하합니다! 설치 완료

Congratulations! Installation complete

설치 & 첫 실행

Installing Claude Code