클로드 기초 및 활용 강의 클로드 AI교육 접근성 SVIL 18회차

클로드 기초 및 활용 18회: 설치와 첫 실행 — 한 줄로 설치하고 첫 지시 내리기

SVIL - Singularity Visual Intelligence Lab 2026. 08. 01 16 min read

오늘은 손을 움직입니다

16회에서 클로드 코드가 무엇인지 알아봤고, 17회에서 터미널의 정체를 밝혔습니다. 오늘은 실제로 설치하고 첫 지시를 내립니다.

설치는 명령 한 줄입니다. 그 한 줄을 어디에 어떻게 치는지, 그다음 무엇이 벌어지는지를 순서대로 따라가겠습니다.

시작 전 확인 세 가지

① 유료 구독 — 16회에서 말한 대로 클로드 코드는 유료 구독(Pro·Max·Team·Enterprise)이 필요합니다. 무료 요금제에서는 쓸 수 없습니다.

② 터미널을 열 수 있는가 — 17회를 해 보셨다면 됩니다. 아직이라면 17회를 먼저 보고 오세요.

③ 작업 폴더 — 연습용 사본 폴더를 준비하셨다면 좋습니다. 없으면 지금 하나 만드세요.

청록빛 정육면체 세 개가 어두운 문 앞에 나란히 서서 차례를 기다리는 개념 이미지. 시작 전 확인할 세 가지를 나타낸다

오늘의 목표

오늘이 끝나면 할 수 있게 되는 것: 클로드 코드를 설치하고, 로그인하고, 원하는 폴더에서 실행하고, 첫 질문을 던져 답을 받을 수 있게 됩니다.

설치 ① 맥·리눅스

터미널을 열고 아래 한 줄을 그대로 붙여 넣은 뒤 Enter를 누릅니다.

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

설치가 진행되는 동안 글자가 쭉 올라갑니다. 끝나면 다시 프롬프트가 나옵니다.

이 명령이 무엇을 하는지 궁금하시다면 — 공식 사이트에서 설치 프로그램을 받아 실행하는 것입니다. 17회에서 말한 "모르는 명령은 붙여 넣지 말라"는 원칙에 따라, 여기서 밝혀 둡니다.

설치 ② 윈도우

윈도우는 어느 터미널을 쓰느냐에 따라 명령이 다릅니다. 17회에서 배운 구분법을 씁니다.

PowerShell인 경우(프롬프트가 PS C:\로 시작):

irm https://claude.ai/install.ps1 | iex

명령 프롬프트인 경우(프롬프트가 C:\로 시작, PS 없음):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

잘못 골랐을 때의 신호가 명확합니다. The token '&&' is not a valid statement separator라는 오류가 나오면 PowerShell에 CMD용 명령을 친 것이고, 'irm' is not recognized가 나오면 반대입니다. 프롬프트를 다시 보고 맞는 쪽으로 치면 됩니다.

청록빛 막대 하나가 꼭 맞는 어두운 홈으로 매끄럽게 미끄러져 들어가는 개념 이미지. 한 줄 명령으로 설치되는 일을 나타낸다

설치 ③ 다른 방법들

평소 쓰시는 설치 도구가 있다면 그쪽이 편할 수 있습니다.

맥에서 Homebrew를 쓰신다면:

brew install --cask claude-code

윈도우에서 WinGet을 쓰신다면:

winget install Anthropic.ClaudeCode

리눅스에서는 apt·dnf·apk 같은 패키지 관리자로도 설치할 수 있습니다.

다만 알아 두실 것이 하나 있습니다. 앞의 기본 설치 방법은 자동으로 최신 버전을 유지합니다. Homebrew나 WinGet으로 설치하면 직접 갱신 명령을 실행해야 합니다. 초보자라면 기본 방법을 권합니다.

윈도우 사용자를 위한 추가 안내

윈도우에서 클로드 코드를 쓸 때 Git for Windows를 함께 설치하는 것이 권장됩니다. 설치되어 있지 않으면 클로드 코드가 PowerShell을 대신 쓰게 되는데, 일부 작업에서 차이가 생길 수 있습니다.

지금 당장 필요한 것은 아닙니다. 나중에 뭔가 안 될 때 떠올리실 수 있게 적어 둡니다.

설치 확인하기

설치가 끝나면 확인합니다. 터미널에 이렇게 치세요.

claude --version

버전 번호와 함께 (Claude Code)가 출력되면 성공입니다.

"명령을 찾을 수 없다"는 메시지가 나오면 아직 안 된 것입니다. 뒤의 문제 해결 부분을 보세요.

