[클로드 시리즈_23] 터미널이 뭔지도 몰랐던 내가 Claude Code로 코딩을 시작한 방법

강호종 AI 길라잡이 강사 | 2026.05.28

---

핵심 결론 먼저

Claude Code는 터미널(CLI)과 데스크톱 앱, 두 가지 방식으로 쓸 수 있습니다. 코딩 경험이 없어도 됩니다. 이 글 하나로 터미널이 무엇인지, Claude Code를 어떻게 설치하는지, 그리고 AI와 첫 대화를 어떻게 시작하는지까지 한 번에 정리합니다. '터미널'이라는 단어만 들어도 막막했던 분들을 위해 가장 기본 개념부터 실전 설치까지 단계별로 안내합니다.

---

1. Claude Code 시작 전 꼭 알아야 할 핵심 개념

환경 및 도구

Claude Code를 쓰기 전에 딱 세 가지 개념만 이해하면 됩니다.

터미널(Terminal)은 마우스 클릭 대신 텍스트 명령어로 컴퓨터를 직접 조작하는 창입니다. 작업을 자동화할 때 필수적인 도구입니다. Windows에서는 '명령 프롬프트' 또는 'PowerShell', Mac에서는 '터미널' 앱이 여기에 해당합니다.

경로(Path)는 컴퓨터 안에서 파일이 있는 '주소'입니다.

구분	설명	예시
절대 경로	최상위(Root)부터 전체 주소	/Users/kim/Documents/report.pdf
상대 경로	지금 내가 있는 폴더 기준 주소	./report.pdf

CLI(Command Line Interface)는 터미널을 통해 텍스트로 컴퓨터와 소통하는 방식 그 자체를 의미합니다.

---

데이터와 서식 — 마크다운과 JSON

마크다운(Markdown)은 ##, -, 1.2.3., ** 처럼 간단한 기호로 문서 구조를 잡는 방법입니다.
Claude에게 지시를 내릴 때 마크다운 형식으로 작성하면 가독성이 비약적으로 높아집니다.

JSON은 데이터를 저장하는 규격화된 텍스트 형식입니다. Claude Code의 설정 파일(settings.json) 등에서 주로 쓰이며, 아래와 같은 구조를 가집니다.

json
{ "이름": "강민서", "나이": "40", "성별": "남" }

---

AI 모델(Model) — Claude의 두뇌를 선택하다

Claude Code에서 사용하는 AI 모델은 용도에 따라 세 가지로 구분됩니다.

모델	특징	추천 용도
Haiku	가볍고 빠름	단순 질문, 서브에이전트 작업
Sonnet	속도와 성능의 균형	표준 코딩, 버그 테스트 (기본값 추천)
Opus	가장 강력한 추론	복잡한 버그 해결, PRD 작성, 아키텍처 설계

💡 강의 수강생에게는 Sonnet을 기본으로 권장합니다. 일상적인 코딩 작업에서 속도와 품질의 균형이 가장 뛰어납니다.

 

---

기술 및 개발 환경 — API와 환경변수

API(Application Programming Interface)는 프로그램 간 기능을 연결해 주는 통로입니다. 환경변수(Environment Variable)는 API 키처럼 민감한 비밀번호를 코드에 직접 적지 않고 컴퓨터 시스템에 안전하게 저장해두는 공간입니다.

---

2. Claude Code 설치 가이드 — 데스크톱 앱 vs 터미널 CLI

Claude Code는 데스크톱 앱과 터미널(CLI) 두 가지 환경에서 사용할 수 있습니다. 두 방식 모두 파일에 직접 접근하여 코딩과 개발을 수행한다는 목적은 같습니다. 코딩 스타일과 작업 환경에 따라 더 편한 도구를 선택하면 됩니다.

📌 팩트체크 확인: 데스크톱 앱은 macOS · Windows만 지원하며, Linux는 지원하지 않습니다.
                              (공식 문서 기준, 2026년 5월)

