02. 클로드 코드 설치 및 세팅

교시
2교시
선택
완료
시간
10:00~10:50
회차
1회차
⏰
2교시 · 10:00~10:50 쉬는 시간 10:50~11:00
🙋
모두 한번에 설치합니다.
  • 다 되면 손을 들어 주세요. 그리고 옆 사람을 도와 주세요.
  • 막히면 3분 안에 손을 들어 주세요.

인터넷 속도 테스트

Claude Code 설치 가이드

🔨
바이브코딩 마지막 세팅!

설치 가이드 요약

설치 순서

5가지를 차례로 설치합니다. 순서를 바꾸지 않습니다. 클로드 코드는 Node.js가 있어야 깔립니다.
순서
설치하는 것
무엇인가
1
파이썬
코딩할 때 쓰는 언어
2
Node.js
클로드 코드를 돌리는 엔진
3
Git
변경 이력을 관리
4
VS Code
폴더와 터미널을 한 화면에
5
클로드 코드
오늘 쓸 AI

막혔을 때

막히는 자리는 대개 6곳입니다.
막히는 자리
어떻게 보이나
이렇게 합니다
회사 PC 권한
설치 파일이 안 열린다
손 들기 · 담당자와 같이 봅니다
느린 다운로드
받는 데만 10분이 넘는다
미리 받아 둔 설치 파일을 씁니다
실행 정책
Execution Policies 오류
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 한 줄
명령을 못 찾음
node, claude 가 없다고 나온다
VS Code를 껐다 다시 켭니다
한글 경로
알 수 없는 오류
영문 경로 폴더로 옮겨 봅니다
로그인
유료 플랜이 안 보인다
제공받은 계정인지 보고 손 들기
먼저 끝난 분이 옆 사람을 도우면 모두 빨리 끝납니다.
설치 후, 체크 내용

1) 파워쉘에서 클로드 코드 실행 여부 확인

  1. VS Code 실행해주세요.
  1. VS Code 내 터미널 창에서 claude 를 입력해주세요.
  1. 오류 메시지가 뜨시는 분께서는 아래 명령어를 입력하여 클로드 코드를 재설치해주세요.
    1. JavaScript
      npm install -g @anthropic-ai/claude-code
오류 내용에 Execution Policies, Policy 같은 내용이 있다면 터미널에 아래 명령어를 실행해주세요.
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
그리고 바로 claude 실행해보세요.
  1. 설치가 완료되면 VS Code를 종료하고 재시작해주세요.
  1. VS Code의 터미널창에서 claude를 입력하여 실행 여부 확인해주세요.
✅
설치 검증 명령 3종 : VS Code 터미널(파워쉘)에서 아래 명령을 하나씩 입력해주세요. 오류 없이 버전 숫자가 뜨면 성공입니다.
PowerShell
python --version
node -v
git --version

2) 클로드 코드 외 다른 것들은 왜 설치했을까?

  1. 파이썬 : 가장 흔히 쓰이고 다양한 기능이 있는 프로그래밍 언어. 클로드 코드가 코딩할때 사용하라고 다운받은 언어.
  1. Node.js : 클로드 코드를 만든 JavaScript라는 프로그래밍 언어를 컴퓨터에서 실행시켜주는 엔진. 그리고, 클로드 코드 설치를 위해 필요함.
  1. Git : 코드의 변경 이력을 관리하고 코드저장소인 GitHub를 다루는 도구. 또한 VS Code 사용이 원활해지도록 설치함.
  1. VS Code : 파워쉘, cmd 등이 있는데 굳이 VS Code를 설치해서 그 안에 있는 터미널로 클로드 코드를 사용하는 이유는 폴더 탐색기, 코드 파일 확인 등이 용이하기 때문.

3) 클로드 데스크톱앱이 아닌, 클로드 코드 CLI를 사용하는 이유는?

notion image
  • 클로드 데스크톱앱이 더 편해보이지만, 그만큼 토큰 사용량이 클로드 코드 대비 30% 이상에 달한다는 사용 후기가 있음
  • 클로드 데스크톱앱은 메모리를 많이 차지해, 컴퓨터가 느려져 작업에 불편함이 생길 수 있음
  • 클로드 코드 CLI에 있는 기능 중 사용할 수 없는 기능이 일부 있음.

터미널에서만 되는 것

