ComeSuji

설정(Settings)과 메모리(Memory)

콤수지 — Tue, 4 Aug 2026 09:48:31 +0900

클로드 코드를 쓰다 보면 "이 설정은 어디에 저장해야 하지?", "팀원이랑 같이 봐야 하는 건가, 나만 봐야 하는 건가?" 하는 고민이 생깁니다. 이번 글에서는 클로드 코드의 설정(Settings) 체계와 메모리(Memory) 체계를 기준으로 정리해봤습니다.

1. 설정(Settings) 파일

클로드 코드는 설정을 4단계 범위(scope)로 관리합니다. 아래로 갈수록 더 좁은 범위(개인/로컬)이고, 위로 갈수록 넓은 범위(조직 전체)입니다.

범위 파일 위치 적용 대상

엔터프라이즈 관리 정책	managed-settings.json	회사 IT 관리자가 배포, 조직 전체에 강제 적용 (덮어쓰기 불가)
사용자 설정	~/.claude/settings.json	내 컴퓨터의 모든 프로젝트에 공통 적용
프로젝트 설정 (공유)	.claude/settings.json	해당 프로젝트에만 적용, git으로 팀원과 공유
프로젝트 설정 (로컬)	.claude/settings.local.json	해당 프로젝트 내 나만의 개인 설정, 커밋하지 않음

적용 우선순위는 다음 순서로 높습니다 (숫자가 낮을수록 우선):

엔터프라이즈 관리 정책 (최우선, 덮어쓰기 불가)
커맨드라인 인자 (세션 한정 임시 설정)
로컬 프로젝트 설정 (settings.local.json)
공유 프로젝트 설정 (settings.json)
사용자 설정 (~/.claude/settings.json)

참고로 permissions.allow 같은 배열형 설정은 상위 설정을 "덮어쓰기"하는 게 아니라 범위별로 합쳐지고 중복 제거되는 방식으로 동작합니다.

settings.local.json은 왜 .gitignore에 넣어야 할까?

개인 API 키나 나만 쓰는 실험적 설정이 팀 저장소에 공유되면 안 되기 때문입니다. 방법은 간단합니다.

프로젝트에 .gitignore 파일을 만든다
그 안에 .claude/settings.local.json 한 줄을 추가한다

이렇게 하면 이 파일은 자동으로 git 추적 대상에서 제외되어, 팀원과는 공유되지 않고 내 컴퓨터에만 남습니다.

2. 권한(Permissions) 설정 — allow / deny

settings.json 안의 permissions 항목으로 클로드가 어떤 도구를 실행할 수 있는지 세밀하게 제어할 수 있습니다.

