3ステップでOpenCodeをAPI中継サーバーに接続、400以上のAIモデルの自由な切り替えをアンロック

オープンソースのAIプログラミングアシスタント「OpenCode」を使いたいけれど、公式APIの価格の高さやネットワークの不安定さに悩んでいませんか？そんな時、APIプロキシ（中継）サービスが最適な解決策となります。この記事では、OpenCodeをAPIYIやOpenRouterなどの中継サービスに接続する3つのステップを分かりやすく解説します。これにより、Claude、GPT-4、Geminiなど75種類以上の主要な大規模言語モデルを、より低コストで利用できるようになります。

本記事のメリット: 読み終える頃には、OpenCodeを任意のOpenAI互換APIで動作させるための設定方法をマスターし、自由なモデルの切り替えとコストの最適化を実現できるようになります。

OpenCodeとは？なぜAPIプロキシを利用するのか

OpenCodeは、Claude Codeのオープンソース代替として注目されているターミナルベースのAIプログラミングアシスタントです。Go言語で開発されており、洗練されたTUI（テキストユーザインターフェース）、マルチセッション管理、LSP（Language Server Protocol）連携など、プロフェッショナルな機能を備えています。

OpenCodeの主な特徴

なぜAPIプロキシ（中継）サービスを使うのか？

公式APIを直接利用する場合、以下のような課題に直面することがあります。

🚀 クイックスタート: プロキシサービスとして「APIYI（apiyi.com）」の利用をおすすめします。OpenAI互換のインターフェースをすぐに利用でき、登録するだけで無料テスト枠がもらえます。わずか5分でOpenCodeの設定が完了します。

OpenCode を API 中継サーバーに接続するための核心的なポイント

設定を始める前に、OpenCode の API 接続の仕組みを理解しておきましょう。

設定アーキテクチャの説明

OpenCode は統一された設定管理体系を採用しており、多層的な設定の上書きをサポートしています。

API 中継サーバーの接続原理

OpenCode は @ai-sdk/openai-compatible アダプターを介して、あらゆる OpenAI 互換 API をサポートしています。重要な設定項目は以下の通りです。

• baseURL: API 中継サーバーのインターフェースアドレス
• apiKey: 中継サーバーが提供する API キー
• models: 利用可能なモデルリスト

つまり、中継サーバーが標準的な /v1/chat/completions インターフェースを提供していれば、OpenCode に直接接続できることを意味します。

OpenCode クイックスタート設定

ステップ 1: OpenCode のインストール

OpenCode は複数のインストール方法を提供しています。最適なものを選択してください。

ワンクリックインストールスクリプト (推奨):

curl -fsSL https://opencode.ai/install | bash

Homebrew インストール (macOS/Linux):

brew install opencode-ai/tap/opencode

npm インストール:

npm i -g opencode-ai@latest

Go インストール:

go install github.com/opencode-ai/opencode@latest

インストールが成功したか確認します。

opencode --version

ステップ 2: API 中継サーバーキーの設定

OpenCode は 2 つの認証方式をサポートしています。

方法 1: /connect コマンドを使用する (推奨)

OpenCode を起動した後、/connect コマンドを入力します。

opencode
# TUI インターフェースで入力
/connect

Other を選択してカスタムプロバイダーを追加し、API キーを入力します。キーは ~/.local/share/opencode/auth.json に安全に保存されます。

方法 2: 環境変数の設定

~/.zshrc または ~/.bashrc に以下を追加します。

# APIYI 中継サーバーの設定
export OPENAI_API_KEY="sk-your-apiyi-key"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

設定を反映させます。

source ~/.zshrc

ステップ 3: opencode.json 設定ファイルの作成

これは最も重要なステップです。API 中継サーバーを指定するための設定ファイルを作成します。

グローバル設定 (すべてのプロジェクトに適用):

mkdir -p ~/.config/opencode
touch ~/.config/opencode/opencode.json

