Claude Code 개요: 터미널·데스크톱·웹

한눈에 요약

Claude Code는 코드베이스를 읽고, 파일을 수정하고, 명령을 실행하고, 개발 도구와 연동하는 에이전트형 코딩 도구예요.
터미널(CLI), IDE(VS Code·JetBrains), 데스크톱 앱의 Code 탭, 웹(claude.ai/code)에서 쓸 수 있어요. 모두 같은 엔진이라 CLAUDE.md, 설정, MCP 서버가 공통으로 동작해요.
설치는 한 줄이에요. macOS/Linux/WSL은 curl -fsSL https://claude.ai/install.sh | bash, Windows PowerShell은 irm https://claude.ai/install.ps1 | iex예요.
설치 후 프로젝트 폴더에서 claude를 실행하고 로그인한 다음 자연어로 요청하면 돼요.
Pro 이상 유료 플랜에서 쓸 수 있고 Free는 안 돼요(2026-10-10 기준).

이 튜토리얼로 할 수 있게 되는 것

터미널, IDE, 데스크톱 앱, 웹 중 내 상황에 맞는 곳을 고를 수 있어요.
Claude Code를 설치하고 로그인해서 내 프로젝트에서 첫 대화를 시작할 수 있어요.
질문하기, 작은 코드 수정, Git 작업까지 첫 작업을 해 볼 수 있어요.
표면 사이를 오가는 방법과 반복 작업 자동화 방법을 알고, 다음 단계(C13·C14)로 넘어갈 수 있어요.

먼저 알아둘 개념

용어	뜻
Claude Code	코드를 읽고 고치고 실행까지 하는 에이전트형 코딩 도구예요.
표면(surface)	Claude Code를 쓰는 환경이에요. 터미널, IDE, 데스크톱, 웹이 있어요.
CLAUDE.md	프로젝트 지침 파일이에요. 모든 표면에서 공통으로 쓰여요. 자세한 내용은 C14에서 다뤄요.
세션(session)	하나의 대화와 작업 흐름이에요. 이어서 하거나 다른 표면으로 옮길 수 있어요.
권한 모드	Claude가 승인 없이 할 수 있는 동작 범위를 정하는 설정이에요. 세션 중 `Shift+Tab`으로 바꿔요.

어디서 쓸까요?

표면	이런 사람에게	특징
터미널(CLI)	터미널이 편하고 모든 기능을 쓰고 싶을 때	가장 기본 형태예요. 서드파티 제공자(Bedrock 등)도 지원해요.
VS Code (Cursor 포함)	편집기 안에서 쓰고 싶을 때	확장 `anthropic.claude-code`를 설치해요.
JetBrains	JetBrains IDE를 쓸 때	플러그인을 쓰며 CLI를 별도로 설치해야 해요.
데스크톱 앱 (Code 탭)	터미널이 낯설고 변경 내용을 시각적으로 검토하고 싶을 때	CLI를 따로 설치하지 않아도 돼요. 유료 구독이 필요해요.
웹 (claude.ai/code)	설치 없이 바로, 또는 휴대폰에서 쓰고 싶을 때	데스크톱 브라우저와 iOS/Android Claude 앱에서 가능해요. 자세한 내용은 C13에서 다뤄요.

대부분의 표면은 Claude 구독 또는 Anthropic Console 계정이 필요해요. 터미널, VS Code, JetBrains는 서드파티 제공자도 지원해요.

단계별 따라하기

여기서는 가장 기본인 터미널 방식으로 따라가요. 데스크톱 앱을 쓴다면 4번 단계 뒤의 안내를 보세요.

0/6 완료

내 OS에 맞는 설치 명령을 실행했어요
새 터미널에서 claude --version으로 설치를 확인했어요
프로젝트 폴더에서 claude를 실행하고 로그인했어요
프로젝트에 대해 첫 질문을 했어요
작은 코드 수정을 요청하고 승인했어요
(선택) Git 작업을 요청해 봤어요

설치하기

