AIin1Portal

IDE での AIone の利用

概要

AIone は 2 種類の接続方式に対応しています：

  • OpenAI 互換フォーマット：Cursor、Cline、Continue、およびカスタム OpenAI Base URL に対応するほとんどの IDE / プラグインに適用
  • Anthropic ネイティブフォーマット：Claude Code、Anthropic SDK、および Messages API を直接呼び出すツールに適用

本ドキュメントでは、主要な IDE やプログラミングツールでの AIone の設定方法を紹介します。

Cursor の設定

Cursor は最も人気のある AI コードエディタの一つです。

設定手順

  1. Cursor を開く → Settings → Models
  2. OpenAI API Key の設定項目を見つける
  3. 以下の情報を入力：
    • API Key: sk-nex-your-key-here
    • Base URL: https://api.portal.aiin1.ai/v1
  4. すべてのモデルは短縮名を使用してください（下記の表を参照）— gpt-、claude-、gemini- で始まるモデル名は使用しないでください
  5. モデルリスト下部の Add Models から短縮名を手動追加してください

Cursor モデル短縮名一覧

Cursor は gpt-、claude-、gemini- で始まるモデル名を自動的にインターセプトし、Cursor 独自のチャネル経由でルーティングするため、設定した API アドレスがバイパスされます。Cursor では以下の短縮名を使用してください：

GPT シリーズ

短縮名 実際のモデル
o5.4 GPT-5.4
o5 GPT-5
o5.1 GPT-5.1
o5.2 GPT-5.2
o4.1 GPT-4.1
o4o GPT-4o

Claude シリーズ

短縮名 実際のモデル
opus-4-6 Claude Opus 4.6
sonnet-4-6 Claude Sonnet 4.6
haiku-4-5 Claude Haiku 4.5

Gemini シリーズ

短縮名 実際のモデル
flash-2.5 Gemini 2.5 Flash
pro-2.5 Gemini 2.5 Pro
flash-3 Gemini 3 Flash
pro-3 Gemini 3 Pro
pro-3.1 Gemini 3.1 Pro

注意事項

  • Cursor では Override OpenAI Base URL で設定が必要な場合があります
  • Cursor の「Anthropic API Key」と「Google API Key」スイッチは必ずオフにしてください。 これらのスイッチがオンの場合、Cursor は対応するモデルのリクエストを公式 API に直接送信し、AIone をバイパスするため、Key 認証エラー（401）が発生します。すべてのモデルは上部の OpenAI API Key 設定項目から接続してください
  • Cursor 内蔵のモデル項目は使用しないでください — 上記の表の短縮名を Add Models から手動追加してください
  • GPT モデルは Cursor Agent モードでの深い推論（Thinking）機能に対応していません。Agent + Thinking が必要な場合は opus-4-6 または sonnet-4-6 をご利用ください
  • モデルリストに該当する項目がない場合は、短縮名を直接手動入力してください

Cline（VS Code プラグイン）の設定

Cline は VS Code の強力な AI プログラミングアシスタントです。

インストール

  1. VS Code を開く → 拡張機能ストア（Ctrl+Shift+X / Cmd+Shift+X）
  2. Cline を検索してインストール
  3. インストール完了後、左サイドバーに Cline のアイコンが表示されます

設定

  1. Cline アイコンをクリック → 設定（歯車アイコン）
  2. API Provider で OpenAI Compatible を選択
  3. 以下を入力：
    • Base URL: https://api.portal.aiin1.ai/v1
    • API Key: sk-nex-your-key-here
    • Model ID: claude-sonnet-4-6（または他の通常のモデル ID）

Claude Code の設定

Claude Code は Anthropic 公式の CLI ツールです。

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.portal.aiin1.ai"
export ANTHROPIC_AUTH_TOKEN="sk-nex-your-key-here"

長期的に有効にしたい場合は、これらの変数をシェルの設定ファイルに記述することもできます。

変数名は ANTHROPIC_AUTH_TOKEN です。ANTHROPIC_API_KEY ではありません。 ANTHROPIC_API_KEY は Anthropic Python/TypeScript SDK で使用される変数名です。Claude Code CLI は ANTHROPIC_AUTH_TOKEN を使用します。変数名を間違えると、401 Invalid API key エラーが発生します。

Windows（永続設定を推奨）

Windows の「ユーザー環境変数」で設定することを推奨します。一度設定すれば長期的に有効です。

  1. スタートメニューを開き、環境変数 を検索
  2. ユーザー環境変数の編集 を選択
  3. 「ユーザー変数」で 新規 をクリック
  4. 以下の 2 つの変数を新規作成：
    • ANTHROPIC_BASE_URL = https://api.portal.aiin1.ai
    • ANTHROPIC_AUTH_TOKEN = sk-nex-your-key-here
  5. 保存後、既に開いている CMD、PowerShell、VS Code ターミナルを閉じて、再度開いてください

