Claude Code CLI

Claude Code 설치와 클코클라우드 연결 설정 안내입니다. 설치는 공식 권장 방식인 네이티브 인스톨러가 기본이고, npm은 대체 방법이에요. 지원 모델은 입니다.

CLI 설치

네이티브 인스톨러 (권장)

Node.js가 필요 없고 자동으로 최신 버전이 유지돼요. 터미널에서 한 줄만 실행하세요. (공식 문서 기준 · 2026-08 확인)

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

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

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

패키지 매니저

Homebrew(macOS)나 WinGet(Windows)으로도 설치할 수 있어요. 자동 업데이트는 직접 해줘야 해요.

1brew install --cask claude-code

1winget install Anthropic.ClaudeCode

npm (대체 방법)

기존에 npm으로 설치하던 방식도 계속 동작해요. Node.js 22 이상이 필요하고, 이미 npm 버전이 있다면 claude install 로 네이티브 설치로 전환할 수 있어요.

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

설치 확인

아래 명령으로 설치 상태를 확인할 수 있어요.

1claude --version2claude doctor

클코클라우드 연결 (환경 변수)

설치가 끝났다면 클코클라우드 연결 값을 넣어요. OS에 맞는 탭을 선택해 실행하세요.

1sed -i '' '/export ANTHROPIC_API_KEY/d' ~/.zshrc2echo 'export ANTHROPIC_BASE_URL="https://api.clcocloud.com/claude/v1"' >> ~/.zshrc3echo 'export ANTHROPIC_AUTH_TOKEN="여기에_발급받은_API키를_넣어주세요"' >> ~/.zshrc4echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.zshrc5unset ANTHROPIC_API_KEY6source ~/.zshrc7claude /logout

환경변수 코드는 무엇을 의미하나요?

1. 기존 API 키가 먼저 잡히지 않도록 제거합니다.
2. 요청이 클코클라우드 API 엔드포인트로 향하도록 BASE_URL을 지정합니다.
3. 발급받은 키를 AUTH_TOKEN에 넣어 인증합니다.
4. 불필요한 원격 트래픽을 줄이고 기존 CLI 세션을 정리합니다.