소개
주옥 같은 타타님의 AI TALK — Claude Code 설치 강의가 휘발되기 전에 정리 복습해 봅니다.
진행 방법
플라우드 녹음 및 요약, 클로드 코드 협조
요약
본 강의는 비개발자나 프로그래밍 입문자를 대상으로, AI 비서인 클로드 코드(Claude Code)와 작업 공간인 VS Code(Visual Studio Code)를 사용하여 개발 환경을 설정하고 코딩 및 파일 관리 작업을 효율적으로 수행하는 방법을 배우는 입문 과정이다. 강의는 클로드(일반 AI 채팅)와 클로드 코드(컴퓨터에 직접 설치해 파일 작업을 수행하는 프로그램)의 개념적 차이를 '전화 상담원'과 '옆자리 비서'에 비유하며 설명한다. 참가자들은 VS Code 설치 및 초기 설정(한국어 팩, 테마 변경, 자동 저장)부터 시작하여, Mac과 Windows 환경에 맞춰 Homebrew, Git 등 필수 도구를 설치하고, 최종적으로 터미널 명령어를 통해 클로드 코드를 설치하는 전 과정을 실습한다. 이 과정을 통해 참가자들이 향후 AI와 함께 실제 파일 생성, 수정, 실행 등의 작업을 직접 수행할 수 있는 준비를 마치는 것을 목표로 한다. 또한, 설치 중 발생하는 다양한 문제를 해결하는 기술 지원 세션의 역할도 하며, 문제 발생 시 AI에게 직접 질문하여 해결하는 방법을 안내한다. 강의 후반부에는 AI로 생성한 '소울' 캐릭터를 활용한 굿즈 제작 계획을 공유하며 향후 학습에 대한 기대를 높인다.
지식 포인트
1. 클로드 코드 및 VS Code 기본 개념 (플라우드 추론요약) # Claude Code 및 VS Code 설치 가이드
본 워크숍은 비개발자· 입문자를 대상으로 Claude Code와 VS Code의 개념을 명확히 구분하고, 실제 사용을 위한 필수 준비 점검부터 VS Code 환경 설정, Claude Code 설치(확장+CLI), 최종 검증 및 오류 해결까지 전 과정을 안내합니다. 강사는 '전화 상담원 vs 개인 비서', '책상(에디터) vs 작업물(폴더)'의 비유를 사용해 각 도구의 역할을 쉽게 설명하고, 설치 중 마주칠 수 있는 문제를 실시간으로 해결하도록 지원했습니다.
Claude Code와 VS Code 개념 이해
개념 구분
Claude(일반 AI 채팅)와 Claude Code는 완전히 다른 개념입니다. 일반 AI 채팅(GPT, Claude)은 웹의 채팅창에서 질의응답(Q&A) 중심으로 쓰는 "전화 상담원"에 가깝습니다.
Claude Code는 내 컴퓨터에 설치되어 내 폴더를 직접 다루며, 파일 만들기/수정/검색/실행을 수행하는 "책상 옆의 개인 비서"에 해당합니다.
VS Code의 역할
VS Code는 작업대(에디터)로, 내 폴더(작업물)를 불러와 AI(Claude Code)를 "책상" 위로 가져와 함께 일하도록 연결합니다.
"VS Code = 책상 / 폴더 = 작업물 / Claude Code = 옆에서 돕는 비서"라는 비유로, 세 요소의 관계와 사용 맥락이 정의되었습니다.
Claude Code는 VS Code 안에 자연스럽게 통합(확장)되어 사용 가능합니다.
확장성 및 관련 도구
Claude Cowork은 Claude가 만든 더 쉬운 사용 도구로 알려져 있으나, Claude Code 자체가 가장 확장성 있게 작업을 수행할 수 있는 도구로 강조되었습니다.
VS Code는 "클로드(Claude) 코드를 어디에, 어떻게 가져와 연결할지"를 해결하는 핵심 작업대입니다.
유사 개념으 로 Anti-Gravity, Cursor가 언급되었으나, 모두 설치할 필요는 없고 VS Code에서 Claude Code를 사용하는 조합이 가장 적합하다는 견해가 제시되었습니다.
실습을 위한 사전 준비 사항 안내
유료 구독 및 계정
Claude Code 사용을 위해서는 Claude 유료 구독이 필요하며, 최소 Claude Pro 20달러 결제가 필수입니다.
Claude Pro 20달러 결제가 되지 않으면 당일 실습은 불가능합니다.
설치 전 준비
VS Code를 사전에 설치해야 하며, 설치 링크 및 Claude 결제 링크는 채팅으로 제공되었습니다.
다시보기는 내일 오전에 제공됩니다.
운영 및 지원
강의 자료는 윈도우 사용자도 따라 할 수 있게 준비되었으나, 강사는 맥 사용자이며 모든 세부 차이를 완벽히 알지는 못함을 고지했습니다.
셀프 해결 루트를 마련했고, 진행 중 막히거나 에러가 발생하면 채팅창에 상황을 올리도록 안내되었습니다. 윈도우 사용자의 피드백 참여도 기대되었습니다.
참고
일부는 Claude Cowork을 사용하지만, 이것 역시 유료이며 오늘 설치에 반드시 필요한 것은 아닙니다.
VS Code 작업 환경 설정
기본 개념 및 접근
VS Code는 '책상'(작업대)이자 에디터로, AI와 내 폴더를 한 자리에 모아 작업하게 해줍니다.
설치 시 운영체제(특히 윈도우) 사양에 맞는 설치 파일을 선택해야 합니다.
입문자 친화 설정
한국어 환경: "Korean Language Pack" 확장을 설치해 인터페이스를 한국어로 전환할 수 있으며, 적용을 위해 재시작이 필요할 수 있습니다.
가시성: 다크 테마가 불편하면 '라이트 모던' 등 밝은 테마로 변경 가능합니다.
안정성: '파일 > 자동 저장(Auto Save)'를 켜 두면 작업 안정성이 높아집니다(권장).
작업 공간과 패널
VS Code에서 폴더를 열어 프로젝트/작업 공간을 구성하고, '터미널' 메뉴에서 '새 터미널'을 열어 화면을 분할하여 효율적으로 작업할 수 있습니다.
터미널 패널은 드래그로 위치 이동이 가능하며, 맥과 윈도우의 UI는 다소 다를 수 있습니다.
확장 설치
사이드바의 Extensions(블록 아이콘)에서 확장을 검색·설치합니다.
이후 Claude Code 확장을 설치하면 VS Code 내에서 로그인 메시지가 표시되며, 폴더/터미널/확장 세 요소가 갖추어지면 이상적 상태가 됩니다.
Claude Code 설치 및 연동
설치 흐름(전반)
정석적 방법은 터미널 기반 설치·실행이며, 이는 입문자에게 난이도가 있을 수 있습니다. 이를 보완하기 위해 Anthropic이 비개발자를 위한 VS Code 확장을 제공하고, 확장 내에서 로그인 및 오류 도움을 받을 수 있습니다.
필수 도구
Homebrew와 Git 설치가 요구됩니다. 맥 사용자는 터미널에서 명령어를 입력해 Homebrew 설치 후 비밀번호를 입력해야 하며,
brew -v로 버전 확인이 가능합니다. Git도 이어서 설치합니다.윈도우 사용자는 별도의 가이드에 따라 Homebrew, Git 설치를 진행해야 합니다(워크숍 중 별도의 윈도우 절차가 준비되어 있음을 고지).
Claude Code(CLI) 설치 및 초기화
맥 기준으로 터미널에서
brew install --cask claude명령으로 설치합니다.설치 후 VS Code를 완전히 종료했다가 재시작합니다.
재시작 후 터미널에서
claude --version을 실행해 버전이 출력되는지 확인합니다.claude를 실행하면 초기 경고("이 작업공간을 신뢰하겠는가")가 뜨며, 수락 후 테마(다크/라이트 등) 선택 화면이 나타납니다.계정 연동 시 "Account with subscription" 화면이 보이면, 유료 구독된 Claude 모델로 로그인해야 합니다.
오류 대응 및 지원
설치·실행 중 발생하는 오류 코드는 VS Code의 Claude Code 확장을 통해 붙여넣고 해결책을 질의할 수 있습니다.
일부 환경에서 명령어 인식 지연, Homebrew 설치 중 패스워드 요구(맥), 낮은 버전 출력,
claude실행 후 경고 수락 필요, 엔터 입력 후 진행 불가 등이 보고되었습니다. 이 경우 터미널 재시작, VS Code 재실행 등의 1차 대응이 권장되었습니다.
설치 확인 및 질의응답
최종 확인 절차
터미널에서
claude --version을 입력해 버전이 곧바로 출력되면 설치가 정상 완료된 것입니다.claude실행 시 "I trust this workspace" 등 경고 문구가 뜨며 이를 수락하면 테마 선택 화면(다크/라이트 등)에 진입합니다. 테마는 취향에 따라 선택하며 이후 변경 가능합니다."Account with subscription" 화면이 나타나는 경우, 유료 구독 계정으로 로그인해야 CLI가 정상 동작합니다.
일부 환경에서
claude --version출력 시claude와hi-fi두 가지 버전 문자열이 함께 나타나면 정상 상태로 간주되었습니다.
문제 해결 접근
버전 출력 지연·오류 발생 시, Claude Code for VS Code 확장을 통한 질문으로 해결책을 즉시 얻을 수 있도록 안내했습니다.
claude명령 실행 후 엔터로 진행되지 않을 때는 터미널을 종료하고 재실행하는 방법이 소개되었습니다.
안내 자료
한국어 패치("Korean Language Pack") 설치·재시작 안내는 배포된 자료의 VS Code 사용법 섹션에 수록되어 있으며, 강의 자료는 카톡/문자/메일로 이미 발송되었습니다.
VS Code 확장은 "악세사리"처럼 다양한 기능을 쉽게 설치하도록 돕는다는 비유로 그 역할이 설명되었습니다.
폴더 열기, 터미널 열기,
claude명령 정상 동작, 확장 표시 상태가 모두 만족되면 "완벽한 설치 상태"로 평가됩니다.
Action Items
@모든 참석자
Claude Pro 20달러 유료 구독을 결 제한다. - [TBD]
제공된 링크를 통해 본인 OS(맥/윈도우/리눅스)에 맞는 VS Code 설치 파일을 다운로드하고 설치한다. - [TBD]
진행 중 리드대로 하다 막히거나 에러가 발생하면 문제 상황을 채팅창에 공유한다. - [TBD]
VS Code를 실행해 탐색기 아이콘(문서 모양)을 확인하고 '터미널 > 새 터미널'을 열어 화면 분할을 시도한다. - [TBD]
VS Code 사이드바의 Extensions에서 'Korean Language Pack'을 검색·설치한다. - [TBD]
한국어 언어팩 적용을 위해 VS Code를 재시작한다. - [TBD]
상단 메뉴(코드/파일) > 설정(Settings) > 테마(색 테마)에서 원하는 테마로 변경한다. - [TBD]
'파일(File)' 메뉴에서 '자동 저장(Auto Save)'을 활성화한다. - [TBD]
VS Code에서 새 폴더를 열어 작업 공간을 구성한다. - [TBD]
VS Code를 완전히 종료하고 다시 실행해 변경 사항을 적용한다. - [TBD]
터미널에서
claude --version을 실행해 버전이 출력되는지 확인한다. - [TBD]터미널에서
claude를 실행한 뒤 표시되는 경고 문구에서 신뢰("믿습니다")를 선택한다. - [TBD]claude실행 후 나타나는 화면에서 테마를 선택하고 로그인 절차("Account with subscription" 등)를 완료한다. - [TBD]
@맥 사용자
터미널에 제시된
brew install설치 스크립트를 복사·붙여넣기하고 엔터를 눌러 Homebrew를 설치한다. - [TBD]Homebrew 설치 중 요청되면 맥북 잠금 해제에 사용하는 패스워드를 입력한다. - [TBD]
Homebrew 설치 후
brew -v로 버전을 확인한다. - [TBD]Git 설치를 진행한다. - [TBD]
brew install git명령어로 Git을 설치한다. - [TBD]새로운 터미널에서
brew install --cask claude를 실행해 Claude Code를 설치한다. - [TBD]
2. 설치 및 설정을 위한 사전 준비
클로드 코드 사용 조건
반드시 클로드 유료 구독자여야 하며, 최소 월 20달러의 프로(Pro) 요금제 결제가 필요하다. 결제가 완료되지 않으면 실습 참여가 불가능하다.
VS Code 설치
제공된 링크를 통해 자신의 운영체제(Mac, Windows, Linux)에 맞는 버전을 다운로드하여 설치해야 한다.
필수 도구 설치 (Homebrew & Git)
클로드 코드를 정상적으로 설치하고 사용하기 위해 사전 설치가 필요한 도구들이다.
Mac 사용자: 터미널에서 Homebrew를 먼저 설치한 후,
brew install git명령어로 Git을 설치한다.Windows 사용자: Homebrew를 사용하지 않으며, 강의 자료에 명시된 별도의 Windows 전용 가이드에 따라 설치를 진행해야 한다.
Windows
"64-bit Git for Windows Setup" 다운로드 → 실행
모든 옵션을 기본값 그대로 두고 설치 진행
VS Code를 완전히 종료한 후 다시 열기
터미널에서 확인:
git --version입력 → 버전이 나오면 성공!
⚠️ VS Code를 재시작하지 않으면
git명령어가 인식되지 않습니다.
3. VS Code 초기 설정 및 Claude Code 설치 실습
VS Code 초기 환경 설정
한국어 언어팩 설치: 확장(Extensions) 마켓플레이스에서 'Korean Language Pack'을 검색하여 설치하고 프로그램을 재시작한다.
테마 변경: 어두운 기본 테마가 익숙하지 않을 경우, '설정 > 테마 > 색 테마'에서 '고요하게 밝음' 등 원하는 라이트 모드 테마로 변경할 수 있다.
자동 저장 활성화: '파일 > 자동 저장(Auto Save)'을 체크하여 생산성을 높인다.
터미널 열기 및 레이아웃 조정: 상단 메뉴에서 '터미널 > 새 터미널'을 열고, 터미널 창을 드래그하여 원하는 위치로 옮겨 레이아웃을 조정할 수 있다.
작업 폴더 열기: '파일 > 폴더 열기'를 통해 프로젝트를 진행할 특정 폴더를 열고 작업하는 것이 체계적인 관리에 좋다.
Claude Code 설치 및 인증
확장 프로그램 설치: VS Code 확장 마켓플레이스에서 'Claude Code'를 검색하여 설치한다. 이는 GUI 환경을 제공하여 CLI가 익숙하지 않은 사용자를 돕고, 오류 발생 시 AI에게 질문하는 창구로 유용하다.
계정 로그인: 설치 후, 유료 구독 중인 클로드 계정으로 로그인 인증을 진행해야 한다.
터미널(CLI) 설치: 필수 도구 설치가 완료된 후, 새 터미널을 열고 강의 자료에 제공된 운영체제별 설치 명령어를 실행한다.
설치 완료 확인
CLI 설치 후 VS Code를 완전히 종료했다가 다시 시작해야 한다.
새 터미널을 열고
claude --version명령어를 입력했을 때 버전 번호가 정상적으로 출력되면 모든 설치가 성공적으로 완료된 것이다.
4. 문제 해결 및 기타 사항
문제 발생 시 대처 방안
설치 중 에러가 발생하면, 미리 설치한 Claude Code 확장 프로그램을 열어 오류 메시지를 붙여넣고 "왜 안돼?"와 같이 질문하여 해결책을 찾을 수 있다.
터미널에서 신뢰 여부를 묻는 창(예: 'I trust, responder')이 뜨면 '믿습니다'를 선택하고 진행한다.
강의 정보 및 학습 계획
강의 다시보기는 다음 날 오전에 제공될 예정이다.
이 설치 세션은 향후 스터디 진행 시 스터디장들의 부담을 덜어주기 위함이다.
이 날을 시작으로 4주간 함께 공부를 진행할 예정이다.
AI 캐릭터 '소울' 굿즈 제작
AI를 이용해 생성한 '소울'(주황색 후드티를 입은 까만 고양이) 캐릭터 이미지로 인형, 스티커 등의 굿즈를 제작하여 향후 행사에서 배포할 계획이다.
결과와 배운 점
배운 점과 나만의 꿀팁
Claude(일반 채팅)와 Claude Code의 차이를 "전화 상담원 vs 옆자리 비서"로 정리한 비유가 명쾌했다. 나만의 꿀팁: 설치 중 오류 나면 Claude Code 확장 열어서 에러 메시지 붙여넣고 바로 물어보면 된다. 이게 가장 빠른 해결책.
과정 중에 어떤 시행착오를 겪었나요?
처음엔 Claude Code = Claude 채팅의 코딩 버전이라고 막연히 생각했는데, 실제로는 내 컴퓨터 파일에 직접 접근하는 전혀 다른 도구였다. 이 인식의 전환이 없으면 "왜 Claude Code를 써야 하지?"라는 의문에서 멈추게 된다.
앞으로의 계획이 있다면 들려주세요.
22기 전자책 공동스터디장으로서, 스터디원 중 Claude Code 설치 안 된 분들을 위해 이 강의 노트를 요약한 1페이지 설치 가이드를 준비할 계획이다. "막히면 AI에게 물어봐요" 한 줄 원칙과 함께.
도움 받은 글
