Skip to main content
Claude Code は Anthropic のネイティブ Messages 設定を使います。NexusAPI の Base URL は https://nexusapi.link で、/v1 は追加しません。

システム要件

  • macOS 13+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+、または Windows 10 1809+。
  • 4 GB 以上のメモリと x64 または ARM64 CPU。
  • NexusAPI に接続できるネットワーク。
  • Windows で Git Bash を使う場合、Git for Windowsは任意です。

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

公式インストーラーを使ってください。
Windows では winget install Anthropic.ClaudeCode、macOS では brew install --cask claude-code も使えます。確認コマンド:

Windows WinGet

macOS Homebrew

2. NexusAPI Key を作成する

コンソールの トークン管理 → トークンを追加 で、Claude Code で必要なモデルを含むグループを選び、上限を設定します。マーケットプレイスまたは対応マトリクスで、モデルとプロトコルを確認してください。

安全な Key 設定を選ぶ

プロジェクトごとに分かる名前と適切な上限を使います。モデル制限や IP 許可リストは影響を理解した場合だけ有効にし、短期テスト Key には有効期限を設定します。

3. ユーザー設定を作成する

設定ディレクトリを確認する

macOS、Linux、WSL、Git Bash では以下を実行します。
Windows PowerShell では、先にフォルダを作成して設定ファイルを開きます。

環境変数を設定する

既存設定を上書きせず、次の env を統合します。
ユーザーディレクトリに保存し、プロジェクトリポジトリには置かないでください。
実験的なフィールドを無効にするのは、互換性エラーが出た場合だけですエラーに context_management または未対応の実験的入力が明記された場合だけ、env に CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 を追加して再試行してください。一部のプレビュー機能を無効にする設定のため、この種の互換性エラーに限って使用してください。

4. 起動と確認

新しいターミナルでプロジェクトへ移動し、次を実行します。
/status で Anthropic base URL が https://nexusapi.link、認証元が ANTHROPIC_AUTH_TOKEN であることを確認してから、短い質問を送ります。

よくある問題

Invalid API Key · Please run /login

二つの環境値、Key の有効状態、ターミナルの再起動を確認します。Claude の内部ログイン状態ファイルを直接変更しないでください。

Anthropic サービスに接続できない

claude doctor を実行し、settings.json の JSON 構文と二つの環境変数を確認してから、ターミナルを開き直します。続く場合は、エラー本文、claude --version、claude doctor の出力を保存してください。
.claude.json の内部状態フィールドをスクリプトで上書きしないでください。バージョンで変わる可能性があり、既存の設定が失われるおそれがあります。

PowerShell がインストーラーをブロックする

まず WinGet または Windows CMD から公式インストーラーを使用してください。ローカルの実行ポリシーだけが原因であることを確認した場合は、現在のユーザーに限って変更します。
ローカルのポリシーが原因だと確認できた場合は、現在のユーザー範囲だけを変更してください。

fetch failed

  1. まず通常の短い質問を送ります。成功する場合は、WebFetch など別のネットワーク機能の問題の可能性があります。
  2. すべてのモデル呼び出しが失敗する場合は、claude doctor と /status で Base URL を確認します。
  3. DNS、ファイアウォール、社内ネットワーク、信頼済みプロキシが nexusapi.link を遮断していないか確認します。
  4. 新しいターミナルで一度だけ試します。継続する場合は、バージョン、doctor 出力、エラー全文、Request ID を保存し、自己確認へ進みます。

offline と表示される

補助機能が別サービスを確認している場合があります。/status と短いモデルリクエストで実際のゲートウェイ呼び出しを確認してください。offline だけで NexusAPI の障害とは限りません。

通常のチャットは動くが WebFetch が失敗する

WebFetch は別のドメイン安全性チェックや外部ネットワーク接続を使うことがあります。短いテキスト会話が成功するなら NexusAPI Base URL を変更する必要はありません。Claude Code のネットワーク規則に従って WebFetch のエラーを調べてください。

API リクエストが失敗する

現在のセッションを終了し、新しい claude セッションで短いリクエストを一度だけ試します。続く場合は Request ID を保存して、自己確認を確認してください。

公式リファレンス