Windows 및 Mac에서 Claude Code를 쉽게 설치하는 방법

Windows 또는 Mac에 Claude Code를 빠르게 설치하고 환경을 구성한 뒤 Kimi API와 연동하여 고급 AI 워크플로를 활용하세요. 복잡한 작업을 자동화하고 여러 단계의 프로세스를 실행하며, 더욱 스마트한 AI 통합으로 코딩 경험을 향상할 수 있습니다.

10분 읽기업데이트: 2026-09-28

Claude Code를 Kimi API와 연결하기

더 빠르게 작업하고 업무를 효율적으로 처리하려는 개발자들 사이에서 AI 코딩 도구가 인기 있는 선택지가 되고 있습니다. 많은 사용자가 코딩 워크플로를 간소화하고 반복 작업을 자동화하며 하나의 환경에서 여러 단계의 프로세스를 관리하기 위해 Claude Code를 설치합니다. Windows 또는 Mac에서 올바르게 설정하면 원활한 성능과 고급 AI 서비스와의 더 나은 통합을 보장하는 데 도움이 됩니다. 계속 읽고 Windows와 Mac에 Claude Code를 설치하는 방법을 알아보세요.

Windows에 Claude Code를 설치하는 방법

Windows 11은 최신 AI 개발 도구를 실행하기에 원활한 환경을 제공합니다. 몇 가지 간단한 설정 단계만 거치면 Claude Code가 제대로 작동하고 사용할 서비스에 연결되도록 할 수 있습니다. 아래 안내에 따라 설치를 완료하고 문제 없이 기능을 사용해 보세요.

1단계: PowerShell을 사용해 Claude Code 설치하기

Win + S를 누르고 "PowerShell"을 검색하여 PowerShell을 엽니다. 아래 설치 명령어를 PowerShell에 복사하여 붙여넣은 다음 "Enter"를 눌러 실행하세요:

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

PowerShell이 Claude Code를 자동으로 다운로드하고 설치합니다. 계속하기 전에 설치가 완료될 때까지 기다리세요. CMD 또는 WinGet을 선호한다면, Claude Code 공식 문서에서 다른 설치 방법도 확인할 수 있습니다.

2단계: Git 설치 및 Git Bash 실행하기

Windows용 Git을 다운로드하여 설치합니다. Claude Code가 필요한 명령줄 도구에 액세스하고 제대로 실행될 수 있도록 기본 설치 설정을 그대로 유지하세요.

Git을 다운로드한 후 설치 관리자를 열고 기본 설정으로 설치를 완료하세요. 설치 경로는 변경하지 말고, 선택하라는 메시지가 표시되면 기본 편집기로 "Visual Studio Code"를 선택하세요. 또한 PATH 구성 옵션에서 "Git from the command line and 3rd-party software"가 선택되어 있는지 확인하세요.

설치가 완료되면 시작 메뉴에서 "Git Bash"를 열어 Git이 정상적으로 작동하는지 확인하세요. Git Bash는 Claude Code가 Windows에서 명령을 실행하는 데 필요한 터미널 환경을 제공합니다.

3단계: Claude Code 설치 확인

PowerShell 또는 명령 프롬프트로 돌아가 다음을 실행하세요:

claude --version

버전 번호가 표시되면 Claude Code가 성공적으로 설치된 것입니다. 표시되지 않으면 PATH 구성 단계를 계속 진행하세요.

4단계: 설치 완료

모든 작업이 끝나면 Claude Code에 로그인하여 설정을 완료하세요. 로그인 후에는 Windows 11의 터미널에서 직접 명령을 실행하고 AI-지원 워크플로를 관리할 수 있습니다.

Mac/macOS에서 Claude Code를 설치하는 방법은?

macOS는 내장된 터미널 지원을 통해 개발 도구를 깔끔하고 간편하게 설정할 수 있어, 개발자가 일관된 방식으로 원활하게 설치할 수 있습니다. Claude Code는 명확한 터미널 기반 절차에 따라 설정할 수 있어 모든 항목을 체계적으로 관리하기 쉽습니다. Mac에서 Claude Code를 설치하는 방법은 다음과 같습니다.

1단계: 터미널에서 Claude Code 설치(curl 명령)

