# Gajae Code

來源: https://docs.aicentos.com/zh-TW/clients/gajae-code

Language: zh-TW

> 在 Gajae Code（gjc）裡接入 aicentos —— 在 models.yml 裡加一個 OpenAI 相容 provider

Gajae Code 的 provider 定義在 `~/.gjc/agent/models.yml`，欄位是 `baseUrl` / `api` / `apiKey`，加一段就能指向 aicentos。

## 準備工作

先在控制台為 Gajae Code 建一個專用 Key（建議命名 `gajae-code`），然後安裝 CLI：

```bash
curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/gajae-code/v0.15.3/scripts/install.sh -o gjc-install.sh
sh gjc-install.sh
gjc --version
```

## 需要填寫的設定

| 欄位                     | 值                         |
| ---------------------- | ------------------------- |
| provider 名             | 自取，例如 `aicentos`          |
| `baseUrl`              | `https://aicentos.com/v1` |
| `api`                  | `openai-completions`      |
| `apiKey` 或 `apiKeyEnv` | 直接寫 Key，或寫環境變數名           |
| `models[].id`          | 控制台「模型廣場」中的模型名            |

## 設定步驟

編輯 `~/.gjc/agent/models.yml`：

```yaml
providers:
  aicentos:
    baseUrl: https://aicentos.com/v1
    api: openai-completions
    apiKeyEnv: AICENTOS_API_KEY
    discovery:
      type: openai-models-list
    models:
      - id: 你的模型名
        contextWindow: 128000
        maxTokens: 8192
```

把預設模型指過去：

```yaml
modelBindings:
  modelRoles:
    default: aicentos/你的模型名:high
```

然後匯出 Key 再啟動：

```bash
export AICENTOS_API_KEY="sk-你的-API-Key"
gjc
```

`discovery` 段讓它自動拉取模型列表；如果你想手動控制可見模型，去掉這一段、只留 `models`。

## 測試

啟動 `gjc`，在模型選擇器裡確認出現 `aicentos` 下的模型，發一句提示詞確認能返回。列表為空時先查 `models.yml` 的縮排與 `discovery` 段。

## 注意事項

* `models.yml` 嚴格校驗，未知欄位直接報錯。別從別的工具照抄 `api_key`、`base_url` 這種底線寫法，這裡要求駝峰式 `baseUrl`、`apiKey`。
* `contextWindow` 與 `maxTokens` 按實際模型填，寫大了會被上游拒絕。
* `modelRoles.default` 裡 `:high` 是推理強度後綴，按需改成其他檔位或去掉。
* 專案自述 experimental，升級後欄位可能變，以儲存庫 `docs/models.md` 為準。

## 相關連結

* [gajae-code 儲存庫](https://github.com/Yeachan-Heo/gajae-code)