Claude Code 소개

Claude Code는 앤스로픽의 AI 기반 코딩 어시스턴트입니다. 기능을 구축하고, 버그를 수정하고, 개발 작업을 자동화하는 데 도움이 됩니다. 전체 코드베이스를 이해하고 여러 파일과 도구에 걸쳐 작업할 수 있습니다.

사용하는 방식

Claude Code는 같은 기본 엔진을 여러 표면에서 사용할 수 있게 합니다. 터미널에서는 셸 명령과 로컬 도구를 직접 활용하고, IDE에서는 선택한 코드와 열려 있는 파일을 컨텍스트로 삼고, 데스크톱 앱에서는 여러 세션과 변경 차이를 시각적으로 관리할 수 있습니다. 웹에서는 GitHub 저장소를 클라우드 환경에서 실행해 오래 걸리는 작업을 백그라운드로 맡길 수 있습니다.

처음 시작할 때는 빠른 시작에서 기본 흐름을 익히고, 사용할 도구에 맞는 문서로 이동합니다: 터미널 CLI, VS Code, 데스크톱 앱, JetBrains, 웹.

할 수 있는 것

Claude Code를 사용할 수 있는 몇 가지 방법은 다음과 같습니다.

계속 미루고 있는 작업 자동화

Claude Code는 하루를 낭비하는 지루한 작업을 처리합니다: 테스트되지 않은 코드에 대한 테스트 작성, 프로젝트 전체의 린트 오류 수정, 병합 충돌 해결, 종속성 업데이트 및 릴리스 노트 작성.

claude "auth 모듈의 테스트를 작성하고, 실행한 뒤, 실패하면 수정해줘"

기능 구축 및 버그 수정

원하는 것을 일반 언어로 설명합니다. Claude Code는 접근 방식을 계획하고, 여러 파일에 걸쳐 코드를 작성하고, 작동하는지 확인합니다.

버그의 경우 오류 메시지를 붙여넣거나 증상을 설명합니다. Claude Code는 코드베이스를 통해 문제를 추적하고, 근본 원인을 파악하고, 수정을 구현합니다. 더 많은 예제는 일반적인 워크플로우를 참조하세요.

커밋 및 풀 요청 생성

Claude Code는 git과 직접 작동합니다. 변경 사항을 스테이징하고, 커밋 메시지를 작성하고, 브랜치를 생성하고, 풀 요청을 엽니다.

claude "변경 사항을 설명적인 메시지로 커밋해줘"

CI에서 GitHub Actions 또는 GitLab CI/CD를 사용하여 코드 검토 및 이슈 분류를 자동화할 수 있습니다.

MCP로 도구 연결

Model Context Protocol (MCP)는 AI 도구를 외부 데이터 소스에 연결하기 위한 개방형 표준입니다. MCP를 사용하면 Claude Code는 Google Drive에서 설계 문서를 읽고, Jira에서 티켓을 업데이트하고, Slack에서 데이터를 가져오거나, 자신의 커스텀 도구를 사용할 수 있습니다.

지침, 스킬 및 훅으로 사용자 정의

CLAUDE.md는 프로젝트 루트에 추가하는 마크다운 파일로 Claude Code가 모든 세션의 시작 부분에서 읽습니다. 이를 사용하여 코딩 표준, 아키텍처 결정, 선호하는 라이브러리 및 검토 체크리스트를 설정합니다. Claude는 또한 작업할 때 자동 메모리를 구축하여 빌드 명령 및 디버깅 인사이트와 같은 학습 내용을 저장하므로 아무것도 작성할 필요가 없습니다.

스킬을 생성하여 팀이 공유할 수 있는 반복 가능한 워크플로우를 패키징합니다(예: /review-pr 또는 /deploy-staging).

훅을 사용하면 Claude Code 작업 전후에 셸 명령을 실행할 수 있습니다(예: 모든 파일 편집 후 자동 포맷팅 또는 커밋 전 린트 실행).

에이전트 팀 실행 및 커스텀 에이전트 구축

작업의 다른 부분에서 동시에 작동하는 여러 Claude Code 에이전트를 생성합니다. 리드 에이전트가 작업을 조정하고, 하위 작업을 할당하고, 결과를 병합합니다.

여러 전체 세션을 병렬로 실행하고 한 화면에서 감시하려면 백그라운드 에이전트를 사용합니다. 완전히 커스텀 워크플로우의 경우 Agent SDK를 사용하면 Claude Code의 도구 및 기능으로 구동되는 자신의 에이전트를 구축할 수 있으며, 오케스트레이션, 도구 액세스 및 권한에 대한 완전한 제어가 가능합니다.

CLI로 파이프, 스크립트 및 자동화

Claude Code는 구성 가능하며 Unix 철학을 따릅니다. 로그를 파이프하고, CI에서 실행하거나, 다른 도구와 연결합니다.

# 최근 로그 출력 분석
tail -200 app.log | claude -p "이상 징후가 보이면 Slack으로 알려줘"

# CI에서 번역 자동화
claude -p "새 문자열을 프랑스어로 번역하고 검토용 PR을 열어줘"

# 파일 전체에 걸친 대량 작업
git diff main --name-only | claude -p "변경된 파일에서 보안 이슈를 검토해줘"

전체 명령 및 플래그 세트는 CLI 참조를 참조하세요.

반복되는 작업 예약

Claude를 일정에 따라 실행하여 반복되는 작업을 자동화합니다: 아침 PR 검토, 야간 CI 실패 분석, 주간 종속성 감사 또는 PR 병합 후 문서 동기화.

• Routines는 Anthropic 관리 인프라에서 실행되므로 컴퓨터가 꺼져 있어도 계속 실행됩니다. API 호출 또는 GitHub 이벤트에서도 트리거될 수 있습니다. 웹, 데스크톱 앱에서 생성하거나 CLI에서 /schedule을 실행하여 생성합니다.
• 데스크톱 예약된 작업은 머신에서 실행되며 로컬 파일 및 도구에 직접 액세스할 수 있습니다.
• /loop는 빠른 폴링을 위해 CLI 세션 내에서 프롬프트를 반복합니다.

어디서나 작업

세션은 단일 환경에 연결되지 않습니다. 컨텍스트가 변경되면 환경 간에 작업을 이동합니다.

• 책상에서 떠나 원격 제어를 사용하여 휴대폰이나 모든 브라우저에서 계속 작업합니다.
• 휴대폰에서 Dispatch로 작업을 보내고, 생성되는 데스크톱 세션을 엽니다.
• 웹 또는 iOS 앱에서 오래 실행되는 작업을 시작한 다음 claude --teleport를 사용하여 터미널로 가져옵니다.
• 터미널 세션을 데스크톱 앱으로 /desktop을 사용하여 변경 차이를 시각적으로 검토하도록 전달합니다.
• 팀 채팅에서 작업을 라우팅합니다: Slack에서 @Claude를 언급하고 버그 보고서를 포함하면 풀 요청을 다시 받습니다.

모든 곳에서 Claude Code 사용

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

위의 터미널, VS Code, JetBrains, 데스크톱 및 웹 환경 외에도 Claude Code는 CI/CD, 채팅 및 브라우저 워크플로우와 통합됩니다.