Spotlight 검색(Cmd + Space → "Terminal" 입력)을 사용해 Mac에서 "Terminal"을 여세요. 아래 설치 명령을 Terminal에 복사하여 붙여넣고 "Enter"를 누르세요:

curl -fsSL https://claude.ai/install.sh | bash

Terminal이 Claude Code를 자동으로 다운로드하고 설치합니다. 다음 단계로 넘어가기 전에 설치가 완료될 때까지 기다리세요.

2단계: Claude Code 설치 확인

설치 프로세스가 완전히 끝날 때까지 기다리세요. 완료되면 Claude Code가 성공적으로 설치되었다는 확인 메시지가 표시됩니다. 터미널에서 추가 설정을 요청하면, 적절히 접근할 수 있도록 Claude Code를 zshrc 구성 파일에 추가하는 안내 명령을 실행하세요.

3단계: 환경 구성 불러오기

설치 후 제공된 명령을 실행하거나 셸 구성 파일을 다시 불러오세요. 이 단계에서는 환경 변수가 업데이트되어 경로 문제 없이 터미널 어디서나 Claude Code를 사용할 수 있습니다. 새 터미널 창을 열 때마다 원활하게 접근할 수 있습니다.

4단계: Claude Code 실행

Terminal에 다음을 입력하세요:

claude

Enter를 누르면 Claude Code CLI가 시작됩니다. 설정 화면에서 원하는 테마와 로그인 방식을 선택해 최종 구성을 완료할 수 있습니다.

다른 LLM API를 Claude Code에 통합하는 방법은?

Claude Code를 외부 AI 모델과 함께 사용하면 개발 환경의 유연성이 높아집니다. 타사 LLM API를 연결하면 개발자는 하나의 환경에서 다양한 모델을 실행하고 작업을 더 효율적으로 관리할 수 있습니다. 예를 들어, 긴 컨텍스트 이해와 구조화된 출력에 강점이 있는 API는 코딩 워크플로를 더욱 개선할 수 있습니다. 다음 단계에서는 Kimi를 예로 들어 외부 LLM API를 Claude Code에 연결하는 방법을 설명합니다.

1단계****: Kimi Code API 키 발급

참고: 이 가이드에서 사용하는 api.kimi.ai/coding/ 엔드포인트는 Kimi Code 멤버십 혜택에 포함됩니다. 키를 만들기 전에 Kimi Code 혜택이 활성화된 유효한 Kimi 멤버십이 있는지 확인하세요. 무료 계정의 키는 실행 시 거부됩니다.

Kimi Code Console으로 이동해 Create API Key를 클릭하고 이름을 입력한 뒤 확인하세요. 그런 다음 키를 즉시 복사하세요. 전체 키는 한 번만 표시됩니다. 사용할 수 있는 모델과 컨텍스트 윈도우는 멤버십 플랜에 따라 다릅니다(예: 기존 Andante 플랜은 컨텍스트 1M의 kimi-for-coding을 사용하며, Plus/Moderato 플랜은 k3-256k를 사용할 수 있고, Pro/Allegretto 이상 플랜은 컨텍스트 1M의 k3 또는 고속 변형을 사용할 수 있습니다).

Claude Code를 Kimi API와 연결하기

2단계****: 로그인 건너뛰기 (선택 사항 설정 스크립트)

설치 후에는 아직 Claude Code를 시작하지 마세요. 터미널에서 다음 스크립트를 실행해 기본 온보딩/로그인 흐름을 건너뛰고 기존 설정을 정리하세요. 이 스크립트는 타사 모델 지원과 빠른 모드를 활성화하고, ~/.claude/settings.json에서 오래된 엔드포인트, 자격 증명, 모델 항목을 제거합니다(이 파일에 남아 있는 항목은 터미널에서 내보낸 환경 변수보다 우선 적용됩니다):

