Claude Code 快速开始

这篇文档只解决一件事：让 Claude Code 通过 Modelflare 成功发送第一条请求。想最快完成就用方式 A；想自己逐项创建配置，就按方式 B 的每一步分别执行当前操作系统的命令。

第一步：创建 API Key

在 Modelflare 创建一个可以访问 claude-opus-4-8 和 claude-sonnet-5 的非 default 分组 API Key。先保留好完整 Key，一键脚本只会让你粘贴一次。

第二步：选择配置方式

方式 A：运行一键脚本

macOS 或 Linux

普通电脑请使用当前用户直接执行，不要加 sudo：

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

如果你本来就是用 root 登录 VPS、云服务器或容器，请使用：

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

Windows PowerShell

用普通 Windows 用户打开 PowerShell，执行：

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

脚本会先让你选择中文、日语或英文，在需要时安装官方 Claude Code，只让你粘贴一次 Modelflare API Key，备份并合并已有用户配置，然后验证两个模型。脚本不会自动启动 Claude Code。

方式 B：手动完成 Claude Code 配置

按下面的顺序操作，每一步只执行自己操作系统对应的命令。

第 1 步：安装 Claude Code

Windows PowerShell

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

Linux

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

macOS

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

如果安装失败，请改用下面的命令：

npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

第 2 步：创建并进入用户配置目录

Windows PowerShell

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

Linux

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

macOS

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

第 3 步：创建 settings.json

执行自己系统的命令前，必须把 YOUR_MODELFLARE_API_KEY 替换成你自己的完整 Modelflare API Key。

Windows 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
)

Linux

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

macOS

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

Windows PowerShell

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

Linux

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

macOS

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

第三步：发送第一条请求

方式 A 完成后，请先进入你信任的项目目录，再自行启动 Claude Code：

claude

无论使用哪种方式，进入后发送：

请用一句话确认当前使用的模型。

能够正常回复，就说明配置完成。