Claude Code 사용 방법: Anthropic 터미널 코딩 에이전트

Claude Code 사용 방법은 먼저 Claude Code가 정확히 무엇인지 이해하는 것부터 시작합니다: Anthropic의 에이전트형 코딩 도구로, 터미널에서 실행되며 전체 코드베이스를 읽고 자연어 명령에 따라 개발 작업을 실행합니다^[1]. 개발자 가용성 이후 GitHub에서 101,000개의 스타와 15,500개의 포크를 받아 2026년 가장 널리 채택된 AI 코딩 도구 중 하나가 되었습니다^[2].

이전 도구들과의 구조적 차이는 분명히 이해할 필요가 있습니다. 왜냐하면 이것이 워크플로우가 당신에게 맞는지를 결정하기 때문입니다. Copilot 스타일의 자동 완성은 이미 작성한 것을 기반으로 다음 줄을 제안합니다. Claude Code는 전체 프로젝트를 읽고, 접근 방식을 계획하고, 한 번에 많은 파일을 수정하고, 테스트를 실행하고, 실패를 처리하고, 반복하고, 커밋합니다. 어떤 파일이 중요한지 알려줄 필요가 없습니다.

이 가이드는 Claude Code가 무엇을 하는지, 어디에서 실행되는지, 설치 방법, 특히 뛰어난 다섯 가지 작업, Cursor 및 Copilot과의 비교, 그리고 터미널이 아닌 자신의 제품 내에서 이 동작을 원할 때 어떻게 할지를 다룹니다.

TL;DR

• 1M 토큰 컨텍스트 윈도우, 한 세션에서 조각화 없이 대략 25,000~30,000줄의 코드^[1].
• SWE-bench Verified에서 80.8%, 작성 당시 이용 가능한 도구 중 가장 높은 공개 점수^[1].
• Plan Mode 는 아무것도 건드리기 전에 파일별 계획을 보여주므로, 프로덕션 저장소에서 자동 작업을 수용할 수 있게 합니다^[1].
• 거의 모든 곳에서 실행: 터미널 CLI, VS Code, Cursor, Windsurf, JetBrains, 데스크톱 앱, 웹, GitHub 이슈의 @claude^[1].
• 접근 방법: Claude Pro 또는 Max 구독, 또는 API 접근 권한이 있는 Claude Console 계정 필요^[1].
• MCP 지원 은 데이터베이스, 내부 API, 티켓팅, 관찰성에 연결하므로, 저장소 이상을 추론합니다^[1].

Claude Code란 무엇인가

Claude Code는 완성 엔진이 아니라 코딩 에이전트입니다. 프로젝트를 가리키면, 선임 개발자가 하는 방식처럼 구조를 탐색합니다: 진입점에서 시작하여 의존성 그래프를 따라가 컴포넌트가 상호작용하는 방식에 대한 작동 모델을 구축한 다음, 지역적으로 정확하지만 전역적으로 손상되지 않는 변경 사항 대신 구조적으로 일관성 있는 변경을 합니다.

이 구분은 엔지니어링 시간을 실제로 소비하는 작업에서 가장 중요합니다. 스테이징에서 다르게 동작하는 프로덕션 문제를 디버깅합니다. ORM 변경, 세 개의 엔드포인트 업데이트, 마이그레이션이 필요한 기능을 구현합니다. 이들은 다중 파일 문제이며, 다중 파일 문제는 전체 컨텍스트 에이전트가 자동 완성과 분리되는 곳입니다.

중요한 기능들

1M 토큰 컨텍스트 윈도우

Claude Code는 한 번에 최대 백만 개의 토큰을 읽을 수 있으며, 이는 청킹이나 검색 보강 없이 단일 세션에서 대략 25,000~30,000줄의 코드입니다^[1]. 리팩터가 200,000줄 코드베이스 전체에서 40개 파일에 영향을 미칠 때, 파일 목록을 제공할 필요가 없습니다. 자신이 찾아냅니다.

SWE-bench Verified에서 80.8%

SWE-bench Verified는 오픈소스 저장소의 실제 GitHub 이슈에 대해 모델을 평가하며, 제안된 수정이 저장소 자신의 테스트 스위트를 통과하는지 여부로 점수를 매깁니다. Claude Code는 80.8%에 도달하며, 이는 이용 가능한 도구 중 가장 높은 공개 보고 수치입니다^[1]. 벤치마크는 고립된 코드 조각의 패턴 매칭보다는 진정한 코드베이스 이해를 측정하므로, 대부분의 코딩 평가보다 실제 유용성을 더 잘 추적합니다.