新しいコマンドラインウィンドウで有効になっているか確認できます：

echo %ANTHROPIC_BASE_URL%

PowerShell を使用している場合：

$env:ANTHROPIC_BASE_URL

https://api.portal.aiin1.ai と表示されれば設定成功です。

実験的 Beta 機能の無効化（重要）

Claude Code はデフォルトで実験的な anthropic-beta ヘッダーを送信します。これらの Beta 機能の一部は AWS Bedrock 上流と互換性がなく、ValidationException エラーを引き起こす可能性があります（Claude 公式の既知のバグです。詳細は Claude Code LLM Gateway ドキュメント を参照）。

すべてのユーザーに以下の環境変数を追加することを推奨します：

macOS / Linux：

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

Windows：上記と同じ方法でユーザー環境変数を追加してください：

  • CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = 1

設定後、ターミナルを閉じて再度開いてください。

Claude Code の起動

claude

Claude Code が初めてカスタム API キーを検出した場合、プロンプトに従い、現在の環境変数のキーを使用することを選択してください。

~/.claude/config.json で設定することもできますが、環境変数の方がより直接的で、特に Windows ユーザーに適しています。

注意

Claude Code は Anthropic Messages API フォーマット（OpenAI フォーマットではなく）を使用するため、Base URL は https://api.portal.aiin1.ai を使用し、/v1 を手動で追加しないでください。

Claude Code / Anthropic SDK はプロトコルに従い /v1/messages にリクエストを送信するため、ルートアドレスのみを入力してください。

  • 変数名は必ず ANTHROPIC_AUTH_TOKEN にしてください — ANTHROPIC_API_KEY を使用すると 401 エラーが発生します
  • 環境変数を変更したにもかかわらず Claude Code が古い値を読み取る場合は、通常ターミナルウィンドウを再起動していないことが原因です
  • 公式 API に戻したい場合は、これらの 2 つの環境変数を削除してターミナルを再起動し、claude login を実行してください

Continue（VS Code プラグイン）の設定

  1. Continue プラグインをインストール
  2. 設定ファイル ~/.continue/config.json を開く
  3. AIone を provider として追加：
{
  "models": [
    {
      "title": "AIone Claude Sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "apiBase": "https://api.portal.aiin1.ai/v1",
      "apiKey": "sk-nex-your-key-here"
    }
  ]
}

汎用設定の原則

まず、クライアントが使用するプロトコルを確認してください。

シーン Base URL Provider / Type
OpenAI 互換クライアント https://api.portal.aiin1.ai/v1 OpenAI / OpenAI Compatible
Anthropic ネイティブクライアント https://api.portal.aiin1.ai Anthropic

すべてのシーンで AIone API キー（sk-nex- で始まるもの）を使用します。

モデル名の判断方法

「このクライアントではどのモデル名を入力すべきか」を素早く知りたい場合は、以下の 3 つのルールを覚えてください：

  • リアルタイムの公式リストは GET https://api.portal.aiin1.ai/v1/models およびモデル一覧を基準にしてください
  • Cursor での Claude のみ短いモデル名を優先的に使用します
  • その他のクライアントではすべて標準モデル ID を優先してください

完全なルール、完全なモデル表、および Cursor Claude の短いモデル名の対照表については、以下を参照してください：

よくある質問

Claude Code で 401 Invalid API key が表示される

最も一般的な原因は環境変数名の間違いです：

ツール 正しい変数名
Claude Code CLI ANTHROPIC_AUTH_TOKEN
Anthropic Python/TS SDK ANTHROPIC_API_KEY

ANTHROPIC_API_KEY を使用した場合、Claude Code はそれを読み取りません。ANTHROPIC_AUTH_TOKEN に変更してください。

接続失敗 / タイムアウト

  • OpenAI 互換クライアントの場合、Base URL が https://api.portal.aiin1.ai/v1 であるか確認してください
  • Claude Code / Anthropic SDK の場合、Base URL が https://api.portal.aiin1.ai であるか確認してください
  • API キーが有効であることを確認してください
  • ネットワークが api.portal.aiin1.ai にアクセスできるか確認してください

モデルが存在しない

  • モデル ID のスペルが正しいか確認してください
  • モデル一覧でモデル名を確認してください
  • Cursor での Claude の場合は、opus-4-6、sonnet-4-6、haiku-4-5 のような短いモデル名を優先してください
  • その他のクライアントおよび GPT / Gemini では、claude-sonnet-4-6、gpt-5.4、gpt-5.2、gemini-3.1-pro のような通常のモデル ID を使用してください
  • より完全なモデル名の対照表：モデル命名規則

レスポンスフォーマットの異常

  • Provider タイプが OpenAI Compatible に設定されているか確認してください（Anthropic ネイティブフォーマットではなく）
  • Claude Code は例外で、Anthropic フォーマットを使用しますが、AIone はこれにも対応しています