구분	🖥 데스크톱 앱 (Code 탭)	⬛ 터미널 CLI (Command Line)
작업 환경	메신저처럼 친숙하고 시각적인 UI (GUI)	검은 배경에 텍스트와 명령어로만 이루어진 화면
작업 방식	마우스로 클릭하여 프로젝트 폴더를 지정하고, AI의 코드 수정 제안을 버튼으로 쉽게 승인/거부	현재 터미널이 위치한 폴더 기준으로 작동하며, 키보드 타이핑(Y/N)만으로 모든 작업 제어
특징 및 장점	코드가 색상별로 하이라이팅되어 읽기 편함. 시각적 diff(변경 내역) 검토, 라이브 앱 미리보기 지원	git, npm, python 등 기존 개발 명령어들과 화면 전환 없이 물 흐르듯 연계해서 작업 가능
추천 대상	"터미널 화면은 아직 너무 낯설어요!" 시각적으로 결과를 확인하는 게 편한 코딩 초보자 및 기획자	"키보드에서 손을 떼고 싶지 않아요!" 터미널 환경에 익숙하고 스크립트 자동화가 필요한 개발자

---

데스크톱 앱 설치 방법

1. claude.ai/download 에서 운영체제에 맞는 설치 파일 다운로드
2. 설치 완료 후 Anthropic 계정으로 로그인
3. 상단 중앙의 [Code] 탭 클릭

⚠️ 주의: Code 탭 클릭 시 업그레이드 안내가 뜨면 유료 요금제(Pro 이상) 구독이 필요합니다. 데스크톱 앱 내 Code 탭은 별도 Node.js 설치 없이 바로 사용 가능합니다.

---

터미널 CLI 설치 방법

CLI 방식은 두 가지입니다.

방법 1 — 네이티브 설치 (권장, Node.js 불필요)

bash
curl -fsSL https://claude.ai/install.sh | bash

방법 2 — npm 설치 (Node.js 18 이상 필요)

bash
npm install -g @anthropic-ai/claude-code

설치 후 터미널에서 아래 명령어로 실행합니다.

bash
claude

브라우저가 열리면 Anthropic 계정으로 로그인을 진행합니다.

---

3. 첫 대화 시작하기 — AI와 첫 인사 나누기

설치가 끝났다면 이제 AI와 첫 인사를 나눌 차례입니다.

데스크톱 앱: 로그인 후 상단의 [Code] 탭을 선택합니다. (로컬 파일 접근 권한이 활성화됩니다.)

CLI: 터미널 창에 claude를 입력하고 엔터를 칩니다. 브라우저가 열리면 로그인을 진행합니다.

첫 인사 프롬프트 예시:

안녕! 앞으로 내 코딩 작업을 도와줘.

---

안전한 사용을 위한 '권한' 확인

Claude Code가 내 파일을 수정하려고 할 때 터미널이나 앱에서 [Y/N]과 같은 확인 메시지를 띄웁니다.

입력의미

Y	승인 (작업 진행)
N	거부 (작업 중단)

💡 처음에는 AI가 어떤 파일을 어떻게 바꾸는지 꼼꼼히 읽어보고 승인하는 습관을 들이는 것이 좋습니다. 특히 중요한 프로젝트 폴더에서는 Auto-accept 모드보다 Ask(확인 요청) 모드로 시작하기를 권장합니다.

---

4. 자주 쓰는 슬래시(/) 명령어 모음

Claude Code 안에서 / 로 시작하는 명령어로 작업 환경을 빠르게 조작할 수 있습니다.

명령어	기능
/clear	현재 대화 세션 초기화 (컨텍스트 리셋)
/compact	대화 내용을 압축하여 토큰 절약
/plan	계획 모드 진입 (코드 수정 없이 분석만)
/hooks	현재 설정된 훅(Hook) 목록 확인
/mcp	연결된 MCP 서버 목록 및 관리
/cost	현재 세션 토큰 사용량 및 비용 확인

---

5. Q&A — 자주 묻는 질문 5가지