allow: 클로드가 확인 없이 바로 실행하도록 허용
deny: 클로드가 절대 접근하지 못하도록 차단 (예: .env, secrets/** 같은 민감 파일)
ask (기본값): 실행 전 매번 사용자에게 확인

헷갈릴 수 있는 부분인데, deny가 allow보다 우선합니다. 즉 무언가를 allow에 등록했더라도 deny에도 걸려 있으면 차단됩니다.

bash는 터미널에서 컴퓨터에게 명령을 내리는 명령어 체계이고, 클로드 코드는 이 bash 명령 실행 권한도 permissions로 제어합니다.

와일드카드(*)는 "모든 것"을 의미하는 패턴 기호입니다. 예를 들어:

{
  "permissions": {
    "allow": ["Bash(npm run test:*)", "Bash(git status)", "Bash(git diff)"],
    "deny": ["Read(./.env)", "Read(./secrets/**)"]
  }
}

Bash(npm run test:*) → npm run test로 시작하는 모든 명령을 허용
Read(./secrets/**) → secrets 폴더 하위의 모든 파일 읽기를 차단

실전 팁: 처음부터 모든 명령을 allow에 몰아넣기보다, 실제로 자주 쓰는 테스트/린트/git 조회 명령 위주로 조금씩 허용 목록을 늘려가는 방식이 안전합니다. /permissions 명령으로 세션 중에도 대화형으로 규칙을 추가·수정할 수 있고, 이렇게 수정한 내용은 settings.json에 자동 반영됩니다.

자주 쓰는 모드 저장하기

매번 실행 모드를 다시 설정하는 게 번거롭다면 defaultMode 값을 settings.json에 저장해두면 클로드 코드를 켤 때마다 자동으로 그 모드로 시작합니다 (예: "defaultMode": "acceptEdits").

3. 메모리(Memory) — CLAUDE.md

클로드 코드는 대화가 끝나면 기억을 잃지만, CLAUDE.md 파일에 적어둔 내용은 매 세션 시작 시 자동으로 불러와서 기억합니다. 새로 합류한 팀원에게 브리핑 문서를 주는 것과 같은 역할입니다.

/init 명령

프로젝트 루트에서 /init을 실행하면 클로드가 프로젝트 구조를 분석해서 기본 CLAUDE.md 초안을 자동으로 생성해줍니다. 다만 자동 생성된 내용에는 코드만 봐도 알 수 있는 당연한 정보(예: "이건 TypeScript 프로젝트입니다")가 섞여 있는 경우가 많으니, 불필요한 부분은 정리해서 쓰는 걸 추천합니다.

메모리의 종류

엔터프라이즈 정책 메모리	관리자가 배포	회사 IT 관리자가 조직 전체 개발자에게 강제 적용하는 지침
프로젝트 메모리	./CLAUDE.md	해당 프로젝트에만 적용, git으로 커밋해서 팀원과 공유
프로젝트 메모리 (로컬)	./CLAUDE.local.md	나만의 프로젝트별 메모, 팀원과 공유되지 않음, gitignore 대상
사용자 메모리	~/.claude/CLAUDE.md	내 모든 프로젝트에 공통 적용되는 개인 선호(스타일 등)
오토 메모리 (Auto memory)	~/.claude/projects/<프로젝트>/memory/	클로드가 작업하면서 스스로 남기는 메모(빌드 명령, 디버깅 노트 등). CLAUDE.md와 별개 시스템으로, 기본적으로 켜져 있음

.claude/rules/*.md 라는 폴더를 만들면 CLAUDE.md 하나에 다 몰아넣지 않고 주제별로 지침을 쪼갤 수도 있습니다. 특히 paths 옵션을 지정하면 특정 경로의 파일을 다룰 때만 해당 규칙이 로딩되어, 매번 모든 규칙을 다 읽는 것보다 컨텍스트를 절약할 수 있습니다.

모든 프로젝트에서 지켜야 할 팀 가이드라인 예시

CLAUDE.md에는 이런 식의 구체적인 규칙을 적어둘 수 있습니다.

들여쓰기 2칸, 세미콜론 사용, 문자열은 작은따옴표
커밋 메시지는 한글로 작성
브랜치명 규칙: feature/기능명, fix/버그명
커밋은 작은 단위로 나눠서 진행
파일 수정 전에는 변경 계획을 먼저 설명할 것
한 번에 너무 많은 파일을 수정하지 말 것
OS: Windows 11 등 개발 환경 명시

CLAUDE.md가 너무 길어질 때 — @ 임포트

CLAUDE.md 파일이 계속 길어지면 클로드가 지침을 놓치거나 컨텍스트를 많이 잡아먹을 수 있습니다. 이럴 때 @경로 문법으로 다른 파일을 불러오는 방식으로 분리할 수 있습니다.

# 프로젝트 개요
프로젝트 개요는 @README.md 참고
사용 가능한 npm 명령어는 @package.json 참고
개인 설정은 @~/.claude/my-project-instructions.md 참고

이렇게 하면 CLAUDE.md 본문은 짧게 유지하면서, 필요한 세부 내용은 다른 문서로 관리할 수 있습니다. 다만 임포트된 파일도 세션 시작 시 함께 로딩되므로, 이 방식은 "정리정돈"에는 도움이 되지만 실제 컨텍스트 사용량 자체를 줄여주는 것은 아니라는 점은 참고하세요.

/memory 명령

현재 세션에 어떤 메모리 파일들이 로딩되어 있는지 확인하고, 에디터로 바로 열어서 수정할 수 있는 명령입니다. 어떤 지침이 왜 적용되고 있는지(혹은 안 되고 있는지) 헷갈릴 때 디버깅 용도로 유용합니다.

4. 메모리 작성 모범 사례

구체적으로 작성하기: "들여쓰기를 잘 하세요" 보다 "들여쓰기는 2칸으로" 처럼 명확한 수치로 적기
구조화해서 정리하기: 줄글보다는 리스트나 표 형식으로 정리하면 클로드도, 사람도 더 잘 따릅니다
정기적으로 검토하기: 프로젝트가 바뀌면 CLAUDE.md도 오래된 내용이 쌓이기 마련이니 주기적으로 정리
파일을 너무 길게 쓰지 않기: 지침이 너무 길어지면 오히려 잘 지켜지지 않을 수 있어서, 핵심만 간결하게 유지하고 세부 내용은 @ 임포트로 분리하는 걸 권장합니다
반영이 안 될 때는 강조 표시: 지침을 줬는데도 클로드가 계속 반영하지 않는다면 (중요) 같은 표시를 붙여서 우선순위를 명확히 알려주면 도움이 됩니다

참고: 클로드 코드는 계속 업데이트되고 있어서 세부 옵션명이나 동작 방식은 버전에 따라 조금씩 달라질 수 있습니다. 최신 내용은 공식 문서를 확인해보세요.

Cursor 설치 방법 완벽 가이드

콤수지 — Thu, 23 Jul 2026 14:50:09 +0900

VS Code, Cursor, Antigravity의 관계까지 한 번에 이해하기

AI 코딩 도구를 사용하다 보면 Cursor, VS Code, Antigravity, Claude Code 등 다양한 이름이 등장합니다.

처음 접하는 사람이라면 "도대체 뭐가 다른 거지?", "무엇을 설치해야 하지?"라는 생각이 들 수 있습니다.

이번 글에서는 Cursor가 어떤 프로그램인지, VS Code와 어떤 관계인지, 그리고 설치부터 기본 설정까지 차근차근 알아보겠습니다.

Cursor란 무엇인가?

Cursor는 AI 기능이 내장된 코드 에디터입니다.

쉽게 말하면 Visual Studio Code(VS Code)를 기반으로 만들어진 AI 코드 에디터라고 생각하면 됩니다.

AI에게 코드를 질문하거나, 자동으로 코드를 작성하고 수정하는 기능들이 기본적으로 제공되어 개발 생산성을 크게 높여줍니다.

그렇다면 VSCode란 무엇인가?

VS Code(Visual Studio Code)는 Microsoft에서 만든 무료 오픈소스 코드 에디터입니다.

개발자가 코드를 작성하고 수정하기에 최적화되어 있으며 현재 가장 많이 사용되는 코드 에디터 중 하나입니다.

오픈소스 프로젝트이기 때문에 누구나 VS Code의 소스 코드를 가져와 자신의 기능을 추가하여 새로운 프로그램을 만들 수 있습니다. 이러한 과정을 포크(Fork)라고 합니다.

Cursor와 Antigravity는 VS Code를 기반으로 만든 에디터로

VS Code → 기본 코드 에디터
Cursor → VS Code + AI
Antigravity → VS Code + AI

처럼 이해하면 됩니다.

이 세가지 에디터는 코드를 실행하는 프로그램이라기 보다는, 프로젝트 구조를 확인하고, 파일을 열고, 코드를 수정하는 작업 공간 (Viewer)에 가깝습니다.

왜 Cursor를 사용하는가?

여러 AI 코드 에디터가 있지만 Cursor를 많이 사용하는 이유는 무료 플랜에서도 강력한 AI 자동완성 기능(Tab Completion)을 사용할 수 있기 때문입니다.

코드를 입력하기 시작하면 다음에 작성할 내용을 AI가 예측하여 자동으로 제안해 주기 때문에 반복적인 코딩 작업을 크게 줄일 수 있습니다.

초보자뿐 아니라 숙련된 개발자들도 생산성을 높이기 위해 Cursor를 많이 사용합니다.

Cursor 설치하기

먼저 Cursor 공식 홈페이지에 접속합니다.

다운로드 페이지에서 자신의 운영체제에 맞는 설치 파일을 다운로드합니다.

Cursor · Download

Download Cursor for macOS, Windows, and Linux.

cursor.com

다운로드한 설치 파일을 실행한 후에는 특별한 설정 없이 Next(다음) 버튼을 눌러 설치를 진행하면 됩니다.

VS Code와 같은 단축키 사용하기

기존에 VS Code를 사용했던 분들은 Cursor의 단축키가' Cmd + Shift + P(macOS) 다르게 느껴질 수 있습니다.

이럴 때는 Ctrl + Shift + N(Windows/Linux) 또는 Cmd + Shift + N(macOS)을 눌러 일반 에디터 화면으로 전환할 수 있습니다.

터미널에서 Cursor 실행하기

Cursor는 아이콘을 클릭해서 실행할 수도 있지만 터미널에서 실행하면 더욱 편리합니다.

먼저 Ctrl + Shift + P(Command Palette)를 실행합니다.

그리고 다음 명령을 검색합니다.

Shell Command: Install 'cursor' command

이 명령을 실행하면 터미널에서 다음처럼 Cursor를 실행할 수 있습니다.

cursor .

현재 폴더를 Cursor로 바로 열 수 있어 매우 편리합니다.

만약 cursor 명령이 없다면?

일부 환경에서는 다음 명령만 보이는 경우가 있습니다.

Shell Command: Install 'code' command

이 명령을 설치해도 동일하게 사용할 수 있습니다.

설치 후에는

code .

명령으로 현재 폴더를 Cursor에서 열 수 있습니다.

추천 확장 프로그램 : Live Server

Cursor는 VS Code 기반이기 때문에 다양한 확장 프로그램을 설치할 수 있습니다.

그중 가장 추천하는 확장 프로그램은 Live Server입니다.

Live Server는 HTML, CSS, JavaScript를 개발할 때 파일을 저장하는 즉시 브라우저 화면을 자동으로 새로고침해 주는 기능을 제공합니다.

클로드 코드 초기 설정

콤수지 — Mon, 20 Jul 2026 21:17:09 +0900

이번 글에서는 Claude Code를 실행해보겠습니다.

Claude Code 실행하기

Claude Code는 프로젝트 폴더 내부에서 실행하는 것이 좋습니다.

저는 작업 공간으로 workspaces 폴더를 만들었고, 그 안에 claude-code-mastery라는 프로젝트 디렉터리를 생성했습니다.

mkdir workspaces 명령어로 workspaces 폴더를 만들었습니다.

cd .\workspaces\로 해당 폴더로 이동하고 mkdir claude-code-mastery 폴더를 생성해주었습니다.

cd .\claude-code-mastery\ 로 해당 폴더로 이동한 후 claude 를 실행해주었습니다.

실행 모드 선택

Claude를 처음 실행하면 사용할 Mode를 선택하는 화면이 나타납니다.

원하는 모드를 선택한 뒤 Enter 키를 눌러 진행합니다.

(저는 Dark mode를 선택했습니다.)

실행 모드 선택

모드를 선택하면 로그인 방식을 선택하게 됩니다.

다음과 같은 옵션이 제공됩니다.

Claude Pro/Max 등 구독 계정으로 로그인 (개인 사용자에게 가장 추천)
API Key로 사용한 만큼만 결제(Pay as you go)
기업(Enterprise) 계정으로 로그인

일반적으로 개인 학습이나 개발 목적이라면 1번(구독 계정)을 선택하는 것을 추천합니다.

Google 계정으로 로그인

로그인 방식을 선택하면 브라우저가 열리며 Google 계정으로 로그인할 수 있습니다.

Claude 요금제

로그인 과정에서 원하는 Claude 요금제를 선택하여 결제하면 됩니다.

Claude Code를 실행하기 위해서는 Claude Pro 이상을 사용해야 합니다.

20206. 07. 20 기준 요금제

로그인이 완료되면 Claude Code가 자동으로 인증을 마치고 터미널로 돌아옵니다.

이후에 나오는 것들은 Enter 해주면 됩니다.

이렇게 하면 Claude Code를 실행했습니다!

Claude Code 종료하기

Claude Code를 종료하고 PowerShell(또는 터미널)로 돌아가려면 명령어 /exit 를 입력하면 됩니다.

더 깊이 배우고 싶다면

https://inf.run/PP9Ry

클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지| 짐코딩 - 인프런 강의

현재 평점 4.9점 수강생 9,665명인 강의를 만나보세요. 탐색 → 계획 → 구현 → 커밋. 검증된 AI 개발 워크플로우를 클로드 코드로 마스터하세요. MCP, 서브에이전트, 프롬프트 엔지니어링까지 23개

www.inflearn.com

Git 설치하기

콤수지 — Mon, 13 Jul 2026 20:37:40 +0900

이번 글에서는 Windows 환경에 Git을 설치하고, 커밋에 사용할 이름과 이메일을 설정하는 방법을 알아보겠습니다.

Git이란?

Git은 소스 코드의 변경 이력을 관리하는 버전 관리 도구입니다.

개발하다 보면 코드를 수정하기 전 상태로 되돌리거나, 어떤 부분이 변경되었는지 확인해야 할 때가 있습니다.

Git을 사용하면 파일의 변경 내용을 기록할 수 있어 프로젝트를 보다 체계적으로 관리할 수 있습니다.

또한 여러 명이 함께 개발할 때 서로의 코드를 공유하고 변경 내용을 합치는 데도 사용됩니다.

GitHub와 같은 원격 저장소 서비스도 Git을 기반으로 동작하기 때문에 개발 환경을 구성할 때

필수적으로 설치하는 도구 중 하나입니다.

1. Git 설치 파일 다운로드하기

아래 Git 공식 설치 페이지에 접속합니다.

https://git-scm.com/install/windows

Git - Install for Windows

Click here to download the latest (2.55.0(2)) x64 version of Git for Windows. This is the most recent maintained build. It was released on 2026-07-02. Other Git for Windows downloads Standalone Installer Git for Windows/x64 Setup. Git for Windows/ARM64 Set

git-scm.com

페이지에 접속하면 다음과 같은 다운로드 문구를 확인할 수 있습니다.

다운로드한 Git 설치 파일을 실행합니다.

설치 과정에서 여러 설정 화면이 나오지만 특별히 변경해야 할 사항이 없다면 기본값을 유지한 상태로 Next 버튼을 눌러 진행해도 됩니다.

2. Git 설치 확인하기

Git이 정상적으로 설치되었는지 확인해 보겠습니다.

PowerShell이나 명령 프롬프트를 열고 다음 명령어를 입력합니다.

git -v

다음과 같이 Git 버전이 표시되면 정상적으로 설치된 것입니다.

설치된 시점에 따라 표시되는 버전 번호는 다를 수 있습니다.

3. Git 사용자 이름과 이메일 확인하기

Git으로 커밋하면 해당 커밋을 작성한 사람의 이름과 이메일이 함께 기록됩니다.

현재 등록된 사용자 이름과 이메일은 다음 명령어로 확인할 수 있습니다.

사용자 이름 확인:

git config --global user.name

사용자 이메일 확인:

git config --global user.email

명령어를 실행했을 때 아무 내용도 표시되지 않는다면 아직 사용자 정보가 등록되지 않은 것입니다.

4. Git 사용자 이름과 이메일 등록하기

사용자 정보가 등록되어 있지 않다면 다음 명령어를 사용해 설정합니다.

사용자 이름 설정:

git config --global user.name "사용자 이름"

사용자 이메일 설정:

git config --global user.email "이메일 주소"

예를 들어 다음과 같이 입력할 수 있습니다.

git config --global user.name "example"
git config --global user.email "example@gmail.com"

사용자 이름은 GitHub에 등록한 아이디나 계정 이름을 사용하는 것이 관리하기 편리합니다.

이메일은 GitHub 계정에 등록된 이메일을 사용하는 것이 좋습니다.

GitHub에 등록되지 않은 이메일을 사용하면 커밋 기록이 GitHub 계정과 정상적으로 연결되지 않을 수 있습니다.

다시 3번의 명령어를 입력해서 name과 email이 출력된다면 설정이 완료되었습니다.

더 깊이 배우고 싶다면

클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지| 짐코딩 - 인프런 강의

www.inflearn.com

Node.js 설치하기 (Windows 기준)

콤수지 — Mon, 13 Jul 2026 20:08:47 +0900

이번 글에서는 Claude Code를 실행하기 위해 필요한 개발 환경을 설치해보도록 하겠습니다.

Node.js 설치하기

Node.js는 브라우저 밖에서도 JavaScript를 실행할 수 있게 해주는 프로그램입니다.

Node.js를 설치하면 패키지 관리 도구인 npm(Node Package Manager)도 함께 설치됩니다. npm을 사용하면 Claude Code를 비롯한 다양한 JavaScript 패키지를 명령어로 간편하게 설치할 수 있습니다.

먼저 Node.js 공식 다운로드 페이지에 접속합니다.

https://nodejs.org/ko/download

Node.js — Node.js® 다운로드

Node.js® is a free, open-source, cross-platform JavaScript runtime environment that lets developers create servers, web apps, command line tools and scripts.

nodejs.org

다운로드 페이지에는 여러 Node.js 버전이 표시될 수 있습니다. 이때는 최신 기능이 포함된 Current 버전보다 안정적으로 사용할 수 있는 LTS 버전을 선택하는 것을 권장합니다.

설치 과정에서는 특별히 변경할 설정이 없다면 기본값을 유지한 상태로 Next 버튼을 눌러 진행해도 됩니다.

Node.js 설치 확인하기

설치가 완료되었다면 Node.js가 정상적으로 설치되었는지 확인해 보겠습니다.

명령 프롬프트에 다음 명령어를 입력합니다.

node -v
npm -v

다음과 같이 설치된 버전이 표시되면 정상적으로 설치된 것입니다.

여기서 npm은 Node.js를 설치하면 npm도 자동으로 함께 설치됩니다.

❗npm 명령어가 실행되지 않는 경우에는

1. powershell을 관리자 권환으로 실행합니다.

2. 아래의 명령어를 입력해줍니다.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 실행 정책을 변경할 것인지 묻는 메시지가 표시되면 Y를 입력한 후 Enter 키를 누릅니다.

4. 다음 명령어를 다시 실행합니다.

npm -v

node -v와 npm -v 명령어가 잘 실행된다면 Claude Code를 설치하기 위한 기본 환경 준비가 완료된 것입니다.

더 깊이 배우고 싶다면

클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지| 짐코딩 - 인프런 강의

www.inflearn.com

클로드 코드 설치하기

콤수지 — Mon, 13 Jul 2026 15:32:22 +0900

Windows에서 Claude Code 설치하는 방법

Claude Code는 터미널에서 실행하는 AI 코딩 도구입니다. 이번 글에서는 Windows 환경에서 Claude Code를 설치하는 방법을 처음 사용하는 분도 따라 할 수 있도록 설명하겠습니다.

Claude Code의 공식 설치 방법은 Claude Code Docs의 시작하기 → 빠른 시작 페이지에서도 확인할 수 있습니다.

https://code.claude.com/docs/ko/quickstart

빠른 시작 - Claude Code Docs

Claude Code에 오신 것을 환영합니다!

code.claude.com

1. PowerShell 실행하기

먼저 Windows에서 PowerShell을 실행합니다.

Windows 시작 버튼을 누릅니다.
검색창에 PowerShell을 입력합니다.
Windows PowerShell 또는 PowerShell을 실행합니다.

PowerShell이 열리면 화면 앞부분에 다음과 같이 PS가 표시됩니다.

PS C:\Users\사용자이름>

PS가 보이지 않는다면 PowerShell이 아니라 CMD를 실행한 것일 수 있습니다.

2. Claude Code 설치하기

Windows PowerShell를 사용하는 경우

PowerShell에 다음 명령어를 붙여 넣고 Enter를 누릅니다.

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

명령어를 실행하면 Claude Code 설치 파일이 다운로드되고 자동으로 설치됩니다.

설치가 완료될 때까지 터미널을 종료하지 않고 기다립니다.

CMD를 사용하는 경우

PowerShell이 아닌 명령 프롬프트(CMD)를 사용하고 있다면 다음 명령어를 입력해야 합니다.

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

* PowerShell 명령어와 CMD 명령어는 서로 다릅니다. PowerShell에서는 화면에 PS C:\가 표시되고, CMD에서는 C:\만 표시됩니다.

3. 설치 여부 확인하기

설치가 끝났다면 PowerShell에 다음 명령어를 입력합니다.

claude --version

정상적으로 설치되었다면 다음과 같이 Claude Code의 버전 번호가 표시됩니다.

2.x.x

버전 번호가 표시되면 Claude Code 설치가 완료된 것입니다. claude -v 명령어를 사용해도 버전을 확인할 수 있습니다.

4. claude 명령어를 찾을 수 없다는 오류가 발생하는 경우

설치는 완료되었지만 다음과 같은 오류가 나타날 수 있습니다.

claude : 'claude' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램의 이름으로 인식되지 않습니다.

영문 Windows에서는 다음과 같은 메시지가 표시될 수 있습니다.

claude is not recognized

이 오류는 대부분 Claude Code가 설치된 폴더가 Windows의 Path 환경 변수에 등록되지 않았을 때 발생합니다.

Windows에서 Claude Code의 기본 설치 경로는 다음과 같습니다.

PowerShell 또는 CMD에서 Claude Code 설치가 완료되면 설치된 경로가 화면에 표시됩니다. 이후 환경 변수 설정에 사용해야 하므로 해당 경로를 복사해 둡니다.

%USERPROFILE%\.local\bin

실제 실행 파일은 다음 위치에 설치됩니다.

%USERPROFILE%\.local\bin\claude.exe

☑️ 설치 경로를 까먹었을 때 찾는 방법

기본 설치 경로는 항상 C:\Users\{사용자명}\.local\bin 입니다. 하지만 확실히 확인하고 싶다면 ...

방법 1: 다시 설치 명령 실행

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

이미 설치되어 있다면 다시 설치하지 않고 경로 정보만 다시 보여줍니다.

방법 2 : PowerShell에서 바로 찾기

Get-ChildItem -Path $env:USERPROFILE -Recurse -Filter "claude.exe" -ErrorAction SilentlyContinue | Select-Object FullName

위의 코드를 실행할 경우엔 사용자 폴더를 뒤져서 claude.exe 위치를 찾아줍니다.

5. Windows 환경 변수에 Claude Code 경로 추가하기

① 제어판에 "고급 시스템 설정 보기"를 검색합니다.

② 시스템 변수(S) 목록에서 Path를 선택한 뒤 편집 버튼을 클릭합니다.

③ 복사한 Claude Code Path를 새로 만들기를 통해 추가합니다.

6. 터미널 다시 실행하기

환경 변수를 수정한 뒤에는 기존 PowerShell 창에 변경 내용이 바로 적용되지 않을 수 있습니다.

열려 있는 PowerShell이나 CMD를 모두 종료한 다음 새로 실행합니다.

새 PowerShell에서 다시 다음 명령어를 입력합니다.

claude --version

버전 번호가 정상적으로 출력된다면 설치에 성공한 것입니다.

7. Claude Code 실행하기

설치가 완료되었다면 프로젝트 폴더로 이동한 뒤 다음 명령어를 입력합니다.

claude

Claude Code를 처음 실행하면 브라우저가 열리면서 Claude 계정 로그인을 요청할 수 있습니다. 화면의 안내에 따라 로그인을 완료하면 터미널에서 Claude Code를 사용할 수 있습니다.

더 깊이 배우고 싶다면

클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지| 짐코딩 - 인프런 강의