Claude Code 활용하기
터미널 환경에서 AI와 협업하는 새로운 개발 경험. Claude Code는 단순한 채팅이 아니라, 실제로 파일을 수정하고 명령을 실행하며 여러분과 함께 작업합니다.
오늘의 포인트
- • Claude Code가 무엇이고 어떻게 작동하는지
- • 터미널(CLI) 기본기 - Claude Code의 실행 환경
- • AI와 CLI가 만나면 생기는 시너지
Claude Code란?
터미널에서 작동하며 아이디어를 그 어느 때보다 빠르게 코드로 변환하는 Anthropic의 에이전틱 코딩 도구. Node.js 기반으로 파일 시스템을 직접 조작하고 명령어를 실행합니다.
🚀 30초 만에 시작하기
전제 조건:
- Node.js 18 이상
- Claude.ai 또는 Claude Console 계정
# Claude Code 설치
npm install -g @anthropic-ai/claude-code
# 프로젝트로 이동
cd your-awesome-project
# Claude와 함께 코딩 시작
claude
✨ 주요 기능
- 설명으로부터 기능 구축: 평범한 영어로 구축할 것을 설명
- 디버그 및 문제 해결: 버그 설명이나 오류 메시지로 문제 해결
- 모든 코드베이스 탐색: 전체 프로젝트 구조 인식 및 외부 데이터 연동
- 지루한 작업 자동화: 린트 문제 해결, 병합 충돌 해결, 릴리스 노트 작성
💡 개발자들이 Claude Code를 사랑하는 이유
터미널에서 작동
또 다른 채팅 창이나 IDE가 아닌, 이미 사랑하는 도구와 함께 작업하는 곳에서 만납니다
행동을 취함
파일을 직접 편집하고, 명령을 실행하며, 커밋을 생성할 수 있습니다
Unix 철학
구성 가능하고 스크립트 가능하며, 파이프라인과 자동화에 완벽합니다
엔터프라이즈 준비
엔터프라이즈급 보안, 개인정보 보호, 규정 준수가 내장되어 있습니다
Node.js & AI 생태계
왜 Claude Code를 비롯한 많은 AI 도구들이 Node.js를 사용할까요?
Node.js란?
브라우저에서만 동작하던 JavaScript가 브라우저 밖으로 나와 여러분의 컴퓨터에서 직접 실행되는 환경입니다.
🌐 브라우저 JavaScript
✗ 파일 접근 불가
✗ 시스템 명령 실행 불가
✓ 웹페이지만 조작
💻 Node.js
✓ 파일 읽기/쓰기
✓ 시스템 명령 실행
✓ 서버 구축 가능
🤖 왜 AI 도구들이 Node.js를 선택할까?
1. npm 생태계
세계 최대 패키지 저장소(npm)로 100만 개 이상의 라이브러리를 간단히 설치 가능
2. 크로스 플랫폼
Windows, macOS, Linux 모두에서 동일하게 작동
3. 빠른 개발
JavaScript의 단순함으로 프로토타입을 빠르게 개발
4. 대중성
가장 인기 있는 프로그래밍 언어 중 하나로 사용자 진입장벽 낮음
# Node.js 기반 AI 도구 설치 예시
npm install -g @anthropic-ai/claude-code
npm install -g vercel # AI 웹앱 배포
npm install -g @openai/chatgpt-cli
npm install langchain # AI 체인 프레임워크
npm은 Node.js의 패키지 매니저로, npm install -g로 전역 도구를 설치할 수 있습니다.
터미널(CLI)이 뭔가요?
- • CLI(Command Line Interface) = 키보드로 명령을 입력해 컴퓨터를 조작하는 방식
- • 반복 작업이 빠르고, 스크립트로 자동화하기 쉽습니다.
- • 작은 명령을
|파이프로 묶어 "내 도구"처럼 조합할 수 있습니다.
💡 왜 터미널을 알아야 할까요?
Claude Code는 터미널 환경에서 동작합니다. CLI에서 할 수 있는 것들을 이해하면, AI가 어떻게 여러분을 도와줄 수 있는지 명확해집니다.
CLI의 3대 장점
속도 · 자동화 · 조합. 손이 키보드 위에 있는 동안 커서를 찾지 않아도 되고, 명령을 저장해두면 매일 같은 작업을 한 번에 끝낼 수 있습니다.
바로 실행해보는 명령 – 앱/웹 열기
한 줄 명령으로 어떤 앱이든, 어떤 URL이든 즉시 실행할 수 있습니다.
macOS (Terminal)
# 앱 열기
open -a "Google Chrome"
open -a "Visual Studio Code"
open . # Finder로 현재 폴더
# 웹/파일 열기
open "https://example.com"
open -a "Google Chrome" index.html
Windows (PowerShell)
# 앱 열기
start chrome
start code
start . # 탐색기로 현재 폴더
# 웹/파일 열기
start https://example.com
start chrome index.html
Start-Process cmdlet도 사용 가능합니다: Start-Process "chrome"
💡 자주 쓰는 명령은 alias로 짧게 만들면 더 빨라집니다.
파일 · 폴더 기본기
위치 파악 → 목록 확인 → 파일 다루기의 흐름만 익혀도 CLI가 훨씬 친숙해집니다.
macOS / Linux
pwd # 현재 위치
ls -la # 파일 목록(숨김 포함)
mkdir demo
echo "Hello" > note.txt
cp note.txt demo/
mv note.txt demo/
rm demo/note.txt
cat demo/note.txt
grep "Hello" note.txt
🪟 Windows PowerShell
pwd # 현재 위치
ls # 파일 목록
dir # 또는 dir 사용
mkdir demo
echo "Hello" > note.txt
cp note.txt demo/
mv note.txt demo/
rm demo/note.txt
cat demo/note.txt
Select-String "Hello" note.txt
💡 PowerShell 팁
PowerShell은 Unix 명령어 별칭(alias)을 지원하여 pwd, ls, cp, mv, rm 등을 바로 사용할 수 있습니다. 단, grep 대신 Select-String을 사용합니다.
rm -rf (또는 rm -Recurse -Force)는 되돌릴 수 없습니다. 삭제 전 경로를 꼭 확인하세요.
파이프 & 리다이렉션
출력 결과를 다른 명령의 입력으로 넘기면 강력한 자동화가 시작됩니다.
# 리다이렉션
echo "첫 줄" > log.txt
echo "둘째 줄" >> log.txt
# 파이프 (앞 명령 출력 → 다음 명령 입력)
cat log.txt | grep "첫"
# 예시: 크롬 프로세스 목록 저장
ps aux | grep "Chrome" > chrome-process.txt
“앞 명령 출력 = 뒤 명령 입력”이라는 규칙만 이해하면 어떤 조합도 가능합니다.
작은 명령 → 조합 예시
A. 빠른 메모 만들기
echo "- 회의 10:30" > todo.md
open -a "Visual Studio Code" todo.md
B. HTML 작성 → 브라우저 미리보기
cat > index.html << 'HTML'
Demo
터미널에서 만든 페이지
HTML
open -a "Google Chrome" index.html
C. 로그에서 에러만 추출
printf "INFO ok\nERROR fail A\nINFO ok\nERROR fail B\n" > app.log
grep "ERROR" app.log > errors.txt
open -a "Visual Studio Code" errors.txt
3분 데모 시나리오
open -a "Google Chrome"— “마우스 없이도 번개처럼 뜹니다.”echo "안녕하세요" > hello.txt && open -a "Visual Studio Code" hello.txtps aux | grep Chrome > chrome.txt && open chrome.txt- 마무리: “이 줄을 스크립트로 저장하면 매일 클릭 대신 한 번에 끝납니다.”
실습 미션 (5분)
미션 1: notes/today.md 만들기
mkdir -p notes
printf "해야 할 일\n- AI 실습\n- 산책\n" > notes/today.md
open -a "Visual Studio Code" notes/today.md
미션 2: 로그 요약
printf "INFO start\nWARN low memory\nERROR crash\nINFO end\n" > app.log
egrep "WARN|ERROR" app.log > report.txt
cat report.txt
미션 3: HTML → 브라우저
cat > index.html << 'HTML'
CLI → HTML → 브라우저
HTML
open -a "Google Chrome" index.html
왜 터미널을 쓰나요?
“반복 작업을 한 줄로, 작은 도구를 파이프로 연결해 클릭보다 빠르고 다시 쓰기 쉬운 방식으로 일하기 위해.”
- • 동일 작업 반복 → 스크립트화로 시간 절약
- • 서버·클라우드 환경의 기본 통로는 CLI
- • Git, 빌드, 자동화 파이프라인과 자연스럽게 연결
CLI 치트시트
macOS / Linux
# 길잡이
pwd
ls -la
cd 폴더명
# 파일/폴더
mkdir 이름
echo "텍스트" > 파일
cp 원본 대상
mv 원본 대상
rm 파일
rm -rf 폴더
# 보기/검색
cat 파일
grep "패턴" 파일
head -n 10 파일
tail -n 20 파일
# 파이프
ps aux | grep Chrome
cmd1 | cmd2 > 결과.txt
# 앱 열기
open .
open -a "Chrome"
open index.html
🪟 Windows PowerShell
# 길잡이
pwd
ls, dir
cd 폴더명
# 파일/폴더
mkdir 이름
echo "텍스트" > 파일
cp 원본 대상
mv 원본 대상
rm 파일
rm -Recurse 폴더
# 보기/검색
cat 파일
Select-String "패턴" 파일
Get-Content 파일 -Head 10
Get-Content 파일 -Tail 20
# 파이프
Get-Process | Select-String chrome
cmd1 | cmd2 > 결과.txt
# 앱 열기
start .
start chrome
start index.html
Claude Code = CLI × AI
오늘 익힌 "파일 만들기 · 수정 · 실행" 흐름에 AI가 더해지면:
🛠️ CLI로 할 수 있는 것
- • 파일/폴더 생성, 수정, 삭제
- • 명령어 조합 (파이프)
- • 스크립트 자동화
- • 앱 실행, 프로세스 관리
✨ Claude Code가 해주는 것
- • 자연어로 명령하면 알아서 실행
- • 코드베이스 전체 이해하며 작업
- • 복잡한 명령어 조합 자동 생성
- • 디버깅, 리팩토링, 테스트까지
🚀 핵심 메시지
여러분은 "무엇을" 할지만 말하고, Claude Code가 터미널에서 "어떻게"를 실행합니다. CLI의 강력함과 AI의 지능이 만나 개발 생산성이 폭발적으로 향상됩니다!
npm install -g @anthropic-ai/claude-code로 시작해보세요!