0songha0

윈도우 Claude AI 설치 및 Claude CLI 사용 방법

윈도우 CLI claude 설치 방법

윈도우 PowerShell 실행

윈도우 검색 > PowerShell 입력 > Windows PowerShell 실행
cmd에서는 질문할 때 여러 줄 불여넣기가 되지 않아 PowerShell로 하는 것이 좋습니다.

node 설치 확인

node -v
npm -v

Window에서 Claude AI를 사용하기 위해서는 node가 설치되어야 합니다.

claude 설치 명령어

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

node가 설치되어 있으면 위 명령어로 claude 패키지를 설치할 수 있습니다.

claude 실행 명령어

cd 프로젝트경로
claude

claude 화면이 나오면 엔터를 두 번 입력하여 로그인 페이지로 진입할 수 있습니다.
Claude 이메일 계정 입력 후 인증 코드로 인증하고 승인합니다.
다시 cli로 이동하고 엔터를 두 번 입력하여 현재 폴더를 workspace로 사용합니다.

PowerShell에서 claude 실행 시 오류 해결

claude : 이 시스템에서 스크립트를 실행할 수 없으므로 D:\nodejs\claude.ps1 파일을 로드할 수 없습니다. 자세한 내용은 abou
t_Execution_Policies(https://go.microsoft.com/fwlink/?LinkID=135170)를 참조하십시오.
위치 줄:1 문자:1
+ claude
+ ~~~~~~
    + CategoryInfo          : 보안 오류: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

위와 같은 오류가 나오면, 아래 명령어로 현재 사용자가 ps1 스크립트를 실행할 수 있도록 허용합니다.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

claude code 초기화

/init

프로젝트 경로에서 실행한 claude 화면에 위 명령어를 입력합니다.
Claude code가 프로젝트를 분석해서 만드는 CLAUDE.md 파일이 생기고, 이후 답변 정확도가 높아집니다.
진행 과정에서 Yes, allow reading from d\ from this project, yes, and don’t ask again for similar commands in 프로젝트경로 등을 선택하면 파일 수정 시 접근 허용을 다시 요청하지 않아 편리합니다.

윈도우 Claude CLI 사용법

한국어 답변 설정

CLAUDE.md 파일에 항상 한국어로 답변해달라는 내용을 추가해줘

앞으로 항상 claude가 한국어로 답변하게 되고, 다시 영어로 답변을 변경할 수도 있습니다.
claude는 항상 CLAUDE.md 파일을 참고하기 때문에 내용 추가를 요청하였습니다.

CLAUDE.md 파일에 추가하면 좋은 내용

CLAUDE.md 파일에 하드코딩을 지양하고, 항상 효율적인 클린한 코드로 개발하고, 불필요한 코드는 제거하라는 내용을 추가해줘

문자열 상수 등을 코드에 직접 작성하지 않고, 설정 파일로 분리합니다.
신규 로직을 작성하기 전에 기존 유틸, 공동 함수 등을 먼저 확인하고 재사용합니다.
함수는 한 가지 일반 수행하고, 의미 있는 변수명과 함수명을 사용하고, 중복 코드 및 불필요한 연산을 피합니다.

프로젝트 파일 지정

@파일명

위와 같이 @파일명 또는 @경로/파일명을 지정하여 질문하면 좋습니다.
프로젝트 폴더 내에 docs 폴더 생성 후 DDL, 화면설계서 등을 넣고 질문 시 참조할 수 있습니다.
화면설계서는 파워포인트 형식은 읽을 수 없고 용량이 크면 비용이 많이 나가므로,
필요한 특정 페이지만 추출하여 PDF로 만들어서 넣는 것이 좋습니다.

파워포인트 PDF 변환 방법
파워포인트 화면 > 파일 > 내보내기 > PDF/XPS 만들기 > 경로 선택 > 게시

가이드 파일 요청

~ 기능을 구현하고 싶은데 어떻게 개발할지 가이드 파일을 먼저 만들어줘

AI가 제시한 가이드 파일을 확인하고 문제가 없으면 그대로 작업해달라고 할 수 있습니다.

최신 글