node --eval " // enable third party model support and fast mode const claudeJsonFilePath = path.join(os.homedir(), '.claude.json'); if (fs.existsSync(claudeJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeJsonFilePath, 'utf-8')); fs.writeFileSync(claudeJsonFilePath, JSON.stringify(Object.assign({}, content, { penguinModeOrgEnabled: true, hasCompletedOnboarding: true }), null, 2), 'utf-8'); } else { fs.writeFileSync(claudeJsonFilePath, JSON.stringify({ penguinModeOrgEnabled: true, hasCompletedOnboarding: true }, null, 2), 'utf-8'); } // delete old endpoint, credential and model id const claudeSettingsJsonFilePath = path.join(os.homedir(), '.claude', 'settings.json'); if (fs.existsSync(claudeSettingsJsonFilePath)) { const content = JSON.parse(fs.readFileSync(claudeSettingsJsonFilePath, 'utf-8')); if (typeof content === 'object' && typeof content.env === 'object') { for (const element of [ 'ANTHROPIC_BASE_URL', 'ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'ANTHROPIC_MODEL', 'ANTHROPIC_SMALL_FAST_MODEL', 'CLAUDE_CODE_SUBAGENT_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL', 'ANTHROPIC_DEFAULT_FABLE_MODEL_NAME', 'ANTHROPIC_DEFAULT_OPUS_MODEL', 'ANTHROPIC_DEFAULT_OPUS_MODEL_NAME', 'ANTHROPIC_DEFAULT_SONNET_MODEL', 'ANTHROPIC_DEFAULT_SONNET_MODEL_NAME', 'ANTHROPIC_DEFAULT_HAIKU_MODEL', 'ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME', 'ENABLE_TOOL_SEARCH', 'CLAUDE_CODE_AUTO_COMPACT_WINDOW', 'CLAUDE_CODE_EFFORT_LEVEL', ]) { delete content.env[element]; } fs.writeFileSync(claudeSettingsJsonFilePath, JSON.stringify(content, null, 2), 'utf-8'); } }"

이 스크립트를 실행하려면 Node.js가 필요합니다(node --version으로 확인하세요. 명령을 찾을 수 없으면 먼저 nodejs.org에서 LTS 버전을 설치하세요). 성공하면 아무 출력도 표시되지 않으며, 이는 정상입니다. 또한 ~/.zshrc, ~/.bashrc 같은 셸 설정 파일에서 오래된 ANTHROPIC_* 내보내기 설정을 확인해 삭제하세요(Windows 사용자는 사용자 환경 변수를 확인하세요). 그렇지 않으면 새 설정과 충돌합니다.

3단계: API 액세스 설정 및 Claude Code 실행

두 가지 설정 방법이 있습니다. 하나만 선택하고 함께 사용하지 마세요. 방법 1은 ~/.claude/settings.json에 기록되어 영구 적용되며, 방법 2는 현재 터미널에서만 변수를 내보내므로 해당 세션에서만 적용됩니다. 아래 예시는 k3-256k(256K 컨텍스트)를 사용합니다. 플랜에 1M 컨텍스트의 k3가 포함되어 있다면 모든 모델 값을 k3[1m]로 바꾸고 두 컨텍스트 값을 모두 1048576으로 설정하세요.

방법 1: settings.json에 기록(권장, 영구 적용)

다음을 ~/.claude/settings.json의 env 필드에 입력하세요(Windows: %USERPROFILE%\.claude\settings.json, 파일이 없으면 만드세요). তারপর 적용하려면 Claude Code를 다시 시작하세요:

{ "env": { "ANTHROPIC_BASE_URL": "https://api.kimi.ai/coding/", "ANTHROPIC_API_KEY": "Your API Key", "ANTHROPIC_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3-256k", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3-256k", "CLAUDE_CODE_SUBAGENT_MODEL": "k3-256k", "CLAUDE_CODE_EFFORT_LEVEL": "high", "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144", "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144" } }

Your API Key를 1단계에서 복사한 키로 바꾸세요. 이 파일에는 키가 일반 텍스트로 저장되므로 git에 커밋하지 마세요. settings.json의 env 블록은 터미널에서 내보낸 같은 이름의 변수보다 우선 적용됩니다.

방법 2: 터미널 환경 변수(현재 세션에만 적용)

macOS / Linux

export ANTHROPIC_BASE_URL=https://api.kimi.ai/coding/ export ANTHROPIC_API_KEY="Your API Key" export ANTHROPIC_MODEL="k3-256k" export ANTHROPIC_DEFAULT_FABLE_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_OPUS_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_SONNET_MODEL=$ANTHROPIC_MODEL export ANTHROPIC_DEFAULT_HAIKU_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_SUBAGENT_MODEL=$ANTHROPIC_MODEL export CLAUDE_CODE_EFFORT_LEVEL=high export CLAUDE_CODE_AUTO_COMPACT_WINDOW=262144 export CLAUDE_CODE_MAX_CONTEXT_TOKENS=262144 claude

Windows

PowerShell 또는 시스템 설정에서 동일한 환경 변수를 설정한 후 다음을 실행하세요:

$env:ANTHROPIC_BASE_URL="https://api.kimi.ai/coding/" $env:ANTHROPIC_API_KEY="Your API Key" $env:ANTHROPIC_MODEL="k3-256k" $env:ANTHROPIC_DEFAULT_FABLE_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_OPUS_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_SONNET_MODEL=$env:ANTHROPIC_MODEL $env:ANTHROPIC_DEFAULT_HAIKU_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_SUBAGENT_MODEL=$env:ANTHROPIC_MODEL $env:CLAUDE_CODE_EFFORT_LEVEL="high" $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="262144" $env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="262144" claude

Your API Key를 1단계에서 복사한 키로 바꾸세요. 모델 변수 중 일부만 설정하면 해당 시나리오(주 대화, 백그라운드 요약, 하위 에이전트)가 오류 메시지 없이 실패하므로, 전체 항목을 모두 유지하세요.

이 API 키를 사용할지 묻는 메시지가 나타나면 확인하여 계속하세요. 이후 프롬프트에 따라 신뢰할 수 있는 프로젝트 폴더를 선택하면 인증이 완료됩니다.

4단계****: 통합 상태 확인

실행 후 다음을 입력하세요:

/status

Base URL에 다음이 표시되면:

https://api.kimi.ai/coding/

통합이 성공적으로 완료된 것입니다. 인터페이스에 여전히 Claude 모델이 표시되더라도 모든 요청은 Kimi Code API를 통해 처리됩니다.

Kimi API 사용의 장점

개발에 고급 AI 도구를 활용하는 일은 작업 속도를 높이고 전반적인 코드 품질을 개선하는 실용적인 방법이 되었습니다. Kimi API는 실제 프로젝트에서 이해, 자동화, 팀 기반 워크플로를 강력하게 지원합니다. 개발자가 시스템을 더 효율적으로 구축하고 관리하는 데 어떻게 도움이 되는지 살펴보겠습니다.

개발 작업을 위한 멀티모달 컨텍스트 이해

Kimi API는 텍스트, 디자인 목업, 아키텍처 다이어그램, 플로차트, 동영상 등 다양한 유형의 입력을 이해합니다. 이 정보를 개발자가 바로 활용할 수 있는 명확한 기술 계획으로 변환합니다. 따라서 수동 계획 작업을 줄이면서 아이디어를 작동하는 코드로 구현할 수 있습니다.

컨텍스트 재사용으로 비용 효율성 향상

Kimi API는 컨텍스트 재사용을 지원하므로 개발자는 동일한 정보를 반복해서 전송하지 않고 기존 대화와 프로젝트 컨텍스트를 계속 활용할 수 있습니다. 이를 통해 불필요한 token 사용량과 API 비용을 줄이고 장기 개발 워크플로의 효율을 높일 수 있습니다.

반복적인 엔지니어링 워크플로 자동화

일상적이고 반복적인 코딩 작업은 스크립트나 AI 기반 워크플로를 사용해 자동화할 수 있습니다. 매번 수작업을 하지 않아도 간단한 명령으로 이러한 작업을 실행할 수 있습니다. 이를 통해 시간을 절약하고 일상적인 개발 과정에서 발생할 수 있는 인적 오류를 줄일 수 있습니다.

Skills와 도구를 활용한 맞춤형 개발 워크플로

Kimi API는 다양한 개발 요구에 맞는 맞춤형 Skills와 도구 통합을 지원합니다. 팀은 자체 내부 도구, 스크립트, 시스템을 워크플로에 직접 연결할 수 있습니다. 이를 통해 개발 과정을 더욱 유연하게 만들고 프로젝트별 요구에 맞출 수 있습니다.

더 높은 품질과 효율성을 위한 멀티 에이전트 협업

서로 다른 AI 에이전트가 코딩, 테스트, 아키텍처, 문서화 등 각기 다른 역할을 담당합니다. 이 에이전트들은 순차적으로 또는 병렬로 협업하여 작업을 더 빠르게 완료할 수 있습니다. 이를 통해 개발 속도와 전체 결과물의 품질을 모두 향상할 수 있습니다.

Claude Code 설치 문제 해결

Windows 또는 Mac에 Claude Code를 설치할 때 환경 설정, Node.js 버전 또는 네트워크 상태로 인해 간단한 기술 문제가 발생하는 경우가 있습니다. 이러한 문제는 CLI 기반 도구에서 흔하며, 대체로 해결할 수 있습니다. 아래에서는 가장 자주 발생하는 문제와 실질적인 이해 방법을 안내합니다.

"command not found: claude"

이 오류는 일반적으로 Claude Code가 시스템 PATH에 추가되지 않았음을 의미합니다. 터미널이 설치된 바이너리 파일을 찾을 수 없는 상태입니다. 대부분의 경우 터미널을 다시 시작하거나 PATH 설정을 수정하면 빠르고 안정적으로 해결됩니다.

인증에 실패하거나 브라우저가 열리지 않음

로그인 과정에서 브라우저를 자동으로 실행하지 못할 때 발생하며, 제한된 시스템이나 원격 환경에서 자주 나타납니다. 이 경우 API 키를 사용해 수동으로 인증해야 할 수 있습니다. 설정을 마치면 이후에는 문제없이 정상적으로 로그인할 수 있습니다.

설치 중 "Network Error" 또는 시간 초과 발생

인터넷 연결이 느리거나 방화벽 제한, npm 접근 차단 때문에 발생하는 경우가 많습니다. 설치 프로그램이 설정 중에 필요한 서버에 연결하지 못할 수 있습니다. 네트워크 설정이나 프록시 구성을 조정하거나 연결을 변경하면 대체로 효과적으로 해결할 수 있습니다.

Claude Code가 느리게 실행됨

성능 문제는 일반적으로 도구 자체가 아니라 네트워크 지연 때문에 발생합니다. Claude Code는 클라우드 API 요청에 의존하므로, 불안정한 인터넷 연결이나 VPN 사용으로 인해 속도가 느려질 수 있습니다. 안정적인 연결을 사용하면 대체로 속도가 크게, 그리고 일관되게 개선됩니다.

결론

Windows 또는 Mac에서 Claude Code를 설치하는 방법을 익히면 AI 지원 개발 워크플로를 더 원활하게 시작할 수 있습니다. 설정이 완료되면 코딩 작업을 더 효율적으로 관리하고, 더욱 통합된 환경에서 일상적인 개발 업무를 간소화할 수 있습니다. 더 고급스럽거나 유연한 활용이 필요하다면 Kimi API를 사용해 이러한 기능을 확장하고 실제 개발 워크플로를 개선할 수 있습니다.

Claude Code를 Kimi API와 연결하기

자주 묻는 질문

터미널 또는 PowerShell을 열고 claude 명령어를 입력하면 Claude Code를 시작할 수 있습니다. Enter를 누르면 CLI 인터페이스가 실행됩니다. 설치가 제대로 완료되었다면 설정 화면이 나타나 로그인 또는 프로젝트 선택 과정을 안내합니다. 이후부터는 터미널에서 바로 명령어를 사용할 수 있습니다.

유료 구독이 항상 필요한 것은 아니지만, 일부 기능은 요금제나 액세스 수준에 따라 달라질 수 있습니다. 구성에 따라 기본 사용 및 설정은 일반 액세스만으로도 가능한 경우가 많습니다. 고급 기능이나 더 높은 한도를 사용하려면 구독이 필요할 수 있습니다. 정확한 내용은 공식 Claude 요금제 정보를 확인하는 것이 좋습니다.

Kimi API는 Claude Code 내에서 고급 컨텍스트 처리, 자동화, 여러 단계의 워크플로를 지원합니다. 긴 입력, 구조화된 작업, 복잡한 개발 지침을 더 효율적으로 처리할 수 있도록 돕습니다. 이를 통해 코딩 중 속도는 높아지고 수작업은 줄어듭니다. 전반적으로 워크플로를 더 유연하고 생산적으로 만들어 줍니다.

다음도 마음에 드실 수 있습니다