Claude Code 設定チュートリアル
Claude Code は Anthropic Messages プロトコルを使用します。ai2save に接続する際は、アドレスにサイトのルートアドレス https://ai2save.com を入力してください。/v1 を手動で追加しないでください。キーには ai2save コンソールで作成した sk-... を使用します。
1. API Key の準備
- https://ai2save.com/keys を開きます。
- 「キーを作成」をクリックし、名前を入力して Claude モデルを含むグループを選択します。
- 作成後、すぐに完全なキーをコピーします。完全なキーは一度しか表示されません。
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
インタラクティブ画面に入った後:
- 短い質問を入力します。例えば「こんにちは、自己紹介してください」。
- 正常に内容が返ってくる場合は、アドレス、キー、モデルグループが接続されていることを示します。
- モデルを切り替える必要がある場合は
/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 を完全に終了させてから再度開く。