개인의 기록
  • 소개
  • 프로젝트
  • 글
  • 링크

© 2026 newgirok

← 글 목록

Claude Code란? — CLI 기반 Agentic Coding 도구

2025년 12월 10일
Claude CodeCLIAgentic개발 도구

AI 코딩 도구는 많지만 Claude Code는 다릅니다. 채팅창에서 코드를 복사하는 것이 아니라, 터미널에서 직접 파일을 읽고 수정하고 명령을 실행합니다. 개발자가 하는 일을 옆에서 함께 하는 방식입니다.

Claude Code란

Claude Code는 Anthropic이 만든 CLI 기반 AI 코딩 도구입니다. 터미널에서 claude 명령으로 실행하며, 대화를 통해 코드 작업을 수행합니다.

단순히 코드를 생성하는 것이 아닙니다. 파일 시스템에 접근해 코드를 읽고, 편집하고, 테스트를 실행하고, Git 커밋을 만드는 등 실제 개발 워크플로를 수행합니다.

CLI(Command Line Interface): 명령줄 인터페이스. GUI 없이 터미널에서 텍스트 명령으로 조작하는 방식입니다.

Agentic이란

일반적인 AI 채팅 도구는 질문에 답변합니다. Claude Code는 에이전트로 동작합니다.

일반 AI: 질문 → 답변
Claude Code: 목표 → 계획 → 도구 사용 → 확인 → 완료

목표를 주면 스스로 파일을 확인하고, 코드를 수정하고, 결과를 검증하는 루프를 반복합니다. 중간에 사람의 개입 없이 여러 단계를 자율적으로 처리합니다.

에이전트(Agent): 목표를 받아 스스로 판단하고 도구를 사용해 작업을 수행하는 AI 시스템. 단순 응답이 아닌 행동을 실행합니다.

핵심 개념

Agent

Claude Code 자체가 에이전트입니다. 사용자의 요청을 이해하고, 어떤 도구를 어떤 순서로 사용할지 계획하고, 실행합니다.

Tool Use

에이전트가 실제 작업을 수행하는 방법입니다. 파일 읽기, 파일 편집, 셸 명령 실행, 웹 검색 등의 도구를 호출합니다.

사용자: "테스트 실행하고 실패한 것 고쳐줘"
Claude Code:
  1. Bash("npm test") 실행
  2. Read("src/utils.ts") 파일 읽기
  3. Edit("src/utils.ts") 수정
  4. Bash("npm test") 재실행 확인

Conversation

Claude Code는 대화 기반으로 동작합니다. 이전 메시지 맥락을 유지하며 작업을 이어갑니다. "방금 수정한 함수에 테스트 추가해줘"처럼 이전 작업을 참조할 수 있습니다.

Session

작업 상태를 유지하는 단위입니다. 세션 내에서 대화 기록과 컨텍스트가 유지됩니다. --resume으로 이전 세션을 이어받아 중단된 작업을 계속할 수 있습니다.

일반 AI 도구와의 차이

항목ChatGPT/Claude.aiClaude Code
실행 방식웹 브라우저터미널 CLI
파일 접근없음 (복사-붙여넣기)직접 읽기/편집
명령 실행없음셸 명령 실행
작업 단위단일 응답여러 단계 자율 실행
프로젝트 이해제한적CLAUDE.md + 파일 직접 탐색

설치와 시작

# 설치
npm install -g @anthropic-ai/claude-code

# 프로젝트 디렉토리에서 시작
cd my-project
claude

# 특정 작업 바로 시작
claude "테스트 커버리지 80% 이상으로 높여줘"

처음 실행하면 Anthropic 계정으로 로그인합니다. 이후 프로젝트 디렉토리에서 claude를 실행하면 됩니다.

어디에 쓰는가

  • 버그 수정: "이 에러 고쳐줘" → 파일 탐색 후 수정
  • 리팩토링: "이 함수 분리해줘" → 영향 범위 파악 후 안전하게 분리
  • 기능 추가: "로그인 기능 추가해줘" → 관련 파일 파악 후 구현
  • 코드 리뷰: "이 PR 검토해줘" → diff 분석 후 피드백
  • 문서화: "이 API 문서 작성해줘" → 코드 읽고 문서 생성

단순 반복 작업부터 복잡한 리팩토링까지, 터미널을 떠나지 않고 처리할 수 있습니다.

다음 글 →Configuration — Claude Code 설정 파일 구조