ai2saveai2save

Claude Code 設定チュートリアル

Claude Code は Anthropic Messages プロトコルを使用します。ai2save に接続する際は、アドレスにサイトのルートアドレス https://ai2save.com を入力してください。/v1 を手動で追加しないでください。キーには ai2save コンソールで作成した sk-... を使用します。

1. API Key の準備

  1. https://ai2save.com/keys を開きます。
  2. 「キーを作成」をクリックし、名前を入力して Claude モデルを含むグループを選択します。
  3. 作成後、すぐに完全なキーをコピーします。完全なキーは一度しか表示されません。

2. Claude Code のインストール

まず Node.js 環境のインストール を完了し、その後以下を実行します:

npm install -g @anthropic-ai/claude-code
claude --version

もしバージョンがゲートウェイの要求よりも低い場合、指示に従ってアップグレードしてください:

npm update -g @anthropic-ai/claude-code

3. 現在の端末で一時的に有効化

macOS / Linux / WSL:

export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-あなたのAPIキー"
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-あなたのAPIキー"
claude

ANTHROPIC_AUTH_TOKEN は中継ステーション用のキー専用変数です。ANTHROPIC_API_KEY を他の公式キーに同時に設定しないでください。Claude Code が誤った資格情報を読み取る可能性があります。

4. Claude Code 設定ファイルへの書き込み(推奨)

~/.claude/settings.json を編集してください(Windows では通常 %USERPROFILE%\.claude\settings.json にあります):

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai2save.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-あなたのAPIキー"
  }
}

保存後、ターミナルを再度開き、claudeを起動してください。特定のプロジェクトでのみ有効にしたい場合は、同じ内容をプロジェクト内の.claude/settings.local.jsonに書き込み、実際のキーをGitにコミットしないでください。

5. モデルを選択して検証

claude --model claude-sonnet-4-6

インタラクティブ画面に入った後:

  1. 短い質問を入力します。例えば「こんにちは、自己紹介してください」。
  2. 正常に内容が返ってくる場合は、アドレス、キー、モデルグループが接続されていることを示します。
  3. モデルを切り替える必要がある場合は /model を使用し、モデル ID はコンソールで公開されている ID と一致している必要があります。

また、最初に Claude Code 内蔵診断を使用して設定状態を確認することもできます:

/status
/doctor

6. 複数設定と旧設定の整理

以前に公式 Claude またはその他の中継サーバーにログインしていた場合:

  • 複数のベンダーを管理するには CC Switch を優先的に使用し、手動で設定を間違えないようにする。
  • 手動で設定する場合、古い ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、または ANTHROPIC_API_KEY が現在の値を上書きしていないことを確認する。
  • WSL と Windows は二つの環境であり、Windows ターミナルで設定した後でも、WSL 内で別途設定が必要。

macOS / Linux 一時的な整理:

unset ANTHROPIC_API_KEY

よくあるエラー

  • 401 / invalid_api_key:Key が完全にコピーされていない、取り消された、またはグループに現在のモデルが含まれていない。
  • 404 / model not found:モデル ID が正しくない、またはその Key のグループでこのモデルが開放されていない。
  • 接続失敗:Base URL を https://ai2save.com/v1 と書くとエラーになる;Claude Code には https://ai2save.com を入力する必要がある。
  • まだ公式アドレスにリクエストされる:~/.claude/settings.json、プロジェクト .claude/settings.local.json、そして端末環境変数に古いアドレスが残っていないか確認する。
  • Windows で開いた後に反映されない:端末、VS Code、または Claude Desktop を完全に終了させてから再度開く。