Magick API ユーザーガイド

Claude Code のオンボーディングをスキップし、Claude のネイティブリクエストを Magick API の `/v1/messages` エンドポイントに転送する設定

Claude Code は Claude のネイティブプロトコルを使用するため、本プロジェクトの POST /v1/messages インターフェースに依存します。/v1/chat/completions ではありません。

事前準備：オンボーディングログインの無効化

~/.claude.json を開き、hasCompletedOnboarding を検索して true に設定します。

{
  "hasCompletedOnboarding": true
}

方法1（推奨）：環境変数を直接設定する

追加の設定ファイルを作成せずに、ターミナルで直接環境変数を設定したい場合に適しています。

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

上記の3つのコマンドを実行した後、開発対象のプロジェクトディレクトリに移動し、そのまま実行します。

claude

Claude Code は現在のターミナルの環境変数を自動的に読み取るため、別途 API Key を入力する必要はありません。

方法2：設定ファイルを編集する（従来の方法）

従来の設定ファイル方式を引き続き使用したい場合は、以下の記述をそのまま利用できます。

`~/.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 利用ガイド