1-1. Claude Code 소개 + 설치
이번 클립에서는 Claude Code가 무엇이고, 기존 AI 도구와 어떻게 다른지, 그리고 직접 설치해서 첫 명령을 내리는 것까지 다룹니다.
1. Claude Code란?
터미널에서 동작하는 AI 코딩 비서입니다.
기존의 ChatGPT나 Claude 웹은 대화만 가능했습니다. 코드를 받아도 사용자가 직접 복사·붙여넣기로 옮겨야 했습니다. Claude Code는 다음 세 가지 능력으로 그 단계를 자동화합니다.
파일 읽기/쓰기
프로젝트 폴더의 파일을 직접 읽고 수정
명령어 실행
패키지 설치, 서버 실행, 테스트를 스스로 수행
외부 서비스 연결
MCP 프로토콜로 n8n·DB·API와 통신
한 문장으로 — 대화만 하는 AI가 아니라 실제로 행동(ACT)하는 AI입니다.
2. 기존 AI 도구와의 차이
같은 요청 "n8n 워크플로우 만들어줘"가 두 도구에서 어떻게 처리되는지 비교해 보겠습니다.
채팅창 왕복
- 코드를 채팅창에 출력
- 사용자가 복사 → n8n에 붙여넣기
- 오류 나면 다시 채팅으로 돌아가 질문
직접 실행
- n8n 서버에 직접 접속
- 워크플로우를 자동 생성
- 오류는 스스로 확인하고 수정
이 강의 전체에서 "행동하는 AI" 능력을 활용합니다.
3. 사전 준비 — 계정과 플랜
Claude Code 사용에 필요한 단 한 가지: Claude Pro 또는 Max 플랜.
| 플랜 | 사용 가능 |
|---|---|
| Free | ❌ |
| Pro | ✅ (최소 사양) |
| Max | ✅ (권장) |
claude.ai에서 가입 또는 업그레이드 후 다음 단계로 진행합니다.
4. 설치 — 한 줄이면 끝
터미널에 다음 명령을 입력합니다.
curl -fsSL https://claude.ai/install.sh | bash설치 확인:
claude처음 실행하면 브라우저가 자동으로 열려 Claude 계정 인증을 요청합니다. 권한을 허용하면 터미널에 프롬프트가 나타나고, 곧바로 Claude Code와 대화할 수 있습니다.
5. IDE 선택 — 터미널 vs AntiGravity
- 터미널: 기본·가장 가벼움.
claude명령으로 즉시 시작. - AntiGravity IDE: Google의 AI 전용 IDE. VS Code 동일 인터페이스 + Agent Manager로 여러 에이전트 동시 실행. antigravity.google 무료 다운로드.
이 강의는 터미널 기반으로 진행합니다. AntiGravity IDE를 사용해도 핵심 동작은 동일합니다.
6. 첫 실행
프로젝트 폴더 생성 후 진입
claude 실행
자연어로 첫 명령
mkdir my-project && cd my-project
claude명령 예시 — 프롬프트에 입력해 보세요.
안녕→인사 응답 (기본 대화)이 폴더의 파일 목록을 보여줘→ls 자동 실행★ 핵심 — 권한 시스템. Claude Code는 명령을 실행하기 전 항상 허용 여부를 묻습니다. AI가 마음대로 시스템을 건드리지 못하게 하는 안전장치입니다.
7. 전체 구조 — Claude Code × n8n
이 강의에서 만들 시스템의 흐름:
사용자가 자연어로 명령 → Claude Code가 의도를 파악 → JSON 파일을 수정하거나 n8n 서버 API를 호출해 실행합니다.
8. 마무리
다음 클립에서는 n8n 서버를 Docker로 설치하고 API 키를 발급해 Claude Code와 연결하는 과정을 진행합니다.