OpenCode のインストールと使用
OpenCode はエージェント系のコーディングツールです。ツールはターミナルアプリケーション、デスクトップアプリケーション、IDE拡張機能として利用可能です。
AI-Public は開発者、運用担当者、その他の上級ユーザーに OpenCode を推奨します。OpenCode はファイルを自動で修正したりタスクを展開したりします。提案された変更は必ず確認してください。
詳細は OpenCode 公式サイト と 公式 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
Coderen への接続
OpenCode は AI-公開互換のプロバイダ をサポートします。プロジェクトディレクトリに 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.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-public-coderen/gpt-5.6-luna",
"small_model": "ai-public-coderen/gpt-5.6-luna"
}
APIキーを環境変数として設定してください。
macOS と Linux
export AI_PUBLIC_CODEREN_API_KEY="aip.あなたのAPIキー"
Windows
setx AI_PUBLIC_CODEREN_API_KEY "aip.あなたのAPIキー"
その後、新しいターミナルを開きます。
OpenCode の起動
プロジェクトディレクトリへ移動します。
cd パス/へ/あなたの/プロジェクト
OpenCode を起動します。
opencode
OpenCode でモデルの選択を行い、AI-Public Coderen モデルを選択します。自動で行われない場合もあります。
OpenCode での安全な作業
OpenCode はエージェントとして動作するため、変更を確認することが重要です。
推奨ワークフロー:
- Git リポジトリで作業する。
- 小さなタスクから始める。
- コードを使用する前に差分を確認する。
- 変更後にアプリケーションをテストする。
- 理解できる変更のみをコミットする。
環境変数と OpenCode
OpenCode には Coderen API キーをプロジェクトディレクトリのローカル .env ファイルに保存できます。
AI_PUBLIC_CODEREN_API_KEY=aip.あなたのAPIキー
OpenCode がこの環境変数を実際に読み込むことを確認してください。 PowerShell では現在のターミナルのために一時的に変数を設定することもできます。
$env:AI_PUBLIC_CODEREN_API_KEY="aip.あなたのAPIキー"
Authorization header with Bearer token is required と表示される場合、ツールは Authorization: Bearer ... にキーを送信しません。Unknown parameter と表示される場合は、AI-Public の Coderen エンドポイントをサポートしていないプロバイダ固有の設定を削除してください。