Claude Code の接続

ドキュメントは 1ZheAI が管理しています。出典と訂正。

エラーを見つけましたか？ページのアドレスと説明を添えてサポートに連絡してください。API キーやアカウント情報は送信しないでください。

Claude Code には 2 つの変数だけが必要です。ANTHROPIC_BASE_URL を当方に向け、ANTHROPIC_AUTH_TOKEN に API キーを設定します。Anthropic アカウントへのログインは不要です。

最短手順

Claude Code をインストール済みで API キーをお持ちの場合、以下の 2 行を ~/.claude/settings.json に書き込み、claude を実行します。

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

ファイルが既に存在する場合は、この 2 項目を既存の env に統合し、他の設定を上書きしないでください。

完全な手順

1. Claude Code をインストールする

   インストール済みの場合はスキップできます。以下のコマンドは Claude Code 公式インストールドキュメント より引用しています。

   macOS / Linux

   macOS / Linux

   curl -fsSL https://claude.ai/install.sh | bash

   Windows PowerShell

   Windows PowerShell

   irm https://claude.ai/install.ps1 | iex

   Homebrew

   Homebrew

   brew install --cask claude-code

   npm（需要 Node.js 22+）

   npm（需要 Node.js 22+）

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

   npm でインストールする場合は sudo を付けないでください。

2. API キーを取得する

   コンソール で新しい API キーを作成します。このマシンの Claude Code 専用にすることを推奨します。詳細は API キーの取得と管理 を参照してください。

3. 設定（3つの選択肢）

   settings.json の場所：macOS / Linux は ~/.claude/settings.json、Windows は %USERPROFILE%\.claude\settings.json。

   settings.json（推荐）

   settings.json（推荐）

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://1zheai.com",
       "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
     }
   }

   macOS / Linux 环境变量

   macOS / Linux 环境变量

   # 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
   export ANTHROPIC_BASE_URL="https://1zheai.com"
   export ANTHROPIC_AUTH_TOKEN="sk-你的Key"

   Windows PowerShell

   Windows PowerShell

   # 持久写入当前用户，重开终端后生效
   [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User")
   [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")
   
   # 只在当前窗口生效
   $env:ANTHROPIC_BASE_URL = "https://1zheai.com"
   $env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"

   Windows CMD

   Windows CMD

   setx ANTHROPIC_BASE_URL "https://1zheai.com"
   setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"

   ANTHROPIC_BASE_URL にはルートアドレスを設定し、/v1 を追加しないでください。Claude Code が自動的に /v1/messages を組み立てます。

4. 起動して確認する

   プロジェクトディレクトリで claude を実行し、起動後に /status と入力します。次の 2 行を確認してください。

   • base URL の行に https://1zheai.com と表示される
   • 認証情報の行に、出所が ANTHROPIC_AUTH_TOKEN と表示される

   その後、質問を 1 つ投げ、呼び出しログ に新しい記録があるか確認してください。あれば接続成功です。

   対話インターフェースに入りたくない場合は、非対話モードで一度試すこともできます（2026-10-15 実測で ok が返りました）。

   bash

   claude -p "say ok" --model claude-sonnet-4-6

ANTHROPIC_AUTH_TOKEN を使う理由

Claude Code には API キーを格納できる変数が 2 つあり、違いは次のとおりです（公式の説明）。

変数	送信方式	動作
ANTHROPIC_AUTH_TOKEN	Authorization: Bearer <值>	設定後すぐに有効になり、確認ダイアログは表示されない
ANTHROPIC_API_KEY	x-api-key: <值>	対話モードでは初回に、この API キーを使用するか確認するダイアログが表示される

どちらも当社はサポートしており、ANTHROPIC_AUTH_TOKEN を推奨します。どちらか一方だけを設定してください。システムに以前の公式の ANTHROPIC_API_KEY が残っている場合は削除し、混在による 401 を避けてください。

また、注意すべきルールが 2 つあります。

• env の settings.json と、ターミナルの export で同じ変数を設定した場合、settings.json が優先されます。ターミナルの変更が反映されない場合は、まず settings.json を確認してください。
• プロジェクトの .claude/settings.json に API キーを書かないでください。このファイルは通常リポジトリにコミットされます。プロジェクトごとに区別したい場合は、コミットされない .claude/settings.local.json を使用してください。

モデルマッピング

Claude Code 内の opus、sonnet、haiku、fable はエイリアスであり、環境変数でそれぞれに対応する具体的なモデルを指定できます。Haiku の階層は Claude Code が一部のバックグラウンドの小タスクを実行するためにも使われます。

変数	役割	例の値
ANTHROPIC_MODEL	起動時に使用するモデル	claude-sonnet-5-5
ANTHROPIC_DEFAULT_OPUS_MODEL	opus エイリアスの指す先	claude-opus-5-5
ANTHROPIC_DEFAULT_SONNET_MODEL	sonnet エイリアスの指す先	claude-sonnet-5-5
ANTHROPIC_DEFAULT_HAIKU_MODEL	haiku エイリアスおよびバックグラウンドタスクで使うモデル	claude-haiku-5-5
ANTHROPIC_DEFAULT_FABLE_MODEL	fable エイリアスの指す先	claude-fable-5-1

~/.claude/settings.json（带模型映射）

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://1zheai.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
  }
}

