Claude Code (CLI 코딩 에이전트) 이해하기

이 글은 앤트로픽이 운영하는 code.claude.com/docs와 platform.claude.com/docs의 Claude Code 공식 가이드를 한국 비개발자 입문자가 보기 편하게 정리한 글입니다.

🤔 ChatGPT한테 코딩 시키는 거랑 뭐가 다른가요?

비개발자도 ChatGPT에 코드를 부탁해 본 경험이 있을 겁니다. "이런 기능 만들고 싶어"라고 했더니 코드를 길게 답으로 돌려줍니다. 다음 단계가 문제입니다. 그 코드를 어디에 넣어야 할지, 어떻게 실행해야 할지를 다시 사람이 해야 합니다.

Claude Code는 이 다음 단계까지 같이 처리하는 도구입니다. 사용자의 컴퓨터 안에 들어와 파일을 직접 읽고, 수정하고, 명령을 실행합니다.

🔑 Claude Code, 한 줄 정의

Claude Code는 앤트로픽이 만든 에이전트형 코딩 도구(agentic coding tool)입니다. 공식 문서는 다음과 같이 설명합니다.

“

"Claude Code is an agentic coding tool that reads your codebase, edits files, runs commands, and integrates with your development tools. Available in your terminal, IDE, desktop app, and browser."

핵심은 "에이전트형"이라는 단어입니다. 답을 돌려주고 끝나는 도구가 아니라, 코드베이스 안에 들어와 일을 직접 진행하는 도구라는 뜻입니다.

🌐 어디서 쓸 수 있나요?

Claude Code는 한 엔진을 다섯 가지 환경에서 같이 씁니다.

• 터미널 (CLI): macOS, Linux, Windows에서 명령어로 실행
• VS Code 확장: 에디터 안에서 인라인 diff, @-mention, 계획 검토
• JetBrains 플러그인: IntelliJ, PyCharm, WebStorm 등 IDE 통합
• 데스크톱 앱: macOS, Windows 네이티브 앱, 여러 세션 동시 실행
• 웹: claude.ai/code에서 브라우저로 실행, 모바일 iOS 앱 연동

같은 CLAUDE.md 파일, 설정, MCP 서버가 어느 환경에서나 그대로 작동합니다. 한 환경에서 시작한 작업을 다른 환경에서 이어 갈 수 있습니다.

🛠️ Claude Code가 잘하는 9가지

공식 문서에 정리된 활용 영역은 다음과 같습니다.

• 반복 작업 자동화: 테스트 작성, lint 오류 수정, 의존성 업데이트, 릴리스 노트 작성
• 기능 추가, 버그 수정: 자연어 요청 → 다중 파일 코드 작성 → 검증
• 커밋, PR 생성: git 통합으로 변경 사항 stage, 커밋 메시지 작성, 브랜치 생성, PR 오픈
• MCP 도구 연동: 디자인 문서, 이슈 트래커, DB, 슬랙을 모두 한 자리에서
• CLAUDE.md, Skills, Hooks 커스터마이징: 회사 표준, 작업 흐름, 자동 검사 등록
• 에이전트 팀 운영: 여러 Subagent가 작업 부분을 나눠 동시 진행
• CLI 파이프, 스크립트: Unix 철학을 따라 다른 명령과 체인 가능
• Routines (스케줄): 매일 PR 리뷰, 야간 CI 실패 분석 같은 정기 작업
• Remote Control, Channels: 외부에서 모바일, 메신저로 진행 상황 조작

🧰 비개발자가 쉽게 시작하는 3가지 사용처

코드를 직접 안 짜는 사람도 Claude Code의 일부 능력을 곧장 쓸 수 있습니다.

1. 폴더 안 파일 일괄 정리

• "Downloads 폴더에서 PDF만 따로 모아 연도별로 분류해 줘"
• 사진, 자료 파일을 규칙대로 정리.

2. 데이터 변환

• "이 폴더 안의 CSV를 모두 합쳐서 한 시트로"
• 표 형식 변환, 정리.

3. 문서 일괄 작업

• "이 마크다운 파일들에서 오타를 모두 찾아 줘"
• 회사 자료, 블로그 글 일괄 검수.

설치 첫걸음 클래스에서 비개발자도 따라할 수 있는 설치 단계를 다룹니다.

🔗 코스 3에서 다루는 다른 7가지

이 코스의 나머지 클래스는 Claude Code를 깊게 쓰는 데 필요한 7가지 개념을 차례로 다룹니다.

• 설치 첫걸음
• 슬래시 명령
• Plan Mode
• Subagents
• Hooks
• MCP
• Memory와 CLAUDE.md

이 일곱이 Claude Code를 회사 표준 도구로 만드는 핵심입니다.

💼 Claude Code가 가장 큰 효과를 내는 자리

1. 다중 파일 코드 작업

• "이 프로젝트에 로그인 기능 붙여줘" → 여러 파일을 한 번에 작업.

2. 반복 작업 자동화

• 매주 같은 형식의 코드 검수, 릴리스 노트, 테스트 작성.

3. 외부 도구 연동 작업

• MCP로 노션, 슬랙, DB, Figma를 한 자리에서 다룸.

4. CI 자동화

• GitHub Actions, GitLab CI에 Claude Code를 끼워 넣어 PR 리뷰 자동화.

⚠️ 시작하기 전 알아둘 점

1. 유료 구독 필요

• 대부분 환경에서 Claude 구독 또는 Anthropic Console 계정이 필요합니다(2026년 4월 기준). 일부 무료 시도는 가능하지만 실무 사용은 유료 플랜이 표준입니다.

2. 권한 관리

• Claude Code는 사용자의 컴퓨터에 들어와 파일을 직접 다룹니다. 어떤 폴더, 도구를 허용할지 설치 단계에서 한 번 점검하세요.

3. 책임감 있는 AI 사용의 검증 흐름

• 자동화 결과를 그대로 사용하지 말고, 사람이 검수하는 단계를 흐름에 넣으세요.

📋 3줄 요약

1. Claude Code는 앤트로픽이 만든 에이전트형 코딩 도구로 코드베이스를 직접 읽고 고치며 명령까지 실행합니다.

2. 터미널과 VS Code, JetBrains, 데스크톱 앱, 웹이 같은 엔진을 쓰기 때문에 환경을 옮겨도 쓰는 방법이 같습니다.

3. 테스트 작성과 의존성 업데이트 같은 반복 작업을 맡기고 커밋과 PR 생성까지 git 안에서 이어서 처리합니다.

📚 참고 자료

• Claude Code overview: https://code.claude.com/docs/en/overview
• Claude Code 공식 페이지: https://code.claude.com/
• Anthropic Academy: https://www.anthropic.com/learn