APIキーでのコーディング
Coderen APIキーを使うと、OpenAI互換のAPIで動作するプログラミングツールを利用できます。ツールはAI-Schoolにリクエストを送ります。AI-Schoolはキー、予算、有効期間、許可されたモデルを検証します。
その後、AI-Schoolは環境の技術連携を通じてリクエストを処理します。
何が必要ですか?
以下の3つの情報が必要です。
| データ | どこで見つけるか |
|---|---|
| APIキー | 管理者または教員から取得します |
| エンドポイント | https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1 |
| モデル名 | 例:gpt-5.6-luna、gpt-5.6-terra、gpt-5.6-sol |
APIキーは ais. で始まります。パスワードとして扱ってください。
どのモデルを選ぶべきですか?
多くの学生には、GPT-5.6 Luna が良い出発点です。この高速なモデルは授業中のプログラミング支援や日常的なコード質問に適しています。
教員や上級の学生には、GPT-5.6 Terra が大規模プロジェクトや複雑なコードに適しています。最も要求の高いタスクにはGPT-5.6 Solを選択してください。分析、計画、推論が多く求められます。
どのツールを選ぶべきですか?
AI-Schoolは2つのツールを提案します。
| ツール | 推奨対象 | 理由 |
|---|---|---|
| Aider | 学生とクラスでのコーディング | 直截的、見やすく、エージェント的挙動が少ない |
| OpenCode | 教員と上級ユーザー | エージェント的CLIツールで、デスクトップアプリもあり |
学生向けのAider
Aiderは端末でのペアプログラミングツールとして機能します。ユーザーは助けを求め、変更を確認し、コードに近い状態を保ちます。プログラミング学習に適しており、学生は支援を受けつつ、自分で関与します。
公式のAiderドキュメントも参照してください: https://aider.chat/docs/
上級使いのOpenCode
OpenCodeはよりエージェント的です。ツールは自立して手順を実行したり、ファイルを編集したり、タスクをさらに展開したりします。強力ですが、コード、Git、ローカル開発環境の理解をより求めます。
公式のOpenCodeドキュメントも参照してください: https://opencode.ai/docs/
鍵の安全な取り扱い
APIキーを публичに共有したり、共有するコードに埋め込まないでください。
推奨事項:
- 環境変数を使用する
.envをローカルに置き、Gitへ送信しない- ツールの組み込み設定を利用する
OpenCodeの場合、プロジェクトフォルダ内に .env を使用する例:
AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel
ツールがこの .env を実際に読み込むことを確認してください。PowerShellでは現在のターミナルで一時的に環境変数を設定できます:
$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"
APIキーを公開リポジトリ、Teamsチャット、共有ドキュメント、スクリーンショットに決して置かないでください。
キーが機能しない場合
次を確認してください。
- 環境で Coderen が有効になっているか
- キーがまだ有効かどうか
- 予算が残っているか
- キーが設定された有効期間内か
- 使用しているモデルが許可されているか
- エンドポイントが正しく設定されているか
- ツールが APIキーを
Authorization: Bearer ...で送信しているか - ツールが OpenAI の Coderen がサポートしていないプロバイダー特有のパラメータを送っていないか
疑問があれば、管理者または教員にキーを確認してもらってください。