어두운 덩어리 둘레로 청록빛 고리가 켜져 제대로 자리 잡았음을 알리는 개념 이미지. 설치를 확인하는 일을 나타낸다

로그인하기

이제 실행해 봅니다. 터미널에 이렇게만 치세요.

claude

처음 실행하면 로그인 안내가 나옵니다. 화면의 안내를 따라가면 브라우저가 열리고, 거기서 계정으로 로그인하면 됩니다. 3회에서 만든 그 계정입니다.

로그인이 끝나면 다시 로그인할 필요가 없습니다. 자격 정보가 컴퓨터에 저장됩니다.

나중에 계정을 바꾸고 싶으면, 클로드 코드가 실행된 상태에서 /login이라고 입력하면 됩니다.

작업 폴더에서 실행하기

여기가 중요합니다. 클로드 코드는 "실행한 위치"를 작업 폴더로 삼습니다.

그래서 순서가 이렇습니다.

1단계: 17회에서 배운 cd로 작업할 폴더로 이동합니다.

cd /path/to/your/project

2단계: 그 자리에서 실행합니다.

claude

실행하면 화면 위쪽에 버전, 현재 모델, 작업 폴더가 표시됩니다. 작업 폴더가 의도한 곳이 맞는지 반드시 확인하세요. 엉뚱한 폴더에서 시작하면 엉뚱한 파일을 다루게 됩니다.

청록빛 테두리로 표시된 어두운 구역 한가운데에서 정육면체가 밝게 켜지는 개념 이미지. 작업 폴더에서 실행하는 일을 나타낸다

첫 질문 던지기

이제 대화 상태입니다. 채팅과 똑같이 한국어로 말하면 됩니다.

첫 질문으로 이걸 권합니다.

"이 폴더에 뭐가 들어 있는지 알려 줘."

클로드가 폴더를 살펴보고 무엇이 있는지 정리해 줍니다. 파일을 하나도 올리지 않았는데 내용을 아는 것 — 이게 16회에서 말한 차이입니다.

다음 질문도 해 보세요.

"이 파일들이 어떤 용도인지 짐작해서 설명해 줘."

알아 두면 좋은 명령 여섯 개

클로드 코드 안에서 슬래시(/)로 시작하는 명령들이 있습니다. 오늘은 여섯 개만 익힙니다.

/help — 쓸 수 있는 명령 목록을 보여 줍니다. 막히면 이걸 먼저
/clear — 대화 내용을 비웁니다. 주제가 바뀔 때(7회 참고)
/resume — 이전 대화를 이어서 합니다
/login — 계정을 바꾸거나 다시 로그인합니다
/exit — 클로드 코드를 종료합니다(Ctrl + D 두 번도 같습니다)
슬래시(/)만 입력 — 전체 명령 목록이 뜹니다

명령어는 22·23회에서 본격적으로 다룹니다. 오늘은 /help와 /exit만 기억하셔도 충분합니다.

폭이 서로 다른 청록빛 막대 여섯 개가 각자의 어두운 받침에 꽂혀 나란한 개념 이미지. 알아 두면 좋은 명령 여섯 개를 나타낸다

터미널에서 바로 쓰는 형태들

클로드 코드를 실행하는 방식도 여러 가지입니다.

claude — 대화 모드로 시작(가장 일반적)
claude -c — 이 폴더에서 했던 가장 최근 대화를 이어서
claude -r — 이전 대화 목록에서 골라 이어서
claude -p "질문" — 한 번만 묻고 바로 끝냅니다

초보자에게 유용한 것은 claude -c입니다. 어제 하던 작업을 오늘 이어서 할 때 씁니다.

파일을 고칠 때 벌어지는 일

16회에서 예고한 부분입니다. 파일을 읽는 것은 그냥 하지만, 고치는 작업은 다릅니다.

클로드가 파일을 수정하려 하면 무엇을 어떻게 바꿀지 먼저 보여 주고 허락을 구합니다. 여러분이 승인해야 실제로 바뀝니다.

이 동작 방식은 권한 모드에 따라 달라집니다. 기본 모드에서는 매번 물어보고, 다른 모드에서는 자동으로 승인하거나, 아예 제안만 하고 손대지 않습니다.

Shift + Tab을 누르면 모드가 바뀝니다. 지금은 기본 모드 그대로 두세요. 20회에서 자세히 다루겠습니다.

어두운 덩어리와 청록빛 덩어리가 밝은 경계선을 사이에 두고 나란히 놓인 개념 이미지. 고치기 전과 후를 견주어 보여 주는 일을 나타낸다

따라 하기 ① 설치하고 확인

운영체제에 맞는 설치 명령을 실행하고, claude --version으로 확인하세요.