プロジェクト設定 (現在のプロジェクトのみ有効):

touch opencode.json  # プロジェクトルートディレクトリにて

最小限の設定例

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4"
        },
        "gpt-4o": {
          "name": "GPT-4o"
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

設定の説明: {env:OPENAI_API_KEY} 構文は環境変数を自動的に読み取るため、設定ファイルにキーをハードコードするのを防ぎます。APIYI (apiyi.com) から取得した API キーは OpenAI 形式と互換性があり、そのまま使用できます。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI (推荐)",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:APIYI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4",
          "limit": {
            "context": 200000,
            "output": 65536
          }
        },
        "claude-opus-4-20250514": {
          "name": "Claude Opus 4",
          "limit": {
            "context": 200000,
            "output": 32000
          }
        },
        "gpt-4o": {
          "name": "GPT-4o",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        },
        "gpt-4o-mini": {
          "name": "GPT-4o Mini",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro",
          "limit": {
            "context": 1000000,
            "output": 65536
          }
        },
        "deepseek-chat": {
          "name": "DeepSeek V3",
          "limit": {
            "context": 64000,
            "output": 8192
          }
        }
      }
    },
    "openrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenRouter",
      "options": {
        "baseURL": "https://openrouter.ai/api/v1",
        "apiKey": "{env:OPENROUTER_API_KEY}",
        "headers": {
          "HTTP-Referer": "https://your-site.com",
          "X-Title": "OpenCode Client"
        }
      },
      "models": {
        "anthropic/claude-sonnet-4": {
          "name": "Claude Sonnet 4 (OpenRouter)"
        },
        "openai/gpt-4o": {
          "name": "GPT-4o (OpenRouter)"
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514",
  "small_model": "apiyi/gpt-4o-mini",
  "agent": {
    "coder": {
      "model": "apiyi/claude-sonnet-4-20250514",
      "maxTokens": 8000
    },
    "planner": {
      "model": "apiyi/gpt-4o",
      "maxTokens": 4000
    }
  },
  "tools": {
    "write": true,
    "bash": true,
    "glob": true,
    "grep": true
  }
}

OpenCode がサポートする API プロキシの比較

主要 API プロキシの設定パラメータ

APIYI 設定の詳細

APIYI は、国内の開発者向けに最適化された AI API プロキシプラットフォームで、以下の機能を提供します：

• 統一された OpenAI 互換インターフェース
• Claude、GPT、Gemini、DeepSeek などの主要モデルをサポート
• 従量課金制（月額料金なし）
• 無料テストクレジット
• 中国語カスタマーサポート

{
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1"
      },
      "models": {
        "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "claude-opus-4-20250514": { "name": "Claude Opus 4" },
        "gpt-4o": { "name": "GPT-4o" },
        "gpt-4o-mini": { "name": "GPT-4o Mini" },
        "gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "deepseek-chat": { "name": "DeepSeek V3" }
      }
    }
  }
}

OpenRouter 設定の詳細

OpenRouter は 400 以上の AI モデルを集約しており、頻繁にモデルを切り替える必要があるシーンに適しています：

{
  "provider": {
    "openrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenRouter",
      "options": {
        "baseURL": "https://openrouter.ai/api/v1",
        "apiKey": "{env:OPENROUTER_API_KEY}",
        "headers": {
          "HTTP-Referer": "https://your-app.com",
          "X-Title": "My OpenCode App"
        }
      },
      "models": {
        "anthropic/claude-sonnet-4": {
          "name": "Claude Sonnet 4"
        },
        "google/gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro"
        },
        "meta-llama/llama-3.1-405b": {
          "name": "Llama 3.1 405B"
        }
      }
    }
  }
}

💡 選択のアドバイス: 主に Claude や GPT シリーズのモデルを使用する場合は、低価格でレスポンスが速い APIYI (apiyi.com) をおすすめします。オープンソースモデルやマイナーなモデルが必要な場合は、OpenRouter の方がカバー範囲が広いです。

