OpenCode をインストールして使用する

OpenCode はエージェント的なコーディングツールです。ツールはターミナルアプリケーション、デスクトップアプリケーション、IDE拡張機能として利用可能です。

AI-Public は開発者、管理者、その他の上級ユーザーに OpenCode を推奨します。OpenCode はファイルを自動で修正したりタスクを展開したりします。したがって、提案された変更を必ず確認してください。

詳しくは OpenCode の公式サイトおよび OpenCode の公式ドキュメントをご参照ください。

インストール

OpenCode ドキュメントに基づく最も簡単なインストールは次のとおりです：

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

また Node.js でもインストールできます：

npm install -g opencode-ai

あるいは macOS と Linux で Homebrew を使う場合：

brew install anomalyco/tap/opencode

Coderen との接続

OpenCode は OpenAI-compatible providers のカスタムをサポートします。プロジェクトディレクトリに opencode.json を作成します。

以下の Coderen エンドポイントと許可されたモデルを使用します：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-public-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Public Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_PUBLIC_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-public-coderen/gpt-5.4-mini",
  "small_model": "ai-public-coderen/gpt-5.4-mini"
}

API キーを次に環境変数として設定します。

macOS と Linux

export AI_PUBLIC_CODEREN_API_KEY="aip.あなたのAPIキー"

Windows

setx AI_PUBLIC_CODEREN_API_KEY "aip.あなたのAPIキー"

その後、新しいターミナルを開きます。

OpenCode を起動する

プロジェクトディレクトリへ移動します：

cd pad/naar/je/project

OpenCode を起動します：

opencode

OpenCode でモデル選択を使用して、まだ自動で行われていない場合は AI-Public Coderen モデルを選択します。

OpenCode での安全な作業

OpenCode はエージェント的に動作するため、変更を確認することが重要です。

推奨の作業方法：

git リポジトリ内で作業します。
小さなタスクから始めます。
コードを使用する前に差分を確認します。
変更後にアプリケーションをテストします。
自分が理解できる変更のみをコミットします。

環境変数と OpenCode

OpenCode にはローカルの .env ファイルに Coderen API キーを保存しておくことができます（プロジェクトディレクトリ内）。

AI_PUBLIC_CODEREN_API_KEY=aip.jouw-api-sleutel

OpenCode がこの環境変数を実際に読み込むことを確認してください。PowerShell では現在のターミナルに対して一時的に環境変数を設定することもできます：

$env:AI_PUBLIC_CODEREN_API_KEY="aip.jouw-api-sleutel"

Authorization header with Bearer token is required と表示される場合、ツールが Authorization: Bearer ... として鍵を送信していません。Unknown parameter と表示される場合は、OpenCode が AI-Public の Coderen エンドポイントをサポートしていないプロバイダ固有の設定を削除してください。

インストール​

Coderen との接続​

macOS と Linux​

Windows​

OpenCode を起動する​

OpenCode での安全な作業​

環境変数と OpenCode​