Magick API 用户指南

配置 Claude Code 跳过引导并把 Claude 原生请求转发到 Magick API 的 `/v1/messages` 入口

Claude Code 走的是 Claude 原生协议面，因此它依赖的是本项目的 POST /v1/messages 接口，而不是 /v1/chat/completions。

前置步骤：关闭引导登录

打开 ~/.claude.json，搜索 hasCompletedOnboarding，将其设置为 true：

{
  "hasCompletedOnboarding": true
}

方案一（推荐）：直接设置环境变量

如果你希望不写额外配置文件，直接在终端里设置环境变量即可。

Mac/Linux

export ANTHROPIC_BASE_URL="https://api.magickapi.com"
export ANTHROPIC_AUTH_TOKEN="后台生成的 API KEY"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows CMD

set ANTHROPIC_BASE_URL=https://api.magickapi.com
set ANTHROPIC_AUTH_TOKEN=后台生成的 API KEY
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

PowerShell

$env:ANTHROPIC_BASE_URL="https://api.magickapi.com"
$env:ANTHROPIC_AUTH_TOKEN="后台生成的 API KEY"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

执行完上面三条命令后，进入需要开发的项目目录，直接运行：

claude

Claude Code 会自动读取当前终端里的环境变量，不需要再单独填写 API Key。

方案二：编辑配置文件（原来的方式）

如果你更习惯沿用原来的配置文件方式，可以继续使用下面这套写法。

设置 `~/.claude/settings.json`

文件路径：~/.claude/settings.json

{
  "env": {
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "DISABLE_INSTALLATION_CHECKS": "1",
    "ENABLE_TOOL_SEARCH": "1"
  },
  "cleanupPeriodDays": 720
}

设置 `~/.claude/settings.xxxx.json`

文件路径：~/.claude/settings.xxxx.json

这里的 xxxx 可以自行命名，用来区分不同环境或不同账号配置：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.magickapi.com",
    "ANTHROPIC_AUTH_TOKEN": "后台生成的 API KEY"
  }
}

使用独立配置启动 Claude Code

claude --settings ~/.claude/settings.xxxx.json

说明

ANTHROPIC_AUTH_TOKEN 请填写 Magick API 后台生成的密钥
如果你已经在当前终端里设置了环境变量，直接运行 claude 即可
Claude Code 会按 Claude 客户端习惯发送 anthropic-version 等头；当前项目的 /v1/messages 兼容这套请求形状
如果你需要 OpenAI 风格的工具链，请改用 Codex 或直接调用 /v1/chat/completions

Claude Code 使用指南

目录