Claude Code 快速开始｜ApiPorter

使用 ApiPorter API Key、受支持的 Claude 模型名称和 Anthropic 兼容端点配置 Claude Code。

这篇文档只完成一个目标：让 Claude Code 通过 ApiPorter 成功发送第一条请求。想快速完成可使用方式 A；需要逐项配置则按方式 B 执行当前操作系统对应的命令。

第一步：创建 API Key

在 ApiPorter 创建一个可以访问 claude-opus-4-8 和 claude-sonnet-5 的非 default 分组 API Key。请先保存完整 Key，一键脚本只会要求粘贴一次。

第二步：选择配置方式

方式 A：运行一键脚本

还不熟悉终端？先打开互动排练。这是当前页面内的视觉演练，不会修改你的电脑。

macOS 或 Linux

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

curl -fsSL https://www.apiporter.com/install/claude.sh | sh

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

curl -fsSL https://www.apiporter.com/install/claude.sh | APIPORTER_ALLOW_ROOT=1 sh

Windows PowerShell

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

irm https://www.apiporter.com/install/claude.ps1 | iex

脚本会让你选择语言，在需要时安装官方 Claude Code，只安全输入一次 ApiPorter API Key，备份并合并已有配置，然后验证两个 Claude 模型。脚本不会自动启动 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_APIPORTER_API_KEY 替换成你自己的完整 ApiPorter API Key。

Windows PowerShell

$settings = @'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.apiporter.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIPORTER_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://www.apiporter.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIPORTER_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://www.apiporter.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_APIPORTER_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

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

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

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