클로드 데스크톱앱의 Claude Code 탭은 편하지만, 아래 기능은 쓸 수 없거나 막혀 있습니다.
기능
무엇인가
언제 쓰나
! 로 바로 실행
클로드를 거치지 않고 터미널 명령을 바로 칩니다 (예 : !dir)
폴더 안을 빨리 볼 때
일부 설정 명령
/permissions 처럼 설정 창을 여는 명령이 앱에서는 「지원하지 않음」으로 나옵니다
권한을 고칠 때
한 줄 실행 · 자동화
대화 없이 명령 한 줄로 결과만 받습니다 (claude -p). 정해진 시각에 돌리는 자동화의 바탕입니다
3회차 스케줄링
에이전트 팀
여러 서브에이전트가 서로 말을 주고받으며 일을 나눠 합니다
여럿이 함께 결론 낼 때

4) VS Code 확장 프로그램 Claude Code 와는 무엇이 다른가?

🖥️
같은 클로드 코드, 여는 창만 다릅니다. VS Code 에는 Claude Code 확장 프로그램도 있습니다. 오늘은 VS Code 아래쪽 터미널에서 claude 를 칩니다.
VS Code 확장 프로그램
터미널 (오늘 쓰는 방식)
오른쪽 패널에서 대화합니다
명령을 치고 결과를 봅니다
바뀐 곳을 나란히 비교하는 화면이 보입니다
모든 명령을 쓸 수 있습니다
파일을 @ 로 골라 넣기 쉽습니다
! 로 바로 실행 · Tab 자동 완성이 됩니다
이미지 · PDF 를 붙이기 쉽습니다
한 줄 실행 · 자동화가 됩니다
슬래시 명령은 일부만 됩니다
노션 안내가 이 방식 기준입니다
둘은 같은 CLAUDE.md · 스킬 · MCP 설정 · 대화 이력을 함께 씁니다. 나중에 확장으로 바꿔도 오늘 만든 것이 그대로 이어집니다.

 

원활한 교육을 위한 AI 규칙 세팅

  1. 폴더링 설정
    1. 서울 바이브코딩 폴더 ← 설정 되어있는지 확인
  1. 클로드 CLI 설정 → 아래 내용 동일하게 입력해주세요
    1. python --version node -v git --version claude --version
      이 내용 제대로 설치되어있는지 확인해주고 안된게 있으면 너가 직접 설치해줘
      그리고 앞으로 모든 답변은 쉽고 직관적으로 두괄식으로 답변해주고 핵심만 간단하게 답변할수있도록 해줘
  1. 아래의 프롬프트를 그대로 입력해주세요. → 아래 내용 동일하게 입력해주세요
JavaScript
이 프로젝트 폴더에 CLAUDE.md 문서를 생성하고 아래의 내용을 작성해둬.

---

# 전역 작업 규칙

## 파일 저장 위치
- 모든 산출물(HTML, 코드, 문서 등)은 반드시 현재 프로젝트 폴더 안에만 생성한다.
- %TEMP%, C:\Windows\Temp 등 임시 폴더에는 어떤 산출물도 만들지 않는다.
- 테스트용 파일이 꼭 필요하면 프로젝트 폴더 안에 만들고, 작업이 끝나면 삭제한다.
- 파일을 만든 뒤에는 최종 저장 경로를 응답에 명시한다.

## 검증·테스트
- 웹페이지 제작 또는 수정 관련 지시 프롬프트에서 테스트 및 검증 지시 내용이 없었다면 웹페이지 제작 및 수정 완료 후 테스트 및 검증 수행을 절대로 스스로 하지 않는다. 항상 사용자가 직접 파일을 열어서 직접 테스트 할 수 있도록 안내한다.
- 웹페이지 제작 시 아티팩트로 만들라는 지시가 없었다면 아티팩트로 만들지 않고 html 파일로 보고한다.
- 테스트 및 검증은 사용자가 명시적으로 요청할 때만 수행한다.
- 테스트 및 검증이 필요해 보이면 실행하지 말고 "확인해볼까요?" 한 줄로만 물어본다.

## worktree 대응
- 작업 경로에 `.claude/worktrees`가 포함되어 있으면, 작업을 시작하기 전에
  자동 worktree에서 실행 중임을 한 줄로 알리고 실제 저장 경로를 보여준다.
- 사용자가 원본 폴더 작업을 원하면 원본 프로젝트 루트로 이동해서 작업한다.

---