버전 번호가 나오면 다음 단계로. 안 나오면 아래 문제 해결을 보세요.

따라 하기 ② 연습 폴더에서 실행

16회에서 준비한 연습용 사본 폴더로 이동한 뒤 claude를 실행하세요.

화면 위쪽의 작업 폴더 표시를 확인하는 것을 잊지 마세요. 이 확인 습관이 나중에 사고를 막습니다.

낮은 청록빛 테두리를 두른 얕은 어두운 접시 안에 정육면체 하나가 안전하게 놓인 개념 이미지. 연습용 폴더에서 실행하는 일을 나타낸다

따라 하기 ③ 세 가지 질문

순서대로 물어보세요. 아직 아무것도 고치지 않습니다. 읽기만 시킵니다.

"이 폴더에 뭐가 있는지 알려 줘."
"파일들이 어떤 내용인지 요약해 줘."
"이 중에서 가장 오래된 파일이 뭐야?"

세 번째 질문이 재미있습니다. 클로드가 파일 정보를 확인해서 답합니다. 채팅으로는 할 수 없는 종류의 질문입니다.

따라 하기 ④ 첫 수정 시켜 보기

이제 고치는 작업을 한 번 해 봅니다. 연습용 폴더에서만 하세요.

"이 폴더에 '연습.txt' 파일을 만들고, 안에 오늘 날짜와 '첫 실습'이라고 써 줘."

클로드가 무엇을 할지 보여 주고 물어볼 겁니다. 승인하면 파일이 만들어집니다.

그리고 탐색기로 그 폴더를 열어 확인해 보세요. 파일이 실제로 생겼을 겁니다. 이 순간이 클로드 코드를 이해하는 지점입니다.

어두운 덩어리들이 늘어선 줄에서 딱 하나만 밝은 청록빛으로 새로 바뀐 개념 이미지. 첫 수정을 시켜 보는 일을 나타낸다

따라 하기 ⑤ 종료하고 다시 이어가기

/exit로 종료하세요. 터미널로 돌아옵니다.

그리고 claude -c로 다시 실행해 보세요. 방금 하던 대화가 그대로 이어집니다.

이 흐름을 익혀 두면 며칠에 걸친 작업도 편해집니다.

문제 해결 ① "설치 명령이 실패해요"

확인 순서입니다.

① 터미널 종류 — 윈도우라면 PS 표시를 확인하고 맞는 명령을 쓰세요. 앞에서 설명한 오류 메시지가 신호입니다.
② 인터넷 연결 — 설치 파일을 받아야 하므로 연결이 필요합니다.
③ 회사 네트워크 — 보안 정책으로 막히는 경우가 있습니다. 다른 네트워크에서 시도해 보세요.

그래도 안 되면 오류 메시지를 그대로 복사해서 클로드 채팅에 물어보세요(17회에서 배운 방법입니다). 공식 문서에도 오류별 해결 안내가 있습니다.

청록빛 막대가 어두운 홈 입구에 비스듬히 걸려 들어가지 못하는 개념 이미지. 설치 명령이 실패한 상황을 나타낸다

문제 해결 ② "설치했는데 claude 명령을 못 찾아요"

가장 흔한 원인은 터미널을 다시 열지 않은 것입니다.

설치 후에는 터미널을 닫고 새로 열어야 새 명령이 인식되는 경우가 많습니다. 닫았다 열고 다시 claude --version을 쳐 보세요.

대부분 이걸로 해결됩니다.

문제 해결 ③ "로그인이 안 돼요"

브라우저가 안 열리거나, 열렸는데 진행이 안 되는 경우입니다.

① 유료 구독 확인 — 무료 계정이면 로그인은 되어도 사용이 안 됩니다.
② 기본 브라우저 — 로그인 창이 기본 브라우저에서 열립니다. 로그인된 브라우저와 다르면 다시 로그인해야 합니다.
③ 계정 확인 — 여러 계정을 쓰신다면 3회에서 만든 그 계정이 맞는지 확인하세요.

청록빛 정육면체가 틈 하나 없는 어두운 판에 막혀 더 나아가지 못하는 개념 이미지. 로그인이 되지 않는 상황을 나타낸다

문제 해결 ④ "엉뚱한 폴더에서 실행됐어요"

실행 위치를 확인하지 않은 경우입니다. /exit로 나온 뒤, cd로 올바른 폴더로 이동하고 다시 실행하세요.

예방책: 실행 직후 화면 위쪽의 작업 폴더 표시를 매번 확인하는 습관을 들이세요. 3초면 됩니다.

실전 사례 ① 폴더 파악부터 시작하기