OpenCode 応用設定テクニック

エージェント（Agent）モデル割り当て戦略

OpenCode には Coder と Planner の 2 つのエージェントが内蔵されており、それぞれに異なる大規模言語モデルを割り当てることができます。

{
  "agent": {
    "coder": {
      "model": "apiyi/claude-sonnet-4-20250514",
      "maxTokens": 8000,
      "description": "主要なコーディングタスク用。高性能モデルを使用"
    },
    "planner": {
      "model": "apiyi/gpt-4o-mini",
      "maxTokens": 4000,
      "description": "計画・分析用。軽量モデルを使用してコストを削減"
    }
  }
}

マルチプロバイダー（Provider）の切り替え

複数のプロバイダーを設定した後は、OpenCode 内で /models コマンドを使用して、いつでも切り替えることができます。

# OpenCode を起動
opencode

# TUI 内でモデルを切り替え
/models
# apiyi/claude-sonnet-4-20250514 または他のモデルを選択

環境変数のベストプラクティス

API キーは .env ファイルで管理することをお勧めします。

# .env ファイル
APIYI_API_KEY=sk-your-apiyi-key
OPENROUTER_API_KEY=sk-or-your-openrouter-key

その後、opencode.json で以下のように参照します。

{
  "provider": {
    "apiyi": {
      "options": {
        "apiKey": "{env:APIYI_API_KEY}"
      }
    }
  }
}

トークン制限の設定

モデルのコンテキストと出力の制限を指定することで、制限超過エラーを回避します。

{
  "models": {
    "claude-sonnet-4-20250514": {
      "name": "Claude Sonnet 4",
      "limit": {
        "context": 200000,
        "output": 65536
      }
    }
  }
}

OpenCode よくある質問とトラブルシューティング

設定プロセスで発生する可能性のある問題とその解決策をまとめました。

"baseURL": "https://api.apiyi.com/v1"

"baseURL": "https://api.apiyi.com/v1/chat/completions"

{
  "provider": {
    "apiyi": {
      "models": {
        "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

# 設定済みの認証情報を表示
opencode auth list

# 利用可能なモデルを確認
opencode
/models

# 簡単な対話をテスト
opencode -p "こんにちは、日本語で返信してください"

opencode
/models
# 異なるプロバイダー配下のモデルを選択するだけで切り替え可能

{
  "model": "apiyi/claude-sonnet-4-20250514"
}

OpenCode vs Claude Code：API連携方式の比較

🎯 テクニカルアドバイス: OpenCodeの最大の利点はモデルの柔軟性です。APIYI（apiyi.com）のような中継サービスと組み合わせることで、同じ設定のままClaude、GPT-4、Geminiなど多様なモデルを切り替えて使用でき、コストパフォーマンスが最も優れた構成を見つけることができます。

参考文献・リソース

以下は、OpenCodeを設定する際に役立つリソースです：

まとめ

本記事で紹介した3ステップの構成方法を通じて、以下の内容を習得できたはずです：

1. OpenCodeのインストール: ワンクリックスクリプトやパッケージマネージャーを使用して素早くインストール
2. APIキーの設定: /connect コマンドまたは環境変数を使用して認証を設定
3. 設定ファイルの作成: opencode.json を記述し、プロキシサーバーとモデルを指定

OpenCodeはオープンソースのターミナルAIプログラミングアシスタントとして、APIプロキシと組み合わせて使用することで、コストを抑えつつモデルの柔軟性を保ちながら、Claude Codeに匹敵する体験を得ることができます。

APIYI (apiyi.com) を通じてAPIキーを迅速に取得し、テストを開始することをお勧めします。プラットフォームでは無料枠を提供しており、Claude、GPT、Geminiなどの主要なモデルをサポートしています。統一されたインターフェース形式により、設定がより簡単になります。

📝 著者: APIYI 技術チーム | APIYI apiyi.com – AI APIの呼び出しをよりシンプルに