Claude Code 소개
기준일: 2026-06-19
난이도: 초급
공식 기준: Claude Code Quickstart, Advanced setup
Claude Code는 Anthropic의 에이전트형 코딩 도구입니다. 터미널에서 시작하는 흐름이 기본이지만, 현재 공식 문서는 web, desktop, Chrome extension, computer use preview, VS Code, JetBrains, Slack, GitHub Actions, GitLab CI까지 여러 실행 표면을 함께 다룹니다.
핵심 개념
| 개념 | 설명 |
|---|---|
| Agentic loop | Claude가 프로젝트를 읽고, 계획하고, 도구를 호출하고, 결과를 다시 반영하는 반복 흐름 |
| Project context | 파일, 명령 출력, Git 상태, CLAUDE.md, 세션 기록을 작업 문맥으로 사용 |
| Permission modes | 파일 수정과 명령 실행을 승인 정책에 따라 제어 |
| Extensions | skills, slash commands, hooks, MCP, plugins로 반복 업무를 확장 |
| Interfaces | CLI뿐 아니라 web, desktop, IDE, Slack, CI/CD 표면에서 사용 가능 |
중요한 변화는 “터미널 CLI 하나”로만 설명하면 부족하다는 점입니다. CLI 설치와 첫 세션이 출발점이지만, 조직 도입 단계에서는 권한, 인증, MCP, 플러그인 배포, 비용/모니터링, 데이터 정책까지 같이 검토해야 합니다.
선택 기준
| 상황 | Claude Code가 잘 맞는 이유 | 먼저 볼 문서 |
|---|---|---|
| 기존 저장소를 빠르게 이해 | 파일과 명령 결과를 한 세션에서 읽고 요약 | 빠른 시작 |
| 반복 개발 업무 자동화 | skills, slash commands, hooks로 팀 절차를 고정 | 스킬 시스템 |
| 외부 도구와 연결 | MCP와 plugins로 GitHub, 내부 API, 데이터 도구 연결 | MCP 통합 |
| 조직 배포 | server-managed settings, managed MCP, 비용/모니터링, 데이터 정책 검토 | 엔터프라이즈 배포 |
| IDE나 비터미널 사용 | Desktop, Web, VS Code, JetBrains, Slack 표면 선택 | 최신 운영 기능 맵 |
다만 Claude Code가 모든 작업을 자동으로 대신해도 된다는 뜻은 아닙니다. 쓰기 작업, 외부 서비스 호출, 배포, 데이터베이스 변경, 브라우저/컴퓨터 조작은 사용 가능한 인터페이스와 권한 정책에 따라 달라집니다. 처음에는 읽기 중심으로 시작하고, 변경 범위와 검증 명령을 분리하는 편이 안전합니다.
실습
설치 후 프로젝트 루트에서 첫 세션을 시작합니다.
cd /path/to/project
claude
처음 요청은 읽기 전용으로 둡니다.
이 저장소의 주요 디렉터리, 실행 명령, 테스트 명령을 찾아서 요약해줘.
파일을 수정하지 말고 근거가 되는 파일 경로를 함께 적어줘.
그 다음 작은 수정 후보를 고르게 합니다.
이 프로젝트에서 가장 안전한 첫 개선 작업 하나를 제안해줘.
수정 파일, 예상 위험, 검증 명령, 되돌리는 방법을 포함해줘.
아직 파일은 수정하지 마.
도구에 입력할 프롬프트
너는 내 프로젝트를 처음 보는 Claude Code 세션이야.
1. 저장소 구조를 읽고
2. 실행/검증 명령을 찾고
3. 위험도가 낮은 첫 작업 후보 3개를 제안해줘.
파일 수정이나 명령 실행 전에는 먼저 계획과 영향 범위를 보여줘.
체크리스트
- CLI, web, desktop, IDE, Slack, CI/CD 중 어떤 표면으로 쓸지 정했다.
- 첫 세션은 읽기 전용 탐색으로 시작한다.
- 파일 수정 전 변경 범위와 검증 명령을 확인한다.
- 팀 도입 전 permission modes, 인증, MCP, 데이터 정책을 검토한다.
- 반복 절차는 skills, slash commands, hooks 중 어디에 둘지 분리한다.
- 최신 설치 방식은 Native Install 우선으로 확인한다.
다음 단계
- 설치 및 설정에서 Native Install 기준으로 설치합니다.
- 빠른 시작에서 첫 프로젝트 작업을 실행합니다.
- 최신 운영 기능 맵에서 web, desktop, Chrome, computer use, CI/CD 표면을 비교합니다.