『혼공바이브』 나의 첫 바이브 코딩 3주차

ㄱㅇㅇ

 

1. 클로드 코드란?

웹 브라우저에서 대화하는 챗봇 형태의 클로드와 달리, 내 컴퓨터 터미널(CLI)에서 직접 실행되어 코드 수정, 파일 생성, 명령어 실행 등을 수행하는 강력한 개발 도구입니다.

---

2. 윈도우 환경 설치 및 실행법

✅ 준비물: Node.js, Git 설치 필수

1. 설치 명령어 실행 (CMD 전용)(참고: 공식 가이드는 Claude Code GitHub에서 확인 가능합니다.)

2. npm install -g @anthropic-ai/claude-code
   

3. 클로드 실행

4. claude
   

5. 초기 설정: 터미널 스타일 설정 및 계정 연동을 진행합니다.
6. 종료 방법: Ctrl + C를 두 번 연속 누르면 종료됩니다.

 

 

 

3. 프로젝트의 두뇌, CLAUDE.md 활용하기

CLAUDE.md는 프로그램이 실행될 때 참고하는 규칙과 환경 정보를 담은 문서입니다. 이 파일에 프로젝트 목표와 규칙을 적어두면 클로드가 맥락을 놓치지 않고 작업을 이어갈 수 있습니다.

• 명령어: /init (초기 설정을 준비하거나 실행 환경을 새로 구성할 때 사용)

📂 일반적인 CLAUDE.md 구조

항목	내용
# 프로젝트명	프로젝트에 대한 간단한 설명
## Project Overview	무엇을 하는 프로젝트인지 요약
## Commands	설치, 실행, 테스트 관련 명령어 리스트
## Tech Stack	사용 언어 버전(Python 등), 주요 라이브러리
## Architecture	핵심 클래스, 파일 구조 및 각 파일의 역할
## Code Style	주석 규칙, 에러 처리 방식, 함수명 스타일
## Development Notes	현재 진행 상태 및 제한 사항

---

4. 계층 구조(Hierarchy)를 활용한 컨텍스트 관리

클로드 코드는 폴더별로 CLAUDE.md를 인식하는 계층 구조를 지원합니다. 이를 통해 폴더마다 다른 기술 스택이나 규칙을 적용할 수 있습니다.

 

계층적 CLAUDE.md 구조의 장점

 

1. 컨텍스트 자동 전환

• 상위 폴더: 공통 규칙 (예: "모든 코드는 TypeScript 사용")
• 하위 폴더(web/): 웹 전용 규칙 (예: "프론트엔드는 React 사용")
• 하위 폴더(mobile/): 모바일 전용 규칙 (예: "React Native 사용")

 

2. 실용적인 예시
  웹 버전 작업 시:
  - "Flask 라우팅 규칙 따라줘"
  - "프론트엔드는 React 써"
  데스크톱 버전 작업 시:
  - "Tkinter 패턴 유지해"
  - "PyInstaller로 빌드해"
  이런 규칙들을 각각 다르게 설정할 수 있어요.

  

3. 대규모 프로젝트에서 유용

 팀원마다 다른 영역 작업해도 일관된 규칙이 자동 적용됩니다.
  요약: 폴더별로 다른 기술 스택/규칙/컨벤션을 설정해두면, 해당 폴더에서 작업할 때 자동으로 맞는 가이드를 따르게 됩니다.

장점: 특정 폴더에서 작업하면 해당 위치의 CLAUDE.md가 우선 적용되어, 별도의 설명 없이도 폴더 성격에 맞는 가이드를 자동으로 따르게 됩니다.

---

5. 🛠️ 직접 해결한 에러 트러블슈팅 (중요!)

설치 과정에서 발생할 수 있는 주요 에러와 해결책입니다.

① npm install 명령어 오타 주의

• 증상: npm error code EINVALIDTAGNAME 발생
• 원인: @anthropic-ai 사이의 공백(띄어쓰기) 실수
• 해결: npm install -g @anthropic-ai/claude-code로 정확히 입력

② cd: too many arguments 에러

• 원인: 폴더 경로 이름에 **공백(Space)**이 포함되어 있을 때 발생
• 해결: 폴더 이름에서 공백을 제거하거나 경로 전체를 큰따옴표(" ")로 감싸기

③ PowerShell 스크립트 실행 정책 에러

• 원인: 보안 설정 때문에 외부 스크립트 실행이 차단됨
• 해결: PowerShell의 실행 정책(Execution Policy)을 변경해야 함

④ 파이썬(Python) 환경 충돌

• 증상: pip 등 파이썬 관련 명령어가 계속 에러 발생
• 원인: 마이크로소프트 스토어 버전 파이썬과 기존 설치 버전의 충돌
• 해결: 마이크로소프트 스토어 경로의 파이썬을 삭제하니 정상 작동됨

 

 

---

PROJECT 3. 손글씨 인식 프로그램 만들고 캡처하기