새 폴더에서 작업을 시작할 때 좋은 첫 질문들입니다.

"이 폴더 구조를 설명해 줘."
"여기서 가장 중요한 파일이 뭐라고 생각해?"
"파일 이름 규칙이 일관성 있어 보여?"

마지막 질문이 실용적입니다. 내가 못 보던 문제를 짚어 주는 경우가 많습니다.

실전 사례 ② 읽기만 시키는 단계

처음 며칠은 읽기 작업만 시켜 보시길 권합니다. 찾기, 요약하기, 정리해서 알려 주기.

이 기간에 배우는 것은 "클로드가 내 파일을 얼마나 정확히 이해하는가"입니다. 그 감이 생긴 다음에 고치는 작업으로 넘어가면 훨씬 안전합니다.

청록빛 줄기가 어두운 덩어리들 위를 훑고 지나가지만 아무것도 건드리지 않는 개념 이미지. 읽기만 시키는 단계를 나타낸다

실전 사례 ③ 저시력 사용자의 첫 설정

클로드 코드를 시작하기 전에 터미널 환경부터 정리하시길 권합니다. 17회에서 말한 것의 연장입니다.

글자 크기를 충분히 키우기 — 설정에서 아예 크게 지정해 두세요
배경과 글자 대비 확인 — 기본 색이 흐리면 바꾸세요
창을 최대화 — 좁으면 줄바꿈이 잦아져 읽기 어렵습니다

그리고 클로드 코드 안에서 쓸 수 있는 요청이 하나 더 있습니다.

"답은 짧게, 핵심부터 알려 줘. 파일 내용을 통째로 출력하지 말고 요약해 줘."

클로드 코드는 파일 내용을 화면에 길게 출력하는 경우가 있는데, 확대 환경에서는 그게 큰 부담입니다. 미리 말해 두면 요약해서 보여 줍니다.

이 요청을 매번 하기 번거로우시면, 25회에서 배울 CLAUDE.md 파일에 적어 두면 됩니다. 그때 다시 이야기하겠습니다.

깊은 검은 배경에 모서리가 또렷한 커다란 청록빛 덩어리 하나가 넉넉한 여백과 함께 놓인 고대비 개념 이미지. 저시력 사용자의 첫 설정을 나타낸다

핵심 정리 3줄

설치는 한 줄입니다. 운영체제와 터미널 종류에 맞는 명령을 고르는 것만 주의하세요.
실행한 위치가 작업 폴더입니다. cd로 이동한 다음 claude를 실행하고, 폴더 표시를 확인하세요.
처음에는 읽기만 시키세요. 연습용 사본 폴더에서, 며칠 감을 잡은 뒤 고치는 작업으로.

용어 정리

설치 명령 — 공식 사이트에서 설치 프로그램을 받아 실행하는 한 줄 명령.
작업 폴더 — 클로드 코드를 실행한 위치. 이 폴더가 작업 범위가 됩니다.
슬래시 명령 — 클로드 코드 안에서 /로 시작하는 명령. /help가 출발점입니다.
권한 모드 — 파일 수정 시 물어볼지 말지를 정하는 설정. Shift + Tab으로 전환합니다.
대화 이어가기 — claude -c로 그 폴더의 최근 대화를 이어서 진행하는 것.

다음 회차 예고와 실습 과제

19회 「기본 작업 흐름」에서는 클로드가 파일을 읽고 고치는 과정을 한 단계씩 따라가며 봅니다. 무엇을 하려는지 미리 보여 주는 계획 모드, 변경 내용을 확인하고 승인하는 방법, 그리고 결과를 검증하는 요령입니다.

실습 과제 두 가지

① 설치하고 연습용 폴더에서 실행한 뒤, 읽기 질문 세 개를 던져 보세요. 아직 고치지는 마세요.
② /exit로 나갔다가 claude -c로 다시 이어가 보세요. 대화가 그대로 살아 있는지 확인하는 것이 목적입니다.

설치 과정에서 막힌 지점이 있었다면 댓글로 남겨 주세요. 운영체제와 오류 메시지를 함께 적어 주시면 더 좋습니다.

본 회차는 2026년 8월 2일 기준이며, 설치 명령과 절차는 공식 문서에서 확인한 내용입니다. 클로드 코드는 유료 구독이 필요하고, 설치 방법과 명령은 버전에 따라 바뀔 수 있습니다. 화면과 이 글이 다르면 화면이 맞습니다.

협업문의 : kuroicode@gmail.com
블로그 : https://ghost-production-0ec2.up.railway.app/
홈페이지 : https://kuroicode-beep.github.io/svil-homepage/