본문으로 건너뛰기

Code 모드 개요

공식 문서: https://code.claude.com/docs/ko/overview

Claude Code란?​

Claude Code는 터미널에서 동작하는 AI 코딩 에이전트입니다. 코드베이스를 직접 읽고, 수정하고, 명령어를 실행할 수 있습니다. Chat 모드에서 코드 조각을 복사/붙여넣기하는 것과 달리, Claude Code는 프로젝트 전체를 이해하고 직접 파일을 수정합니다.

Claude Code 사용 환경​

Claude Code 사용 환경 허브
다양한 환경에서 하나의 Claude Code로 연결됩니다
💻
터미널 CLI
claude 명령어
🌐
웹 브라우저
claude.ai/code
→
🤖
Claude
Code
→
🛠️
VS Code / JetBrains
IDE 확장 프로그램
📱
모바일 Dispatch
스마트폰에서 작업 위임
☁️
클라우드 세션
🔄
자동화 Schedule
💬
Slack 연동

어디서나 사용하기​

Claude Code는 다양한 환경에서 사용할 수 있습니다. 상황에 맞는 최적의 방법을 선택하세요:

하고 싶은 일추천 기능설명
터미널에서 코딩CLIclaude 명령어로 터미널에서 직접 사용
웹에서 코딩claude.ai/code브라우저에서 클라우드 세션으로 사용
IDE에서 코딩VS Code / JetBrains 확장에디터 안에서 Claude Code 사용
모바일에서 작업 위임Dispatch스마트폰에서 작업을 지시하고 모니터링
PR 자동 수정PR 모니터링CI 실패, 리뷰 코멘트에 자동 대응
PR 자동 리뷰 (GitHub)GitHub Actions 통합PR 열릴 때 자동으로 코드 리뷰 실행
PR 자동 리뷰 (GitLab)GitLab CI/CD 통합MR 열릴 때 자동으로 코드 리뷰 실행
반복 작업 자동화Schedulecron 기반 주기적 자동 실행
Slack에서 사용Slack 연동Slack 메시지로 Claude Code에 작업 요청
병렬 작업 실행클라우드 세션여러 작업을 동시에 클라우드에서 실행
에이전트 팀 구성Agent Teams여러 에이전트가 협업하여 작업 수행

설치 방법 요약​

방법 1: macOS/Linux 직접 설치 (권장)​

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

방법 2: macOS Homebrew​

macOS에서 Homebrew를 사용하는 경우:

brew install claude-code

방법 3: npm (구버전, 지원 중단 예정)​

npm 설치는 지원 중단 예정

네이티브 설치를 권장합니다. npm 방식은 향후 지원이 중단될 수 있습니다.

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

방법 4: Windows WinGet​

Windows에서 WinGet 패키지 관리자를 사용하는 경우:

winget install Anthropic.ClaudeCode

방법 5: Windows PowerShell 설치​

PowerShell을 사용하는 경우:

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

방법 6: Windows CMD 설치​

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

방법 7: 직접 다운로드​

claude.ai/code에서 직접 다운로드할 수 있습니다.

방법 8: IDE 확장 프로그램​

  • VS Code: 마켓플레이스에서 "Claude Code" 검색 후 설치
  • JetBrains: 플러그인 마켓플레이스에서 "Claude Code" 검색 후 설치

방법 9: iOS 앱​

Claude Code iOS 앱을 통해 모바일에서도 사용할 수 있습니다. App Store에서 "Claude" 검색 후 설치하세요.

상세 설치 가이드

자세한 설치 및 초기 설정 방법은 초기 설정 페이지를 참고하세요.

주요 특징​

코드베이스 이해​

Claude Code는 프로젝트의 파일 구조, 의존성, 코딩 패턴을 파악합니다:

  • 프로젝트 전체 파일을 탐색하고 읽기
  • package.json, tsconfig.json 등 설정 파일 분석
  • 함수 간 의존 관계 파악

직접 코드 수정​

대화 창에서 코드를 복사하는 대신, 파일을 직접 수정합니다:

> src/components/Button.tsx에 hover 애니메이션을 추가해줘

Claude Code가 파일을 열고, 적절한 위치에 코드를 추가하고, 변경 내용을 보여줍니다.

명령어 실행​

테스트 실행, 빌드, Git 작업 등을 직접 수행합니다:

> 전체 테스트를 실행하고 실패하는 테스트를 수정해줘

멀티 파일 수정​

여러 파일에 걸친 변경을 한 번에 처리합니다:

  • 함수 이름 변경 시 모든 참조 위치 업데이트
  • 새 기능 추가 시 관련 파일들 동시 수정
  • 리팩토링(Refactoring) 시 영향받는 파일들 일괄 처리

Chat 모드 vs Code 모드​

항목Chat 모드Code 모드
인터페이스GUI (데스크탑 앱)CLI (터미널)
파일 접근첨부 파일만로컬 파일시스템 전체
코드 수정코드 복사/붙여넣기직접 파일 수정
명령어 실행불가git, npm, make 등 실행
대상모든 사용자개발자

