Claude Code 連携

このガイドでは、Claude 互換エンドポイントとして ReachAPI を使い、Claude Code を接続する方法を説明します。

このガイドで使用するゲートウェイ URL 例: https://direct.reachapi.ai

1. 一般的な前提条件

始める前に、次の条件を確認してください。

sk-xxxxxx のような ReachAPI キーを持っている
ゲートウェイが POST /v1/messages の Claude Messages API 互換パスを提供している
Windows PowerShell、macOS Terminal、Linux シェルなど、利用可能なターミナル環境がある

インストールと高度な設定に関する公式ドキュメント:

Node.js 要件:

最低バージョン: 18+
推奨バージョン: LTS (20+)

注: 当社は AWS API 経由で Claude 互換機能を提供しているため、CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1" を追加で設定することを推奨します。AWS API の対応は通常少し遅れるため、一部の実験的機能はまだ互換性がない可能性があります。

2. Windows（PowerShell 推奨）

2.1 Node.js と Claude Code をインストールする

Node.js LTS をインストールします。

winget install OpenJS.NodeJS.LTS

インストール確認:

node -v
npm -v

Claude Code は公式推奨の方法でインストールします。

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

Windows CMD 用の代替インストーラ:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

npm install -g でも導入できますが、公式の第一推奨ではありません。

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

インストール後の確認:

claude --version
claude doctor

注: ネイティブ Windows では Git for Windows の利用が推奨されています。詳細は Set up on Windows を参照してください。

2.2 一時設定（現在のセッションのみ）

$env:ANTHROPIC_BASE_URL="https://direct.reachapi.ai"
$env:ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
claude

2.3 永続設定（推奨）

方法 A: %USERPROFILE%\.claude\settings.json に Claude Code のグローバル設定を書く

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://direct.reachapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_REACH_API_KEY",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

方法 B: setx を使う

setx ANTHROPIC_BASE_URL "https://direct.reachapi.ai"
setx ANTHROPIC_API_KEY "YOUR_REACH_API_KEY"
setx CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS "1"

実行後はターミナルを開き直してください。

方法 C: PowerShell プロファイルに追記する

Add-Content -Path $PROFILE -Value '`
$env:ANTHROPIC_BASE_URL="https://direct.reachapi.ai"`
$env:ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"`
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"`
'
. $PROFILE

3. macOS / Linux / WSL

3.1 Node.js と Claude Code をインストールする

nvm を使う場合:

nvm install --lts
nvm use --lts

あるいは Node.js website からインストールしても構いません。

インストール確認:

node -v
npm -v

Claude Code は公式推奨の方法でインストールします。

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

npm install -g でも導入できますが、公式の第一推奨ではありません。

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

インストール後の確認:

claude --version
claude doctor

3.2 一時設定（現在のセッションのみ）

export ANTHROPIC_BASE_URL="https://direct.reachapi.ai"
export ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"
claude

3.3 永続設定（推奨）

方法 A: ~/.claude/settings.json に Claude Code のグローバル設定を書く

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://direct.reachapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_REACH_API_KEY",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

方法 B: シェル設定ファイルに環境変数を書き込む

zsh:

echo 'export ANTHROPIC_BASE_URL="https://direct.reachapi.ai"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"' >> ~/.zshrc
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"' >> ~/.zshrc
source ~/.zshrc

bash:

echo 'export ANTHROPIC_BASE_URL="https://direct.reachapi.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS="1"' >> ~/.bashrc
source ~/.bashrc

4. プロジェクト単位の設定（推奨）

単一リポジトリで使う場合は、.claude/settings.local.json のようなプロジェクト単位の設定が最も扱いやすいことが多いです。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://direct.reachapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_REACH_API_KEY",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

このファイルはリポジトリにコミットしないことを推奨します。

5. 任意: 既定モデルを固定する

macOS / Linux / WSL で一時的に指定する場合:

export ANTHROPIC_MODEL="YOUR_MODEL_ID"

Windows PowerShell で一時的に指定する場合:

$env:ANTHROPIC_MODEL="YOUR_MODEL_ID"

または settings.json / settings.local.json に追加します。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://direct.reachapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_REACH_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_MODEL_ID"
  }
}

6. 接続確認

macOS / Linux / WSL:

ANTHROPIC_BASE_URL="https://direct.reachapi.ai" ANTHROPIC_API_KEY="YOUR_REACH_API_KEY" claude -p "Reply with: connection successful"

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://direct.reachapi.ai"
$env:ANTHROPIC_API_KEY="YOUR_REACH_API_KEY"
claude -p "Reply with: connection successful"

Claude Code からモデル応答が返れば、ゲートウェイ設定は正常です。

7. トラブルシューティング

401 / 403 Authentication Failed

ANTHROPIC_API_KEY が正しいか確認してください
キーが有効で、対象モデルへのアクセス権があるか確認してください

404 / Invalid Path

ANTHROPIC_BASE_URL が https://direct.reachapi.ai になっているか確認してください
ゲートウェイが Claude 互換パス POST /v1/messages を実装しているか確認してください

ストリーミング関連の問題

ゲートウェイが text/event-stream（SSE）に対応しているか確認してください
CDN、WAF、リバースプロキシなどの中間レイヤーがストリームをバッファリングしていないか確認してください

Windows で設定が反映されない

setx を使った場合は、必ずターミナルを開き直してください
設定ファイルとシステム環境変数の両方を使っている場合は、古い値が優先されていないか確認してください
claude doctor を実行して現在の環境を点検してください

Unable to connect to Anthropic services / ERR_BAD_REQUEST

次のようなエラーが表示される場合があります。

Unable to connect to Anthropic services

Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

Please check your internet connection and network settings.

Note: Claude Code might not be available in your country. Check
supported countries at https://anthropic.com/supported-countries

この場合は次の回避策を試してください。

~/.claude.json を開く
JSON に "hasCompletedOnboarding": true, を追加する
保存して Claude Code を再起動する

JSON 全体の構文が壊れないよう、カンマ位置に注意してください。

8. 公式参考資料

Claude Code environment variables: Environment variables
Claude Code settings: Settings

Claude Code 連携

On this page