터미널을 열고 내 환경에 맞는 명령을 실행해요(권장 방식인 네이티브 설치).

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
```
설치하는 동안 진행 표시가 나오지 않을 수 있어요. 네이티브 설치는 백그라운드에서 자동으로 업데이트돼요. 네이티브 Windows에서는 Git for Windows 설치를 권장해요. 없으면 PowerShell을 셸 도구로 써요.

이 단계에서 보게 될 화면
터미널에서 설치 명령을 실행한 화면
공식 도움말에서 이 화면 보기 ↗
실제 화면은 서비스 업데이트에 따라 다를 수 있어요
설치 확인하기

설치가 끝나면 새 터미널 창을 열고 확인해요.
터미널 창
```
claude --version
```
버전 번호가 나오면 성공이에요. claude를 찾을 수 없다고 나오면 PATH 문제일 가능성이 커요. 공식 설치 문제 해결 문서의 안내를 따르세요. PowerShell과 CMD를 헷갈린 경우에도 비슷한 오류가 나요.
프로젝트에서 시작하고 로그인하기

작업할 프로젝트 폴더로 이동해서 claude를 실행해요.
터미널 창
```
cd /path/to/your/project
claude
```
처음에는 로그인 안내가 나와요. 브라우저에서 인증을 마치면 돼요. 한 번 로그인하면 다시 하지 않아도 돼요. 로그인 후에는 버전, 현재 모델, 작업 폴더가 프롬프트 위에 표시돼요. /help로 명령어 목록을, /resume으로 이전 대화를 이어갈 수 있어요.

이 단계에서 보게 될 화면
처음 claude를 실행했을 때의 로그인 안내와 프롬프트 화면
공식 도움말에서 이 화면 보기 ↗
실제 화면은 서비스 업데이트에 따라 다를 수 있어요
첫 질문 하기

먼저 코드를 건드리지 않는 질문으로 시작해요. Claude는 필요한 파일을 알아서 읽어요.

이 프롬프트를 복사해서 붙여넣으세요
이 프로젝트가 무엇을 하는지 설명해 줘. 사용한 기술, 폴더 구조, 시작점이 되는 파일도 알려 줘.

프로젝트용 지침 파일은 /init 명령으로 CLAUDE.md를 만들 수 있어요. 자세한 내용은 C14에서 다뤄요.

데스크톱 앱을 쓴다면: 앱(macOS Intel/Apple Silicon, Windows x64/ARM64)을 설치하고 로그인한 뒤 Code 탭을 눌러 시작해요. 앱에 Claude Code가 포함되어 있어서 CLI를 따로 설치할 필요가 없어요. 터미널 세션을 앱으로 옮기고 싶다면 /desktop을 써요.
작은 코드 수정 요청하기

이 프롬프트를 복사해서 붙여넣으세요
메인 파일에 hello world를 출력하는 함수를 하나 추가해 줘. 바꾸기 전에 어떤 파일을 어떻게 고칠지 먼저 보여 줘.

Claude가 변경 내용을 보여 주고 승인을 물으면 내용을 읽은 뒤 Yes를 선택해요. 승인 없이 할 수 있는 범위는 권한 모드가 정해요. Shift+Tab을 누르면 세션의 권한 모드를 바꿀 수 있어요. 처음에는 기본값으로 쓰면서 무엇을 승인하는지 눈으로 확인하세요.
Git 작업도 대화로 하기

이 프롬프트를 복사해서 붙여넣으세요
내가 바꾼 파일이 뭐야? 변경 내용을 보고 적절한 커밋 메시지를 붙여서 커밋해 줘.

이어서 “최근 커밋 5개 보여 줘”, “feature/quickstart 브랜치를 만들어 줘” 같은 요청도 할 수 있어요. 커밋·푸시처럼 되돌리기 번거로운 작업은 승인 화면에서 한 번 더 확인하세요.

빠른 참조표

설치 방법 (2026-10-10 기준)

방법	명령	자동 업데이트
네이티브 (권장) macOS/Linux/WSL	`curl -fsSL https://claude.ai/install.sh \| bash`	됨
네이티브 Windows PowerShell	`irm https://claude.ai/install.ps1 \| iex`	됨
Homebrew	`brew install --cask claude-code` (`claude-code@latest`는 latest 채널)	안 됨
WinGet	`winget install Anthropic.ClaudeCode`	안 됨
리눅스 패키지	apt, dnf, apk도 가능 (공식 문서 참고)	공식 문서 참고