Plan Mode

실행하기 전에 Claude Code는 구조화된 계획을 제시합니다: 어떤 파일을 수정할 것인지, 어떤 변경을 할 것인지, 어떤 순서로 할 것인지. 이를 검토하고, 의문을 제기하고, 조정한 다음에만 승인합니다^[1].

이것이 프로덕션 저장소에서 사용 가능하게 만드는 기능입니다. 감시된 자동성은 비용이 큰 순간에 개발자를 루프에 유지합니다.

에이전트 팀

여러 Claude Code 인스턴스가 문제의 여러 부분에서 동시에 작동하며, 리드 에이전트가 하위 작업을 할당하고 결과를 병합합니다^[1]. 백엔드 변경, 프런트엔드 업데이트, 문서 업데이트를 병렬로 실행하는 독립적인 작업 스트림으로 분해되는 기능의 경우, 이는 토큰 시간이 아니라 캘린더 시간을 압축합니다.

Claude Code는 어디에서 실행되나

광범위한 채택은 재미없는 설명을 가지고 있습니다: 개발자가 이미 있는 곳에서 만납니다^[1].

• 터미널 CLI 는 핵심 경험입니다. 프로젝트로 이동하고, claude를 실행하고, 작업을 설명합니다.
• VS Code 확장 은 시각적 diff 검토 및 대화형 변경 선택을 제공합니다. 같은 확장이 Cursor와 Windsurf에서 작동합니다.
• JetBrains 플러그인 은 IntelliJ IDEA, PyCharm, WebStorm 등을 포함합니다.
• 데스크톱 앱 은 시각적 diff 검토, 병렬 세션, 장기 실행 작업의 클라우드 실행을 추가합니다.
• 웹 은 claude.ai/code에서, 로컬 설치 불필요, Claude iOS 앱도 포함입니다.
• GitHub: 이슈에 @claude라고 태그하면 풀 리퀘스트가 반환되며, 팀원이 작업 방식을 바꿀 필요가 없습니다.

Claude Code 사용 방법: 설치 및 첫 실행

macOS와 Linux:

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

또는 Homebrew 사용:

brew install --cask claude-code

Windows:

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

또는 WinGet 사용:

winget install Anthropic.ClaudeCode

그런 다음 프로젝트로 이동하여 claude를 실행합니다. 프로젝트 구조를 인덱싱하고 수행할 작업을 물어봅니다.

한 가지 단계가 설치 방법보다 더 중요합니다. 저장소 루트에 CLAUDE.md를 생성하고 규칙을 넣으세요: 사용하는 테스트 프레임워크, 자동으로 수정하면 안 되는 파일, 이름 지정 방식^[1]. 모든 세션 시작 시 읽힙니다. 팀은 이를 사용하여 선임 개발자가 그렇지 않으면 온보딩 중에 전달할 기관 지식을 인코딩하며, 이는 도구에서 가장 높은 영향력의 설정입니다.

특히 뛰어난 다섯 가지 작업

대규모 코드베이스 리팩터링. 리팩터가 수십 개의 파일에 영향을 미치고 시그니처, 임포트, 테스트에 일관된 변경이 필요할 때, 조정이 어려운 부분입니다. Claude Code는 의존성 맵을 구축하고, 모든 호출 사이트를 찾고, 조정된 변경을 하고, 결과를 보여주기 전에 스위트를 실행합니다. Rakuten의 팀은 큰 다중 언어 라이브러리 내의 활성화 벡터 추출 방법에 대해 7시간 동안 자동으로 작동하여 참조 구현에 대해 99.9% 수치 정확도를 생성한 것으로 문서화했습니다^[1].

교차 파일 디버깅. 버그가 사용자 동작에서 표면화되지만 다른 사람이 다른 시간에 작성한 세 개의 모듈 간의 상호작용에서 발생하는 경우, 전체 컨텍스트 탐색은 실행 경로를 따라가고, 오류 모드를 가정하고, 진단을 작성하고, 가장 명백한 것이 아닌 손상된 가정이 만들어진 모든 장소를 수정하게 합니다.

