Claude Code の接続先を環境変数 2 つで SoleAPI に
SoleAPI は開発者向けの Claude API ゲートウェイ:Anthropic モデル 11 種類、Anthropic Messages プロトコルをネイティブ直通、公式が 500 やレート制限を返すと自動でバックアップ経路へ。Alipay チャージ、従量課金、月額費用なし。
# ~/.zshrc / ~/.bashrc
export ANTHROPIC_BASE_URL="https://api.soleapi.com"
export ANTHROPIC_API_KEY="sk-sole-..."
export ANTHROPIC_MODEL="claude-fable-5-1"
claude公式に直接つなぐのではなく、ゲートウェイを使う理由
Anthropic の代わりではなく、その上に一層:安定性・決済・請求という、公式が代わりに解決してくれない 3 つのこと。
5xx / レート制限時に自動切替
1 つのモデルに複数の供給経路。Anthropic が 500・過負荷・レート制限を返すと、ゲートウェイは最初のフレームの前にバックアップへ切り替え、Claude Code にはエラーが見えません。
Alipay でチャージ、従量課金
海外カードもサブスクも不要。1 Credit = ¥1、使った分だけ課金。請求はモデル別・キー別にコンソールで確認できます。
ネイティブプロトコル、バッファなし転送
Anthropic Messages をそのまま直通、変換なし。SSE の各フレームを受信次第転送するため、Claude Code のストリーミング体験は直結と同じです。
3 ステップで Claude Code を接続
3 ステップ、Claude Code 本体の変更は不要。
登録して無料枠を受け取る
メール登録で無料 Credits を付与。実プロジェクトの接続テストに十分な量です。
API Key を作成
コンソール → API Key → 新規作成。予算・モデル・チャネルの制限も設定できます。
SoleAPI に向けて Claude Code を起動
Base URL を SoleAPI に、Key を作成したものに差し替えるだけ。ほかはそのまま。
# ~/.zshrc / ~/.bashrc
export ANTHROPIC_BASE_URL="https://api.soleapi.com"
export ANTHROPIC_API_KEY="sk-sole-..."
export ANTHROPIC_MODEL="claude-fable-5-1"
claudeClaude Code で使えるモデルと料金
SoleAPI デフォルトチャネル価格(Credits、1 Credit = ¥1)、打ち消し線は公式価格換算。モデル名をクリックで料金・プロトコル・稼働率の詳細へ。
| モデル | コンテキスト | 入力 / M | 出力 / M | 7 日稼働率 |
|---|---|---|---|---|
| Claude Haiku 4.5claude-haiku-4-5-20251001 | 200K | — | ||
| Claude Sonnet 5claude-sonnet-5 | 1M | 99.2% | ||
| Claude Sonnet 4.5claude-sonnet-4-5-20250929 | 200K | — | ||
| Claude Sonnet 4.6claude-sonnet-4-6 | 1M | — | ||
| Claude Opus 4.5claude-opus-4-5-20251101 | 200K | — | ||
| Claude Opus 4.6claude-opus-4-6 | 1M | — |
モデルカタログと同じデータ、5 分ごとに更新。 Anthropic の全 11 モデル →
Claude Code でよくあるエラーとゲートウェイの対処
これらのエラーは Anthropic 公式 API 側のものです。SoleAPI 経由なら最初のフレームの前にゲートウェイが再試行・切替するため、Claude Code ではほぼ見えません。
API Error: 500 Internal Server Error公式サーバー障害
Anthropic 側で時折起きる 5xx。あなたのリクエストとは無関係です。 SoleAPI:最初のフレーム前の 5xx は即座にバックアップ経路で再送。クライアントは気づきません。
API Error: Rate limit reached公式の RPM / TPM 上限
1 アカウントの分あたりリクエスト数またはトークン数を使い切った状態。 SoleAPI:複数の上流キーで上限を分散。1 本が 429 なら次のキーへ、ウィンドウのリセットを待ちません。
Overloaded error (529)公式の過負荷
ピーク時に Anthropic が意図的に拒否。 SoleAPI:経路の健全性でスケジューリング。過負荷の経路は自動で降格し、健全な経路へ。
Stream idle timeout – partial responseストリーム途中停止
新しいフレームが長く来ず、Claude Code が切断。 SoleAPI:上流のハートビートフレームをそのまま即転送、バッファなし。最初のフレーム以降の中断は Claude Code 自身が再試行します。
よくある質問
Claude Code の中継は安全ですか?コードは見られませんか?
転送前にキーやメールアドレスなどの機密情報を自動でマスク。通信は全経路暗号化。リクエストデータをモデル学習に使うことはありません。キーはモデル・予算を制限でき、漏洩時はワンクリックで失効できます。
Anthropic 公式に直接つなぐのと何が違いますか?
プロトコル(Messages 直通)もモデルも同じ。加わるのは 3 つ:公式障害時の自動切替、Alipay チャージと人民元建て請求、キー単位の使用量・予算管理です。
Codex や Gemini CLI でも使えますか?
使えます。OpenAI Responses と Gemini generateContent プロトコルにも対応、各ツールの Base URL を SoleAPI に向けるだけ。すべてのツールで API Key と残高を共有します。
チャージ方法と最低額は?
コンソール → ウォレット、Alipay 対応。1 Credit = ¥1 の従量課金で月額費用や最低利用額はありません。残高不足時は事前にメールでお知らせします。
環境変数 2 つで、Claude Code を安定稼働
登録で無料枠付与、従量課金、月額費用なし。