モデル ID はサポートされているモデル のいずれかである必要があります。実行中でも /model claude-opus-5-5 で一時的に切り替えられます。

VS Code 拡張

Claude Code の VS Code 拡張は起動前に認証情報をチェックします。公式では、変数を VS Code 自身のユーザー設定（コマンドパレット → Preferences: Open User Settings (JSON)）に書くことを推奨しています。

VS Code settings.json

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
  ]
}

~/.claude/settings.json にのみ書いた場合、拡張自体のログインチェックが読み取れない可能性があります。

オプション設定

変数	役割
API_TIMEOUT_MS	リクエストのタイムアウト。デフォルトは 600000（10 分）。長時間のタスクでタイムアウトしやすい場合は値を大きくしてください
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1	自動更新、テレメトリ、エラー報告などの不要な通信を無効化します。0 や false を設定しても有効とみなされるため、無効化するにはこの変数を削除してください
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1	“Extra inputs are not permitted” のような 400 エラーが発生した際に使用します
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1	/model の一覧を /v1/models から取得して利用可能なモデルを表示します

CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 は動作確認済みです（Claude Code 2.1.296、2026-10-15）：起動後に debug ログに [gatewayDiscovery] cached 14 models が表示され、14 個のモデルがサポートされているモデル と一致しました。

DISABLE_PROMPT_CACHING は設定しないでください。キャッシュが無効になり、請求額が明確に増加します。詳細は Prompt Caching を参照してください。

よくある問題

起動するとすぐにログイン画面が表示される / Please run /login と表示される

Claude Code が API キーを読み取っていません。変数名のスペルを確認してください。環境変数を使う場合は新しく開いたターミナルで起動したか確認し、settings.json を使う場合は JSON 形式が正しいか確認してください（カンマが 1 つ多いだけで全体が無効になります）。

401 / Invalid API key

API キーのコピーが不完全か、ANTHROPIC_API_KEY と ANTHROPIC_AUTH_TOKEN が同時に存在し、どちらかが古い値です。どちらか一方だけ残してください。詳細はエラーコードとトラブルシューティング を参照してください。

404

ANTHROPIC_BASE_URL に /v1 が余分に付いています。https://1zheai.com に修正してください。

Opus を選択したのに、ログに Haiku の呼び出しがある

これは Claude Code が Haiku 階層でバックグラウンドの小タスクを実行しているものです。別のモデルに変更したい場合は ANTHROPIC_DEFAULT_HAIKU_MODEL を設定してください。

公式アカウントと 1折AI の切り替えは？

上記の 2 つの変数を削除（またはコメントアウト）すれば公式ログインに戻ります。頻繁に切り替える場合は CC Switch を使い、クリック 1 つで切り替えられます。

1折AI を使うと Anthropic アカウントに影響はありますか？

関連付けは発生しません。1折AI に接続する際、Claude Code は当方の API キーを使用し、お客様の Anthropic アカウントにはログインしません。