> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Посібник із налаштування OpenCode CLI

> AceDataCloud Coding Plan API guide - Ace Data Cloud

## 1. Отримання API Key

Відкрийте [список застосунків Ace Data Cloud](https://platform.acedata.cloud/console/applications), перейдіть до доступного застосунку та скопіюйте API Key.

![Отримання Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. Встановлення OpenCode

```bash theme={null}
curl -fsSL https://opencode.ai/install | bash
```

Також можна використати npm:

```bash theme={null}
npm install -g opencode-ai
```

## 3. Налаштування API Key

```bash theme={null}
export ACEDATACLOUD_API_KEY="ваш API Key"
```

Щоб зміни діяли довгостроково, додайте цей рядок до `~/.zshrc` або `~/.bashrc`, а потім повторно відкрийте термінал.

## 4. Налаштування Provider

Відредагуйте `~/.config/opencode/opencode.json`:

```json theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "acedatacloud": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ace Data Cloud",
      "options": {
        "baseURL": "https://api.acedata.cloud/v1",
        "apiKey": "{env:ACEDATACLOUD_API_KEY}"
      },
      "models": {
        "MODEL_ID": { "name": "MODEL_ID" }
      }
    }
  }
}
```

Перейдіть до [каталогу моделей](https://platform.acedata.cloud/models), щоб переглянути назви моделей (наприклад, `claude-opus-5`, `gpt-6-sol`), і замініть усі `MODEL_ID` на одну й ту саму назву; для точної перевірки орієнтуйтеся на значення `id` у відповіді `/v1/models`. Це значення є назвою моделі, що використовується параметром API `model`, а не UUID сервісу чи API. Ace Data Cloud тут використовує Chat Completions, тому adapter — `@ai-sdk/openai-compatible`.

## 5. Перевірка та запуск

```bash theme={null}
opencode auth list
opencode models acedatacloud
opencode run --model acedatacloud/MODEL_ID "Reply only OK"
```

Потім запустіть `opencode` у каталозі проєкту. Якщо модель не відображається, перевірте шлях до файлу конфігурації, синтаксис JSON і змінні середовища; 401 означає, що Key недійсний або не експортований.

Розширення IDE повторно використовує ту саму конфігурацію OpenCode runtime, дивіться [OpenCode IDE Extension](https://platform.acedata.cloud/documents/opencode-ide-integration).

## Офіційні посилання

* [OpenCode Providers](https://opencode.ai/docs/providers/)
* [Конфігурація OpenCode](https://opencode.ai/docs/config/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.