1부: Claude Code 활용하기

터미널에서 AI와 함께하는 개발 워크플로우

Intro

Claude Code 활용하기

터미널 환경에서 AI와 협업하는 새로운 개발 경험. Claude Code는 단순한 채팅이 아니라, 실제로 파일을 수정하고 명령을 실행하며 여러분과 함께 작업합니다.

오늘의 포인트

  • • Claude Code가 무엇이고 어떻게 작동하는지
  • • 터미널(CLI) 기본기 - Claude Code의 실행 환경
  • • AI와 CLI가 만나면 생기는 시너지
환경: macOS 터미널 / Windows PowerShell + Node.js 18+ + Claude Code
Claude Code 개요

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 철학

구성 가능하고 스크립트 가능하며, 파이프라인과 자동화에 완벽합니다

엔터프라이즈 준비

엔터프라이즈급 보안, 개인정보 보호, 규정 준수가 내장되어 있습니다

Claude Code는 Node.js 기반으로 실행됩니다. 다음 슬라이드에서 자세히 설명합니다.
자세한 내용: Claude Code 공식 문서
기반 기술

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대 장점

속도 · 자동화 · 조합. 손이 키보드 위에 있는 동안 커서를 찾지 않아도 되고, 명령을 저장해두면 매일 같은 작업을 한 번에 끝낼 수 있습니다.

실전 1

바로 실행해보는 명령 – 앱/웹 열기

한 줄 명령으로 어떤 앱이든, 어떤 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
Windows에서 Start-Process cmdlet도 사용 가능합니다: Start-Process "chrome"

💡 자주 쓰는 명령은 alias로 짧게 만들면 더 빨라집니다.

실전 2

파일 · 폴더 기본기

위치 파악 → 목록 확인 → 파일 다루기의 흐름만 익혀도 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)는 되돌릴 수 없습니다. 삭제 전 경로를 꼭 확인하세요.
실전 3

파이프 & 리다이렉션

출력 결과를 다른 명령의 입력으로 넘기면 강력한 자동화가 시작됩니다.

# 리다이렉션
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분 데모 시나리오

  1. open -a "Google Chrome" — “마우스 없이도 번개처럼 뜹니다.”
  2. echo "안녕하세요" > hello.txt && open -a "Visual Studio Code" hello.txt
  3. ps aux | grep Chrome > chrome.txt && open chrome.txt
  4. 마무리: “이 줄을 스크립트로 저장하면 매일 클릭 대신 한 번에 끝납니다.”
실습

실습 미션 (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
PowerShell은 대부분의 Unix 명령어를 별칭(alias)으로 지원합니다. 필요한 부분만 복사해두면 실습 시간에 든든한 참고서가 됩니다!
정리

Claude Code = CLI × AI

오늘 익힌 "파일 만들기 · 수정 · 실행" 흐름에 AI가 더해지면:

🛠️ CLI로 할 수 있는 것

  • • 파일/폴더 생성, 수정, 삭제
  • • 명령어 조합 (파이프)
  • • 스크립트 자동화
  • • 앱 실행, 프로세스 관리

✨ Claude Code가 해주는 것

  • • 자연어로 명령하면 알아서 실행
  • • 코드베이스 전체 이해하며 작업
  • • 복잡한 명령어 조합 자동 생성
  • • 디버깅, 리팩토링, 테스트까지

🚀 핵심 메시지

여러분은 "무엇을" 할지만 말하고, Claude Code가 터미널에서 "어떻게"를 실행합니다. CLI의 강력함과 AI의 지능이 만나 개발 생산성이 폭발적으로 향상됩니다!

지금 바로 npm install -g @anthropic-ai/claude-code로 시작해보세요!