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

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

AI-Schoolは、OpenCodeを特にプログラミング経験が豊富な教員、管理者、生徒向けに推奨します。OpenCodeはAiderより自律的に作業できるため、多くの変更をより速く実行できます。

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

いつOpenCodeを選ぶべきですか？

以下のユーザーにはOpenCodeを選択してください。

ターミナル、コードエディタ、Gitの経験がある
ローカルファイルの編集方法を理解している
変更を実際に使用する前に検証できる
より複雑なプログラミングタスクを実装したい

初級者向けのクラッシルクな学習にはAiderの方が適している場合があります。

インストール

OpenCodeの最も簡単なインストールは、OpenCodeドキュメントに従います:

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

また、Node.jsを使ってOpenCodeをインストールすることもできます：

npm install -g opencode-ai

あるいは macOS および Linux で Homebrew を使う方法：

brew install anomalyco/tap/opencode

コード化と接続する

OpenCodeは OpenAI互換のカスタムプロバイダをサポートします。プロジェクトフォルダに opencode.json というファイルを作成します。

その中で Coderen エンドポイントと許可モデルを使用します。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_SCHOOL_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-school-coderen/gpt-5.4-mini",
  "small_model": "ai-school-coderen/gpt-5.4-mini"
}

APIキーをその後、環境変数として設定します。

プロジェクトフォルダ内に .env ファイルを使用することもできます：

AI_SCHOOL_CODEREN_API_KEY=ais.あなたのAPIキー

新しいターミナルを開いた後、OpenCodeがこの変数を読み取れるかを確認してください。OpenCodeがキーを送信しない場合、AI-SchoolはAuthorizationヘッダーにBearerトークンが必須であるというエラーを返します。

macOSとLinux

export AI_SCHOOL_CODEREN_API_KEY="ais.あなたのAPIキー"

Windows

setx AI_SCHOOL_CODEREN_API_KEY "ais.あなたのAPIキー"

その後、新しいターミナルを開いてください。

OpenCodeを起動する

プロジェクトフォルダへ移動します：

cd パス/へ/あなたの/プロジェクト

OpenCodeを起動します：

opencode

OpenCode内でAI-School Coderenモデルを選択して、まだ自動選択されていない場合はそれを選択してください。

問題の解決

Authorization header with Bearer token is required

このメッセージは通常、OpenCodeがAPIキーを送信していないことを意味します。以下を確認してください。

AI_SCHOOL_CODEREN_API_KEY が正確にその名前であるか
値が ais. で始まるか
setx の後に新しいターミナルを開いたか
プロジェクトフォルダ内の .env ファイルがOpenCodeを起動する場所にあるか

Unknown parameter

一部のツールはプロバイダ固有の追加パラメータを送信します。Unknown parameter のようなメッセージが表示された場合、その設定をOpenCodeの設定から削除するか、より簡易なプロバイダ設定を使用してください。Coderenエンドポイントは、モデル、メッセージ、および通常の基本設定を含むOpenAI互換のチャットリクエストを期待します。

OpenCodeと安全に作業する

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

推奨の作業手順：

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

経験の少ない生徒には、教員の指導の下でOpenCodeを初めにデモ的に使うことが賢明です。

いつOpenCodeを選ぶべきですか？​

インストール​

コード化と接続する​

macOSとLinux​

Windows​

OpenCodeを起動する​

問題の解決​

Authorization header with Bearer token is required​

Unknown parameter​

OpenCodeと安全に作業する​