Claude Code 配置教程

前置条件

• 已创建 Drivecode API 账户并兑换余额
• 已创建 API Key（API 密钥页面）
• Windows 10/11，并能正常访问 Claude Code 官方安装源

安装 Claude Code

WinGet（推荐）

winget.exe install --id Anthropic.ClaudeCode --exact --source winget

官方 PowerShell 安装器

Invoke-RestMethod -Uri 'https://claude.ai/install.ps1' | Invoke-Expression

npm 安装方式已弃用

Anthropic 官方仓库已将 npm 全局安装方式标记为 Deprecated。已有 npm 安装可以继续运行，但新安装应优先使用 WinGet 或官方安装器。

安装完成后验证：

claude --version

---

配置环境变量

Claude Code 通过环境变量接入 Drivecode API。以下是可用的变量：

环境变量	说明	值
ANTHROPIC_BASE_URL	API 基础地址	https://fast.drivecode.top
ANTHROPIC_API_KEY	使用 x-api-key 认证	sk-xxxxxxxxxxxxxxxx
ANTHROPIC_AUTH_TOKEN	使用 Authorization: Bearer 认证	sk-xxxxxxxxxxxxxxxx
ANTHROPIC_MODEL	指定默认模型，必须来自 /v1/models	见下文

Base URL 不加 /v1

ANTHROPIC_BASE_URL 设为 https://fast.drivecode.top，不要在末尾添加 /v1。 Anthropic SDK 会自动在内部追加正确的路径。

ANTHROPIC_API_KEY vs ANTHROPIC_AUTH_TOKEN

• ANTHROPIC_API_KEY 对应请求头 x-api-key。
• ANTHROPIC_AUTH_TOKEN 对应请求头 Authorization: Bearer。
• 本文默认使用 ANTHROPIC_API_KEY。只有中转站明确要求 Bearer 认证时，才改用 ANTHROPIC_AUTH_TOKEN；不要同时设置两者。

指定模型

Claude Code 默认请求最新的 Claude 模型，中转站不一定支持。通过 ANTHROPIC_MODEL 指定：

$env:ANTHROPIC_MODEL = "<从 /v1/models 获取的模型 ID>"

可用模型列表请先查询：

curl.exe https://fast.drivecode.top/v1/models `
  -H "x-api-key: sk-xxxxxxxxxxxxxxxx"

网关模型映射（可选）

Claude Code 内置了若干默认模型名称，如果中转站不支持这些名称，可以通过以下环境变量映射到实际可用的模型：

环境变量	说明
ANTHROPIC_DEFAULT_SONNET_MODEL	将 Claude Code 默认的 Sonnet 请求映射为指定模型
ANTHROPIC_DEFAULT_OPUS_MODEL	将默认的 Opus 请求映射为指定模型
ANTHROPIC_DEFAULT_HAIKU_MODEL	将默认的 Haiku 请求映射为指定模型
ANTHROPIC_DEFAULT_FABLE_MODEL	将默认的 Fable 请求映射为指定模型

示例：

$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "<SONNET_MODEL_ID>"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL   = "<OPUS_MODEL_ID>"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL  = "<HAIKU_MODEL_ID>"
$env:ANTHROPIC_DEFAULT_FABLE_MODEL  = "<FABLE_MODEL_ID>"

网关模型发现（可选）

最新版 Claude Code 可以在启动时查询中转站模型列表，并将结果加入 /model 选择器：

$env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1"

启用后可运行 claude --debug，检查日志中的 [gatewayDiscovery] 记录。该能力需要中转站实现 Claude Code 要求的模型发现接口；若返回 404、重定向或超时，请关闭此变量并手动设置模型。

临时配置（当前终端会话有效）

Windows PowerShell

$env:ANTHROPIC_API_KEY  = "sk-xxxxxxxxxxxxxxxx"
$env:ANTHROPIC_BASE_URL = "https://fast.drivecode.top"
$env:ANTHROPIC_MODEL    = "<从 /v1/models 获取的模型 ID>"
claude

macOS / Linux

export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://fast.drivecode.top"
export ANTHROPIC_MODEL="<从 /v1/models 获取的模型 ID>"
claude

永久配置（推荐）

永久环境变量包含敏感信息

用户级环境变量会把 API Key 持久保存在当前 Windows 账户中。不要在共享电脑上使用此方式，也不要把环境变量截图或导出文件发给他人。

Windows — 用户级永久环境变量

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY",  "sk-xxxxxxxxxxxxxxxx", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://fast.drivecode.top",  "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL",    "<从 /v1/models 获取的模型 ID>", "User")
Write-Host "环境变量已设置，请重新打开 PowerShell 后运行 claude"

macOS / Linux — 写入 Shell 配置

echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://fast.drivecode.top"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="<从 /v1/models 获取的模型 ID>"' >> ~/.zshrc
source ~/.zshrc

---

启动并验证

1. 重新打开 PowerShell，运行：

claude

2. 发送一条简单消息，例如 你好

3. 在 使用记录页面 确认请求已被记录

---

常见问题

401 — API Key 无效

Error: 401 Unauthorized

检查：

• $env:ANTHROPIC_API_KEY（或 ANTHROPIC_AUTH_TOKEN）是否已设置且没有多余空格
• 进入 API 密钥页面 确认密钥未被禁用

404 — 路径错误

Error: 404 Not Found

检查 ANTHROPIC_BASE_URL 是否填写正确，不要加 /v1。

Claude Code 启动正常但不回复

用 curl 直接测试接口连通性：

$body = @{
    model = "<从 /v1/models 获取的模型 ID>"
    max_tokens = 64
    messages = @(
        @{ role = "user"; content = "hi" }
    )
} | ConvertTo-Json -Depth 10 -Compress

curl.exe https://fast.drivecode.top/v1/messages `
  -H "x-api-key: $env:ANTHROPIC_API_KEY" `
  -H "anthropic-version: 2023-06-01" `
  -H "Content-Type: application/json" `
  -d $body

这里的 max_tokens = 64 仅用于连通性冒烟测试；正式调用应按输出需求提高。anthropic-version: 2023-06-01 是当前稳定 API schema 版本，不按当前年份修改。

如果 curl 返回正常响应，问题在 Claude Code 本地配置。 如果 curl 也失败，检查网络和 API Key。

余额不足

在控制台查看余额，前往购买余额兑换新的余额。

模型不可用

运行以下命令获取当前可用模型列表：

curl.exe https://fast.drivecode.top/v1/models `
  -H "x-api-key: $env:ANTHROPIC_API_KEY"

将返回的 id 赋值给 ANTHROPIC_MODEL。