claude code 설정 완료 후 console에서 바로 적용하는 명령어

intellij를 재시작할 때마다 console에서 다시 명령어를 작성해야하는 경우가 있다. 이때는 아래와 같은 명령어를 복사 붙여넣기 하면된다.

 

$env:HOME='C:\DevHome'; $env:USERPROFILE='C:\DevHome'; npx -y @anthropic-ai/claude-code@latest --add-dir "C:\claude-workspace"

 

 

명령어 전체는 PowerShell 한 줄짜리 명령이고, 이렇게 3단계로 나뉜다:

$env:HOME='C:\DevHome';
$env:USERPROFILE='C:\DevHome';
npx -y @anthropic-ai/claude-code@latest --add-dir "C:\claude-workspace"

 

---

1. $env:HOME='C:\DevHome';

• 의미: PowerShell에서 환경변수 HOME 값을 C:\DevHome 으로 설정.
• 대상:
  • 현재 PowerShell 세션
  • 이 세션에서 실행되는 자식 프로세스들(Node, npx, claude-code 등)

즉, 원래 HOME 이 보통

C:\Users\이름

같은 경로일 텐데, 이 명령을 통해 “내 홈폴더는 이제 C:\DevHome 이라고 생각해라” 라고 임시로 바꾸는 것이다.

이유
CLI 도구들이 한글 경로나 공백이 있는 경로(C:\Users\이)에서 깨지거나 에러 나는 걸 피하기 위해
일부러 영어로만 된 깔끔한 경로를 홈 디렉터리로 지정하는 패턴.

---

2. $env:USERPROFILE='C:\DevHome';

• 의미: 환경변수 USERPROFILE 도 C:\DevHome 으로 설정.
• Windows에서는 HOME 말고도 USERPROFILE을 사용자 홈 경로로 보는 프로그램이 많아서 둘을 같은 경로로 맞춰 쓰는 것.

그래서 이 시점 이후에 실행되는 프로그램들은:

• “사용자 폴더” = C:\DevHome
• 설정 파일, 캐시, 로그, 워크스페이스 등을 C:\DevHome 기준으로 만들 가능성이 큼

---

3. npx -y @anthropic-ai/claude-code@latest --add-dir "C:\claude-workspace"

이제 본명령.

3-1. npx

• Node.js에 딸려오는 패키지 실행기.
• npm install 없이도,
  npm에 올라와 있는 패키지를 바로 한 번 실행할 때 쓰는 도구.

3-2. -y

• npx가 물어볼 수 있는 질문들(예: “이 패키지를 설치할까요?”)에 대해
  자동으로 yes 처리.
• 즉, 아무 추가 입력 없이 바로 패키지를 내려받고 실행하게 함.

3-3. @anthropic-ai/claude-code@latest

• 실행할 npm 패키지 이름: @anthropic-ai/claude-code
• @latest ⇒ 항상 가장 최신 버전을 쓰겠다는 의미.
• 이 패키지는 Anthropic에서 만든 claude-code CLI(터미널용 Claude 코딩 도우미).

그래서 여기까지를 합치면:

“최신 버전의 claude-code CLI를, npx로 바로 내려받아서 실행해라”

라는 뜻.

3-4. --add-dir "C:\claude-workspace"

claude-code 프로그램에 전달되는 옵션.

• 의미: "C:\claude-workspace" 디렉터리를 Claude 코드 워크스페이스에 추가하라는 뜻.
• 내부적으로는:
  • C:\claude-workspace 폴더를 스캔해서 파일 목록을 읽고
  • 이 디렉터리를 “프로젝트 디렉터리”로 등록해서
    앞으로 Claude가 이 폴더 안의 소스코드/파일들을 맥락(Context)으로 사용할 수 있게 만드는 역할을 함.

쉽게 풀어서 얘기하자면:
“이 폴더 전체를 Claude 코드 어시스턴트에게 보여줘서,
코드 분석·리팩터링·질문 등을 할 수 있게 준비시켜라.”

---

4. 한 줄로 정리하면

이 명령어 전체는:

1. 홈 디렉터리 환경변수(HOME, USERPROFILE)를
   C:\DevHome으로 바꿔서
   • 한글 경로/공백 문제를 피하고
   • 설정/캐시가 영어 경로 쪽에 쌓이도록 만들고
2. 그 상태에서
   • npx로 최신 @anthropic-ai/claude-code CLI를 실행하면서
   • C:\claude-workspace 폴더를 Claude 작업공간으로 등록하는 명령어.

---

5. 실제로 쓰일 때의 상황 정리

• C:\Users\이름 처럼 한글이 들어간 기본 사용자 폴더에서
  bun / claude-code / Node 도구들이 경로 인코딩 문제로 깨지거나 에러 발생
• 그래서:
  • C:\DevHome 같은 영어 전용 홈 폴더를 하나 만들고
  • C:\claude-workspace에 프로젝트(예: orange-brook-ac24)를 넣어두고
• 위 명령어를 실행해서:
  • “지금부터는 사용자 홈 = C:\DevHome이야
  • “그리고 이 프로젝트 폴더 전체를 Claude에 등록해줘”

라는 식으로 설정하는 것.

---

6. 더 체계적으로 사용하고 싶을 때

1. 먼저 폴더 존재 확인:
2. mkdir C:\DevHome -Force mkdir C:\claude-workspace -Force
3. 그 다음 방금 명령 실행:
4. $env:HOME='C:\DevHome'; $env:USERPROFILE='C:\DevHome'; npx -y @anthropic-ai/claude-code@latest --add-dir "C:\claude-workspace"