테스트 없는 코드에 대한 테스트 생성. 구현을 읽고, 코드와 존재하는 모든 문서에서 의도된 동작을 추론하고, 정상 경로, 엣지 케이스, 오류 조건을 포함하는 테스트를 생성합니다. 이를 수행하면서 버그를 찾는 경향이 있습니다.

Git 워크플로우 자동화. 일반 언어로 커밋을 설명하되 제외할 내용을 포함하고, 스테이징, 커밋 메시지, 푸시, 구조화된 설명이 있는 풀 리퀘스트를 처리합니다. GitHub MCP 통합을 사용하면 열린 이슈를 읽고, 수정을 구현하고, 테스트를 실행하고, 전체 컨텍스트로 PR을 열 수 있습니다.

아키텍처 분석. 낯선 코드베이스를 가리키고 아키텍처를 설명하도록 요청합니다. 조직, 각 주요 컴포넌트, 서비스 간의 데이터 흐름, 중요한 경로의 구조화된 안내를 받습니다. 온보딩, 기술 실사, 누구도 쓰지 않은 문서 작성에 유용합니다.

MCP 통합

Claude Code는 Anthropic의 모델을 외부 도구 및 데이터에 연결하기 위한 개방 표준인 Model Context Protocol을 지원합니다^[1]. 이는 저장소 이상으로 추론을 확장합니다: 마이그레이션을 작성하기 전에 프로덕션 데이터베이스를 쿼리하여 데이터 모델을 이해하고, 구현하기 전에 티켓을 읽어 수용 기준을 이해하고, 디버깅하기 전에 관찰성 플랫폼에서 오류 패턴을 확인합니다.

플러그인 디렉토리는 커뮤니티 통합의 성장하는 라이브러리를 담으므로, 대부분의 일반적인 도구가 이미 다루어집니다.

Claude Code, Cursor, Copilot

비교 행의 출처는 전체에서 참조된 동일한 가이드입니다^[1].

정직한 평가는 이들이 실제로 같은 시간을 놓고 경쟁하지 않는다는 것입니다. Cursor는 에디터 전체에 AI가 통합된 VS Code 포크입니다: 빠른 인라인 완성, 다중 모델 지원, 시각적 IDE. Copilot은 엔터프라이즈 Microsoft 구독 내에서 배포되기 때문에 가장 널리 배포되며, 복잡한 다중 파일 작업의 전체 에이전트로 작동하지 않고 일상적 완성을 잘 처리합니다.

두 가지를 모두 사용하는 대부분의 개발자는 일상적 편집을 위해 Cursor를 사용하고 깊은 코드베이스 이해가 필요한 작업(대규모 리팩터, 아키텍처 변경, 보안 감사, 미묘한 교차 파일 버그)을 위해 Claude Code를 사용합니다.

자신의 제품 내에서 이 동작을 원할 때

Claude Code는 Anthropic의 에이전트이며, 작업이 터미널에서 발생할 때 올바른 도구입니다. 다른 작업에는 올바른 형태가 아닙니다: CI의 코드 검토 봇, 고객을 위한 마이그레이션 에이전트, 저장소를 읽고 이에 대해 질문에 답하는 내부 도구. 이들 중 누구도 개발자의 노트북에 있는 CLI가 아닙니다.

이 작업은 직접 모델이 필요합니다. Claude Code 자체에 대한 접근은 Claude Pro 또는 Max 구독, 또는 API 접근 권한이 있는 Claude Console 계정을 통해 실행되며, 자신의 에이전트를 구축할 때 두 번째 계층에서 작동합니다^[1].

reAPI는 OpenAI 호환 /v1/chat/completions 엔드포인트를 통해 Claude 모델을 노출하므로, 한 클라이언트와 한 키가 Claude를 GPT 및 Gemini와 함께 다룹니다:

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_REAPI_KEY",
    base_url="https://api.reapi.ai/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Review this diff and report issues with severity."}],
    max_tokens=16000,
    stream=True,
)

기본 Anthropic /v1/messages 표면도 사용 가능하므로, 두 형식으로 작성된 SDK는 변경되지 않고 작동합니다. 모델 페이지 및 요금은 reapi.ai/models에 있으며, 현재 Opus 세대의 엔드포인트 참조는 reapi.ai/docs/claude-opus-5에 있습니다.