자주 쓰는 명령

명령	용도
`claude`	대화형 모드 시작
`claude "작업"`	첫 요청과 함께 시작
`claude -p "질문"`	한 번만 질문하고 종료
`claude -c`	현재 폴더의 가장 최근 대화 이어가기
`claude -r`	이전 대화 골라서 재개
`/help`	명령어 목록
`/clear`	대화 기록 지우기
`/exit` 또는 Ctrl+D 두 번	종료
`/login`	계정 전환·재인증
`/init`	CLAUDE.md 생성
`Shift+Tab`	권한 모드 순환
`/effort`	생각의 깊이(effort) 조절. 고른 값은 모델별로 저장돼요(v2.1.251 이상). 슬라이더에서 `s`를 누르면 이 세션에만 적용돼요. `max`는 세션 전용이에요.
`/rate-limit-options`	사용 한도에 막혔을 때 이어갈 방법을 보여 줘요. 리셋될 때까지 기다렸다 자동 계속, 추가 사용량(usage credits) 켜기, 플랜 업그레이드 중에서 골라요. claude.ai 구독이 필요해요.

표면 사이 이동

방법	설명
Remote Control	휴대폰·브라우저에서 내 컴퓨터의 로컬 세션을 조작해요.
`claude --teleport`	웹·모바일 세션을 터미널로 가져와요.
`/desktop`	터미널 세션을 데스크톱 앱으로 옮겨요. macOS와 x64 Windows, 구독이 필요해요.
`claude --cloud`	터미널에서 클라우드 세션을 시작해요.
Claude 앱에서 포크	`claude --remote-control`이나 `/remote-control`로 시작한 세션을 Claude 앱에서 포크할 수 있어요. 포크는 내 컴퓨터의 백그라운드 세션으로 돌아가요(v2.1.273 이상).

클라우드 세션의 자세한 사용법은 C13. Claude Code 클라우드 세션에 있어요.

백그라운드 세션 관리

claude --bg "작업"으로 시작한 백그라운드 세션이나 claude agents(agent view)에 보이는 세션은 셸에서 이 명령으로 다뤄요. 세션 ID 대신 이름 일부를 써도 돼요(attach, logs는 v2.1.290 이상).

명령	하는 일
`claude attach <ID 또는 이름>`	백그라운드 세션을 지금 터미널에서 열어요. 이름으로는 실행 중인 세션만 열려서, 멈춘 세션을 다시 띄우려면 ID를 쓰세요.
`claude logs <ID 또는 이름>`	세션의 최근 출력을 출력해요.
`claude stop <ID>`	세션을 멈춰요. `claude kill`도 같아요.
`claude respawn <ID>`	실행 중이든 멈췄든 대화를 유지한 채 다시 시작해요. `--all`이면 실행 중인 세션을 모두 다시 시작해서 새 버전 바이너리를 적용할 수 있어요.
`claude rm <ID>`	목록에서 세션을 지워요. 대화 기록은 내 컴퓨터에 남아 `claude --resume`으로 볼 수 있어요.

agent view에서는 Ctrl+F로 이름을 검색하고, n:로그인처럼 이름·첫 프롬프트로 거를 수 있고, Alt+↑/Alt+↓로 그룹 사이를 건너뛰어요(v2.1.287~288 이상).

반복 작업 자동화 3종

방법	실행 위치
Routines	클라우드
Desktop scheduled tasks	내 컴퓨터
`/loop`	CLI 세션 안

활용 예시 (CLI)

claude "write tests for the auth module, run them, and fix any failures"
claude "commit my changes with a descriptive message"
tail -200 app.log | claude -p "이 로그에서 오류 원인을 요약해 줘"

자주 막히는 지점

설치 후 `claude`를 찾을 수 없어요

