メインコンテンツへスキップ

OpenCode のインストールと使用

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

AI-School は、OpenCode を特に多くのプログラミング経験を持つ教員、管理者、学生に推奨します。OpenCode は Aider より自立して動作できるため、より速く多くの変更を実行できます。

詳細は OpenCode のウェブサイト および 公式 OpenCode ドキュメント をご覧ください。

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

OpenCode を選ぶユーザーは次の条件を満たします：

  • ターミナル、コードエディタ、git の経験がある
  • ローカルファイルがどのように変更されるかを理解している
  • 変更を使用する前に確認できる
  • より複雑なプログラムタスクを展開したい

初心者向けのクラスルーム学習には、通常 Aider の方が適しています。

インストール​

OpenCode の最も簡単なインストールは、OpenCode ドキュメント に従った以下です：

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

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

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.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.6-luna",
  "small_model": "ai-school-coderen/gpt-5.6-luna"
}

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

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

AI_SCHOOL_CODEREN_API_KEY=ais.あなたの-apiキー

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

macOS と Linux​

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

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.あなたの-apiキー"

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

OpenCode の起動​

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

cd pad/naar/je/project

OpenCode を起動します：

opencode

OpenCode 内で AI-School Coderen モデルを選択するためのモデル選択を、まだ自動的に選択されていない場合は行います。

問題の解決​

Bearer トークンを含む Authorization ヘッダが必須​

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

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

Unknown parameter​

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

OpenCode で安全に作業する​

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

推奨される作業手順：

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

経験の少ない学生には、教員の指導のもと OpenCode を最初にデモ的に使用することを推奨します。

WhatsApp