Windows 11에서 ollama launch claude 사용법

Windows 11에서 ollama launch claude 사용법

작성자:

Windows 11에서 ollama launch claude 사용법을 가장 최신(2026년 기준)으로 자세히 정리해드립니다.

Windows 11에서는 PowerShell을 주로 사용하며, 설치와 실행이 macOS/Linux와 거의 동일하지만 설치 명령어가 약간 다릅니다.

1. 준비사항 (하드웨어 추천)

  • RAM: 최소 16GB (추천 32GB 이상)
  • GPU: NVIDIA GPU 있으면 좋음 (CUDA 지원 모델 사용 시 빠름). 없으면 CPU 모드나 Ollama Cloud 모델(:cloud 태그) 사용
  • 디스크 공간: 큰 모델(14b~32b)은 10~50GB 정도 필요
  • 권장 모델:
    • 빠르고 가벼움: glm-4.7-flash 또는 glm-5:cloud
    • 코딩 성능 좋음: qwen2.5-coder:14b 또는 qwen3.5-coder
    • 강력 추천 (Cloud): kimi-k2.5:cloud, glm-5:cloud

2. Ollama 설치 (Windows 전용)

  1. 브라우저에서 https://ollama.com/download 접속
  2. Windows 버튼 클릭 → OllamaSetup.exe 다운로드 및 실행
  3. 설치 완료 후 Ollama 앱이 백그라운드에서 자동 실행됩니다. (트레이 아이콘 확인)

설치 확인 (PowerShell 열기):

PowerShell
ollama --version

3. Claude Code 설치 (Windows 전용)

PowerShell (관리자 권한 아님, 일반 권한으로 충분)을 열고 아래 명령어 실행:

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

설치 후 PATH 추가가 필요할 수 있습니다. 설치 완료 메시지에 나오는 경로(C:\Users\YourName\.local\bin)를 시스템 PATH에 추가하세요.

  • 추가 방법:
    1. Windows 검색 → “환경 변수 편집” 입력
    2. “시스템 환경 변수 편집” → “환경 변수” 버튼
    3. “사용자 변수” 또는 “시스템 변수”의 Path 더블클릭
    4. C:\Users\사용자명\.local\bin 경로 추가 → 확인

설치 확인:

PowerShell
claude --version

(만약 claude 명령어가 안 되면 PowerShell을 재시작하거나 PC 재부팅)

4. 코딩용 모델 다운로드

PowerShell에서 실행:

PowerShell
# 추천 모델 예시
ollama pull glm-4.7-flash          # 빠름
ollama pull qwen2.5-coder:14b      # 코딩 성능 좋음 (VRAM 10GB+ 필요)
ollama pull kimi-k2.5:cloud        # 클라우드 모델 (인터넷 필요, GPU 없이도 강력)

모델 목록 보기: ollama list

5. ollama launch claude 실행 방법 (가장 쉬운 방법)

프로젝트 폴더에서 PowerShell을 열고 실행하세요.

기본 실행 (모델 선택 화면 나옴):

PowerShell
ollama launch claude

특정 모델 바로 실행 (추천):

PowerShell
ollama launch claude --model qwen2.5-coder:14b

자동 pull + 확인 생략:

PowerShell
ollama launch claude --model kimi-k2.5:cloud --yes

실행 후:

  • 테마 선택 (Dark/Light)
  • “Do you trust this folder?” → yes 입력 (파일 읽기/쓰기 권한 부여)
  • Claude Code 프롬프트(>)가 나오면 사용 시작

6. 수동 설정 방법 (ollama launch가 안 될 때 대안)

PowerShell에서 환경변수 설정:

PowerShell
$env:ANTHROPIC_AUTH_TOKEN = "ollama"
$env:ANTHROPIC_BASE_URL = "http://localhost:11434"

그 후 직접 실행:

PowerShell
claude --model qwen2.5-coder:14b

이 설정을 매번 하기 싫으면 PowerShell 프로필에 추가할 수 있습니다.

  • $PROFILE 명령어로 프로필 파일 열기
  • 위 환경변수 두 줄 추가 후 저장

7. 실제 사용법 (프로젝트 안에서)

Claude Code가 실행된 후:

  • 프로젝트 초기화 (강력 추천):
    text
    /init

    → CLAUDE.md 파일 자동 생성 (프로젝트 구조, 기술 스택, 명령어 등 분석)

  • 파일 읽기:
    text
    현재 폴더 구조를 분석해줘
@app.py 내용을 자세히 보여줘
  • 파일 수정:
    text
    login 기능을 추가해줘. JWT 인증 구현하고, 관련 파일 모두 수정해.

Claude가 자동으로 파일을 읽고, diff 형식으로 수정 제안을 합니다. Apply 또는 yes 입력하면 실제로 파일이 수정됩니다.

  • 명령어 실행:
    text
    이 코드를 테스트해보고 에러 고쳐줘

유용한 단축키/명령어:

  • @파일명 또는 @폴더명 → 컨텍스트에 추가
  • /clear → 대화 초기화
  • /permissions → 권한 확인
  • Ctrl + C → 종료

8. Windows에서 자주 발생하는 문제와 해결법

Windows 11에서 ollama launch claude 사용법

  1. “I cannot directly access your files” 오류
    • 프로젝트 폴더에서 yes로 trust 승인
    • CLAUDE.md 파일 생성 후 /init 실행
    • 관리자 권한 PowerShell로 재시작 시도 (권장하지 않음)
  2. ollama launch 명령어가 인식 안 됨
    • Ollama 재설치 또는 업데이트 (ollama –version 확인 후 최신 버전으로)
    • PC 재부팅
  3. 느리거나 메모리 부족
    • 작은 모델 사용 (:7b 또는 :cloud 태그)
    • Ollama 설정에서 GPU 사용 확인 (NVIDIA GPU 있으면 자동)
  4. PATH 문제
    • Claude 설치 후 PowerShell 재시작 또는 PATH 수동 추가
  5. WSL 사용 중이라면
    • Ollama는 Windows에 설치하고, WSL에서는 별도 브릿지 설정 필요 (localhost가 Windows와 WSL에서 다름)

9. 추가 팁

  • 매 프로젝트마다 프로젝트 루트에 CLAUDE.md를 만들어 두면 Claude가 더 정확하게 작업합니다. (아키텍처, 빌드 명령어, 금지사항 등 기록)
  • 처음 시작할 때 /init 명령어를 꼭 실행하세요.
  • 보안상 중요한 프로젝트에서는 –dangerously-skip-permissions는 피하세요.
  • VS Code 안에서 터미널을 열고 사용하면 더 편합니다.

이 방법으로 Windows 11에서도 완전 무료, 로컬 실행 가능한 Claude Code 에이전트를 사용할 수 있습니다.

설치 중 특정 에러가 발생하거나, 특정 모델에서 파일 수정이 잘 안 된다면 정확한 에러 메시지를 알려주세요. 더 구체적으로 도와드리겠습니다!