Claude Code 설정

이 가이드는 Claude Code를 Modelflare에 연결하고 첫 번째 성공적인 요청을 보냅니다. 자동 설정을 위해서는 옵션 A를 사용하세요. 옵션 B를 사용하여 Claude Code를 먼저 설치한 다음 사용자 설정을 직접 생성하세요.

1. API 키 생성

기본이 아닌 그룹이 claude-opus-4-8 및 claude-sonnet-5에 액세스할 수 있는 Modelflare API 키를 생성합니다. 전체 키를 준비하세요. 설치 프로그램이 한 번 요청합니다.

2. 설정방법을 선택하세요

옵션 A: 설치 프로그램 실행

아직 단말기가 불편하신가요? 대화형 첫 실행 가이드로 시작하세요. 이것은 단지 시각적인 리허설일 뿐이며 컴퓨터를 바꾸지는 않습니다.

macOS 또는 Linux

일반 사용자로 다음 명령을 실행하세요.

bash

curl -fsSL https://modelflare.dev/install/claude.sh | sh

이미 VPS 또는 컨테이너에 root으로 로그인한 경우 다음을 사용하세요.

bash

curl -fsSL https://modelflare.dev/install/claude.sh | MODELFLARE_ALLOW_ROOT=1 sh

개인용 컴퓨터에 sudo을 추가하지 마십시오.

윈도우 파워셸

일반 Windows 사용자로 PowerShell을 열고 다음을 실행합니다.

PowerShell

irm https://modelflare.dev/install/claude.ps1 | iex

설치 프로그램은 중국어 간체, 일본어 또는 영어를 선택하도록 요청하고, 필요할 때 공식 Claude Code CLI를 설치하고, Modelflare API 키를 한 번 요청하고, 기존 사용자 설정을 백업 및 병합하고, 구성된 두 모델을 모두 확인합니다. Claude Code는 자동으로 시작되지 않습니다.

옵션 B: Claude Code를 수동으로 구성

각 단계를 순서대로 따르고 운영 체제에 맞는 명령만 실행하세요.

1단계: Claude Code 설치

윈도우 파워셸

PowerShell

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

리눅스

bash

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

맥OS

bash

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

2단계: 사용자 설정 디렉터리 생성 및 입력

윈도우 파워셸

PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
Set-Location "$HOME\.claude"

리눅스

bash

mkdir -p ~/.claude
cd ~/.claude

맥OS

bash

mkdir -p ~/.claude
cd ~/.claude

3단계: settings.json 생성

시스템에 대한 명령을 실행하기 전에 YOUR_MODELFLARE_API_KEY을 전체 Modelflare API 키로 바꾸세요.

윈도우 파워셸

PowerShell

$settings = @'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelflare.dev",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MODELFLARE_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "settings.json"),
  $settings,
  $utf8NoBom
)

리눅스

bash

cat > settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelflare.dev",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MODELFLARE_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}
EOF
chmod 600 settings.json

맥OS

bash

cat > settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelflare.dev",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MODELFLARE_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}
EOF
chmod 600 settings.json

4단계: Claude Code 시작

윈도우 파워셸

PowerShell

Set-Location $HOME
New-Item -ItemType Directory -Force "my-claude-project" | Out-Null
Set-Location "my-claude-project"
claude

리눅스

bash

cd ~
mkdir -p my-claude-project
cd my-claude-project
claude

맥OS

bash

cd ~
mkdir -p my-claude-project
cd my-claude-project
claude

3. 첫 번째 요청 보내기

옵션 A가 완료된 후 신뢰하는 프로젝트 디렉터리를 입력하고 Claude Code를 직접 시작하세요.

bash

claude

두 가지 방법 중 하나를 사용하여 다음을 보냅니다.

Text

Reply with one sentence confirming the active model.

정상적인 응답은 설정이 완료되었음을 의미합니다.