지원 기능​

  • Git 작업: 커밋, 브랜치, PR 생성
  • 테스트: 테스트 실행 및 실패 분석/수정
  • 디버깅: 에러 추적 및 수정
  • 리팩토링: 코드 구조 개선
  • 문서화: 주석, README, 문서 생성
  • 규칙: CLAUDE.md로 프로젝트별 지침 설정
  • 스킬: 재사용 가능한 워크플로우 패키징
  • 스케줄: 작업을 주기적으로 자동 반복
  • 디스패치: 모바일에서 작업 위임
  • 원격 제어: 어디서든 세션 이어가기
  • 컴퓨터 사용: GUI 앱을 화면에서 직접 조작
  • 채널: 텔레그램, 디스코드 등 외부 메시지 연동
  • 클라우드 세션: 클라우드 VM에서 실행
  • 기능 비교: 모든 원격/자동화 기능 한눈에 비교
  • MCP 서버: 외부 도구 연동 (GitHub, DB, Slack 등)
  • Desktop 앱 핵심 기능: 비주얼 Diff 리뷰, 프리뷰, PR 모니터링, 커넥터
  • 후크(Hook): 워크플로우 자동화
  • 헤드리스 모드: CI/CD 파이프라인에서 비대화형 실행
  • 에이전트 팀: 여러 에이전트가 병렬로 협업
  • 서브에이전트: Claude Code SDK를 통한 프로그래밍 방식 에이전트 생성
  • 확장 사고: /think 명령어로 깊은 추론 활성화
  • 커스텀 슬래시 명령어: .claude/commands/로 프로젝트 전용 명령어 생성

실전 예제: Claude Code로 보내는 하루​

개발자의 전형적인 하루에서 Claude Code를 활용하는 모습:

# 아침: 이슈 확인 및 작업 시작
claude
> 오늘 할당된 GitHub 이슈를 확인해줘
> 이슈 #87을 위한 feature 브랜치를 만들어줘

# 오전: 기능 개발
> 이슈 #87의 요구사항대로 사용자 알림 API를 구현해줘
> 관련 테스트도 작성해줘

# 점심 후: 코드 리뷰
> PR #92의 변경사항을 리뷰해줘
> 리뷰에서 발견된 문제를 수정해줘

# 오후: 디버깅
> 스테이징 환경에서 이 에러가 발생해:
> [에러 메시지 붙여넣기]
> 원인을 분석하고 수정해줘

# 퇴근 전: 정리
> 오늘 작업한 내용을 커밋하고 PR을 만들어줘
> PR 설명에 구현 내용과 테스트 방법을 포함해줘

연계 기능​

Claude Code와 함께 사용하는 핵심 기능들
🖥️
비주얼 Diff 리뷰, 프리뷰, PR 모니터링, 커넥터 등 데스크탑 환경에서 Claude Code를 더욱 강력하게 활용합니다.
☁️
로컬 머신 대신 클라우드 VM에서 Claude Code를 실행하여, 병렬 작업과 장시간 작업을 안정적으로 처리합니다.
🎮
로컬에서 시작한 Claude Code 세션을 클라우드나 다른 기기에서 원격으로 이어서 진행할 수 있습니다.

장점, 단점과 한계점​

장점​

  • 코드베이스 전체 이해: 프로젝트의 파일 구조, 의존성, 코딩 패턴을 종합적으로 파악하여 맥락에 맞는 정확한 코드를 생성합니다.
  • 직접 파일 수정: 코드를 복사/붙여넣기할 필요 없이 파일을 직접 열어 수정하므로, 작업 흐름이 끊기지 않고 생산성이 높습니다.
  • 명령어 실행 가능: 테스트, 빌드, Git 작업 등 터미널 명령어를 직접 실행하여 개발 워크플로우 전체를 하나의 도구로 처리할 수 있습니다.
  • 멀티 파일 동시 수정: 함수 이름 변경, 리팩토링 등 여러 파일에 걸친 변경을 한 번에 일관되게 처리합니다.
  • 다양한 실행 환경: CLI, IDE 확장, 웹(claude.ai/code), 모바일(Dispatch) 등 상황에 맞는 최적의 환경에서 사용할 수 있습니다.

단점과 한계점​

  • 터미널 친숙도 필요: CLI 기반이므로 터미널 사용 경험이 없으면 진입 장벽이 있으며, GUI에 익숙한 사용자에게는 불편할 수 있습니다.
  • 보안 민감 코드 주의: 파일시스템 전체에 접근 가능하므로, .env나 시크릿 파일 등 보안 민감 파일에 대한 관리가 필요합니다.
  • 토큰 비용 (대규모 코드베이스): 프로젝트 규모가 클수록 컨텍스트에 더 많은 토큰을 소비하여 비용이 예상보다 높아질 수 있습니다.
  • 실행 권한 관리 필요: 자동 모드에서 의도치 않은 명령어 실행이 발생할 수 있으므로, 권한 설정을 신중하게 구성해야 합니다.
  • 네트워크 의존: Anthropic API와의 통신이 필수이므로, 오프라인 환경이나 네트워크가 불안정한 곳에서는 사용이 제한됩니다.
활용 팁

보안이 걱정된다면 처음에는 default 모드로 시작하여 모든 파일 수정과 명령어 실행을 직접 확인하세요. 비용이 걱정된다면 --max-budget-usd 플래그로 세션 비용 상한을 설정하면 안전합니다.

다음 단계​

호환성 및 플랫폼 정보​

Claude Code는 다양한 환경에서 사용할 수 있습니다.

지원되는 운영체제​

환경지원 상태최소 버전비고
macOS✅ 완전 지원13.0 (Ventura)M1/M2 및 Intel
Windows✅ 완전 지원10 (1809)네이티브 & WSL 2
Linux (Ubuntu)✅ 완전 지원20.0464비트
Linux (Debian)✅ 완전 지원1064비트
Linux (Alpine)⚠️ 제한 지원3.19추가 패키지 필요
Linux 다른 배포🔄 지원 예정-요청하기

IDE 확장 지원​

IDE플랫폼상태설치 방법
VS CodemacOS, Windows, Linux✅ 지원VS Code 마켓플레이스
JetBrainsmacOS, Windows, Linux✅ 지원JetBrains 플러그인 마켓
Vim/NeovimmacOS, Linux🔄 계획 중-
EmacsmacOS, Linux🔄 계획 중-