Q1. 코딩을 전혀 모르는데 Claude Code를 써도 되나요?

됩니다. Claude Code는 코드를 직접 작성하지 않아도 자연어로 지시하면 AI가 대신 코드를 작성하고 수정해 줍니다. 다만 터미널, 경로, 파일 구조 같은 기본 개념은 이 글에서 설명한 내용 정도는 이해하고 있어야 AI 결과물을 제대로 검토할 수 있습니다.

Q2. 데스크톱 앱과 CLI 중 어느 것을 먼저 써야 하나요?

처음이라면 데스크톱 앱의 Code 탭부터 시작하는 것을 권장합니다. 시각적으로 변경 내역을 확인하며 승인/거부할 수 있어서 초보자가 실수할 가능성이 낮습니다. 터미널 환경에 익숙해지면 CLI로 전환하면 됩니다.

Q3. Node.js는 꼭 설치해야 하나요?

데스크톱 앱을 사용한다면 불필요합니다. 앱 안에 이미 포함되어 있습니다. CLI를 npm으로 설치할 경우에만 Node.js 18 이상이 필요합니다. 네이티브 설치(curl 방식)를 사용하면 CLI도 Node.js 없이 바로 설치됩니다.

Q4. 모델은 어떻게 바꾸나요?

Claude Code 대화창에서 "Sonnet 모델로 바꿔줘" 또는 "Opus로 전환해줘"라고 자연어로 요청하거나, 설정(Settings)에서 모델을 직접 선택할 수 있습니다. 일반 코딩 작업은 Sonnet, 복잡한 설계나 아키텍처 분석은 Opus, 단순 반복 작업은 Haiku를 사용하는 것이 비용 대비 효율적입니다.

Q5. Claude Code와 claude.ai 채팅창의 차이는 무엇인가요?

claude.ai는 브라우저 기반 대화 도구로, 내 컴퓨터 파일에 직접 접근하지 못합니다. Claude Code는 내 컴퓨터의 실제 파일을 읽고, 수정하고, 터미널 명령어를 실행할 수 있는 코딩 에이전트입니다. 같은 Claude AI를 쓰지만 실제로 할 수 있는 일의 범위가 완전히 다릅니다.

---

마무리 — 오늘 당장 해볼 수 있는 3가지 액션

1. 데스크톱 앱 설치 — claude.ai/download 에서 5분이면 설치 완료
2. Code 탭에서 첫 대화 — "안녕! 앞으로 내 코딩 작업을 도와줘." 한 문장으로 시작
3. Y/N 권한 확인 습관 들이기 — AI가 어떤 파일을 수정하는지 먼저 읽고 승인

터미널이 낯설어도 괜찮습니다. Claude Code는 그 진입 장벽을 낮춰주기 위해 설계된 도구입니다. 처음 써보고 나서 어떤 점이 편하거나 막혔는지 댓글로 공유해 주시면, 다음 편에서 그 경험을 직접 다뤄보겠습니다!

다음 편 예고: [클로드 코드 시리즈] 서브에이전트(Subagents) & 에이전트 팀 — AI 직원을 고용하는 방법

---

작성자 | 강호종 AI 길라잡이 강사

생성형 AI 활용 업무 효율화 전문강사 · 디지털융합교육원 지도강사
젠스파크 AI 전문강사 · (사)한국AINFT협회 이사
저서: 『생성형 AI 활용 업무혁신』(2026) · 『이것이 GEO마케팅이다』(2026)
📞 010-9912-9934 · 📧 art386@naver.com · blog.naver.com/art386 · aiart386.tistory.com

---

#ClaudeCode설치 #클로드코드 #터미널설치 #AI코딩 #Claude코드 #ClaudeCode #터미널초보 #생성형AI #AI업무자동화 #강호종강사 #AI길라잡이 #NodeJS #데스크톱앱 #CLI설치 #코딩입문 #바이브코딩 #Anthropic #Haiku #Sonnet #Opus