원인: 설치 폴더가 PATH에 아직 없거나, 설치 전에 열어 둔 터미널을 그대로 쓰고 있을 수 있어요.
해결: 새 터미널 창을 열고 claude --version을 다시 실행하세요. 그래도 안 되면 공식 troubleshoot-install 문서의 PATH 안내를 따르세요.

설치 명령에서 문법 오류가 나요

원인: PowerShell과 CMD 명령을 서로 바꿔 입력했을 수 있어요. 예를 들어 PowerShell에서 CMD용 && 명령을 실행하면 오류가 나고, CMD에서 irm은 인식되지 않아요. 프롬프트가 PS C:\면 PowerShell이에요.
해결: 지금 쓰는 셸에 맞는 명령을 다시 실행하세요. 그래도 안 되면 공식 설치 문제 해결 문서에서 오류 메시지에 맞는 해결법을 찾으세요.

로그인 안내가 안 나오거나 로그인을 건너뛰었어요

원인: ANTHROPIC_API_KEY 환경변수가 설정되어 있고 그 키 사용을 승인하면 로그인 단계가 생략돼요.
해결: 구독 계정으로 쓰고 싶다면 세션 안에서 /login을 실행해 계정을 바꾸세요.

Free 계정으로는 안 돼요

원인: Claude Code는 Pro 이상 유료 플랜에서 쓸 수 있어요(2026-10-10 기준). 공식 가격 페이지에서 확인할 수 있어요.
해결: 플랜을 확인하세요. Console 계정이나 지원되는 클라우드 제공자 경로도 있어요. 요금은 C2를 참고하세요.

Windows에서 Bash 도구를 못 써요

원인: 네이티브 Windows에 Git for Windows가 없으면 Claude Code는 PowerShell을 셸 도구로 써요.
해결: Git for Windows 설치를 권장해요. WSL 환경은 필요 없어요.

실전 팁

요청은 구체적으로. “버그 고쳐 줘”보다 “로그인 실패 시 빈 화면이 나오는 버그를 고쳐 줘”가 훨씬 나아요.
먼저 탐색시키세요. 고치기 전에 “데이터베이스 스키마를 분석해 줘”처럼 구조를 먼저 파악하게 하면 좋아요.
복잡한 일은 단계로 나눠 번호를 붙이세요. 한 번에 다 맡기는 것보다 결과를 확인하며 진행하기 쉬워요.
/를 눌러 보세요. 쓸 수 있는 명령과 스킬이 보여요. Tab으로 자동 완성하고, ↑로 이전 명령을 불러와요.
변경 내용을 시각적으로 검토하고 싶다면 데스크톱 앱의 Code 탭이나 /desktop을 써 보세요.
작은 작업부터. 요청 결과를 눈으로 확인하는 습관이 안전해요.
무료로 배우고 싶다면 Claude Academy의 Claude Code 101 같은 강좌가 있어요.

다음에 볼 튜토리얼

C13. Claude Code 클라우드 세션 — 내 컴퓨터를 켜 두지 않고 GitHub 작업을 맡기기
C14. Claude Code 핵심 기능 — CLAUDE.md, 슬래시 명령, 훅, 서브에이전트, MCP
C2. 요금제와 사용량 한도 — Claude Code가 쓰는 한도 이해하기
Claude Code 시작하기: 비개발자의 첫 결과물 만들기 — 비개발자 눈높이로 첫 결과물 만들기
Claude Code 헤드리스 모드와 GitHub Actions 자동화 — 사람 없이 Claude Code 돌리기

출처

마지막 확인일: 2026년 10월 13일

Use Claude Code with your Pro or Max plan support.claude.com
Claude Code overview code.claude.com
Quickstart code.claude.com
Commands code.claude.com
Pricing claude.com
CLI reference code.claude.com
Agent view code.claude.com
Model configuration code.claude.com
Claude Code CHANGELOG (v2.1.251, 2.1.273, 2.1.284, 2.1.288, 2.1.290) raw.githubusercontent.com

가격·한도·메뉴 이름은 자주 바뀌어요. 중요한 결정 전에는 위 공식 페이지에서 최신 내용을 다시 확인하세요.