자신의 저장소를 위해 Claude Code를 사용합니다. 에이전트가 다른 사람의 저장소에서 실행해야 하는 경우 API를 사용합니다.

FAQ

Claude Code는 어떤 모델로 실행되나요?

Anthropic의 현재 최첨단 Claude 모델에서 실행되며, 기본값은 한 버전에 고정되지 않고 Anthropic이 가장 최근에 배포한 것을 추적합니다. 어느 시점에 계획 뒤에 있는 모델에 대해 Anthropic의 문서를 확인하세요.

Claude Code는 무료인가요?

아니오. Claude Pro 또는 Max 구독이 필요하며, 월 $20~$100 사이의 가격이거나 API 접근 권한이 있는 Claude Console 계정입니다^[1].

Claude Code는 얼마나 큰 코드베이스를 처리할 수 있나요?

컨텍스트 윈도우는 1M 토큰이며, 단일 세션에서 조각화 없이 대략 25,000~30,000줄입니다^[1]. 더 큰 저장소도 작동하는데, 한 번에 모든 것을 로드하지 않고 의존성 그래프를 탐색하기 때문입니다.

CLAUDE.md는 무엇인가요?

모든 세션 시작 시 읽는 영구 프로젝트별 지침: 코딩 규약, 테스트 프레임워크, 자동으로 수정하면 안 되는 파일. 팀이 온보딩 지식을 인코딩하는 곳입니다^[1].

Claude Code가 Cursor보다 낫나요?

다른 문제를 풉니다. Cursor는 빠른 인라인 편집을 갖춘 완전한 IDE 경험이고, Claude Code는 훨씬 더 큰 컨텍스트 윈도우와 전체 계획-실행-테스트-커밋 작업이 있는 터미널 에이전트입니다. 많은 개발자가 둘 다 실행합니다^[1].

Claude Code가 풀 리퀘스트를 열 수 있나요?

예. Git과 직접 통합되며, GitHub 이슈에 @claude를 태그하면 풀 리퀘스트가 반환됩니다. GitHub MCP 통합을 사용하면 이슈를 읽고, 구현하고, 테스트하고, 전체 컨텍스트로 제출할 수 있습니다^[1].

Plan Mode는 무엇인가요?

검토 게이트입니다. Claude Code는 변경을 하기 전에 파일별 계획을 제시하고 승인을 기다립니다^[1].

자신의 코딩 에이전트를 어떻게 만드나요?

CLI가 아닌 API를 통해 모델을 호출합니다. OpenAI 호환 클라이언트를 https://api.reapi.ai/v1에 가리키고 모델 문자열을 설정하거나, 기본 Anthropic /v1/messages 표면을 사용합니다.

올바른 계층 선택

Claude Code는 한 가지 성질로 채택을 얻습니다: 전체 프로젝트를 보유하고 다음 줄을 추측하지 않고 이에 작용합니다. 백만 토큰 윈도우, 80.8% SWE-bench 점수, Plan Mode는 같은 설계 결정의 세 가지 표현이며, 리팩터, 교차 파일 디버깅, 낯선 코드베이스에서 가장 강하게 나타납니다.

문제가 어느 계층에 있는지 알아야 합니다. 작업이 저장소 및 터미널에 있다면, 설치하고 다른 무엇보다 먼저 좋은 CLAUDE.md를 작성합니다. 작업이 다른 사람에게 배포하는 제품 내에 있다면, 맨 위의 CLI가 아니라 아래의 모델 API를 원합니다. Claude Code를 잘 사용하는 방법을 배우는 것은 대부분 이 두 가지 중 어느 것을 실제로 하고 있는지 인식하는 것을 의미합니다.

참고문헌

1. Anthropic. Claude Code — overview, capabilities, surfaces, and configuration. 2026년 7월에서 검색 platform.claude.com/docs/claude-code
2. Anthropic. Claude Code — official repository. 2026년 7월에서 검색 github.com/anthropics/claude-code
3. Anthropic. Claude Code documentation. 2026년 7월에서 검색 docs.claude.com/en/docs/claude-code/overview

추가 읽을거리

• reAPI. How to use Claude Opus 5. reapi.ai/blog/how-to-use-claude-opus-5
• reAPI. How to use Claude Fable 5. reapi.ai/blog/how-to-use-claude-fable-5
• reAPI. Model catalog. reapi.ai/models