# Junie

出典: https://docs.aicentos.com/ja/clients/junie

Language: ja

> Junie CLI でカスタムモデル Profile を使って aicentos に接続する

Junie は JetBrains のコーディングエージェントで、IDE プラグインと Junie CLI の 2 つの形態があります。**カスタムエンドポイントに対応しているのは Junie CLI のみ**です。`$JUNIE_HOME/models/` 以下の JSON profile を通じて、任意の OpenAI 互換サービスに接続できます。IDE プラグインは現在、カスタムエンドポイントに向けることができません。

## 準備

まずコンソールの「API Key」ページで Junie 専用のキーを作成します（名前は `junie-cli` がおすすめです）。

* コンソール：[https://aicentos.com](https://aicentos.com)
* キーの作成：[https://aicentos.com/keys](https://aicentos.com/keys)
* 残高不足のときのチャージ：[https://aicentos.com/wallet](https://aicentos.com/wallet)

## 設定値

| 項目                             | 値                                          |
| ------------------------------ | ------------------------------------------ |
| `baseUrl`                      | `https://aicentos.com/v1/chat/completions` |
| `apiType`                      | `OpenAICompletion`                         |
| `apiKey`                       | コンソールで作成したキー（`${ENV_VAR}` 参照に対応）           |
| `id`                           | コンソール「モデル広場」のモデル名                          |
| `displayName` / `providerName` | 任意。例：`aicentos`                            |

注意：Junie の profile は多くのクライアントと逆で、`baseUrl` には**完全なエンドポイント**を入力し、必ず `/chat/completions` で終わる必要があります。Junie はパスを自動補完しません。

## 設定手順

* profile ファイルを作成します（ファイル名から `.json` を除いたものが profile 識別子になります）：
  * ユーザーレベル：`~/.junie/models/aicentos.json`（`$JUNIE_HOME` のデフォルトは `~/.junie`）
  * プロジェクトレベル：`<プロジェクトルート>/.junie/models/aicentos.json`（プロジェクトが信頼済みである必要があります）
* 次の内容を書き込みます：

```json
{
  "id": "gpt-5",
  "baseUrl": "https://aicentos.com/v1/chat/completions",
  "apiType": "OpenAICompletion",
  "apiKey": "${AICENTOS_API_KEY}",
  "displayName": "aicentos GPT",
  "providerName": "aicentos",
  "fasterModel": { "id": "gpt-5-mini" }
}
```

* 環境変数をエクスポートします：

```bash
export AICENTOS_API_KEY="sk-あなたのaicentosキー"
```

* 起動時に profile を指定するか、対話画面で `/model` から選択します：

```bash
junie --model custom:aicentos
```

## テスト

起動後、まず簡単なプロンプトで軽くテストし、結果が正常に返ることを確認してから agentic ワークフローを本格的に使い始めます。

## 注意事項

* **JetBrains IDE プラグインはカスタムエンドポイントに対応していません**。この profile は Junie CLI でのみ有効です。
* `baseUrl` は完全なエンドポイント（`/v1/chat/completions` を含む）である必要があります。Base URL だけ入力すればよい多くのクライアントとは異なります。
* `apiKey` と `extraHeaders` 内の `${VAR}` は profile のロード時に解決されます。環境変数が未設定だと profile のロードに失敗します。
* プロジェクトレベルの profile はプロジェクトの信頼制限を受けます。未信頼のプロジェクトでは `Unknown custom model profile` が報告されます。
* 小さいモデルは Junie のマルチステップのツール呼び出しや長いコンテキストのタスクに不向きです。能力の高いモデルを選ぶことをおすすめします。
* 詳しくはドキュメントサイトをご覧ください：[https://docs.aicentos.com](https://docs.aicentos.com)