Интеграции

Одна команда

curl -fsSL https://akyko.ru/install | sh

irm https://akyko.ru/install.ps1 | iex

Скрипт не ищет установленные инструменты сам - что настраивать, выбираете вы. Без аргументов он покажет меню со списком имён; имена можно передать и сразу, через запятую или как all:

curl -fsSL https://akyko.ru/install | sh -s -- --tools claude,codex

& ([scriptblock]::Create((irm https://akyko.ru/install.ps1))) -Tools claude,codex

Ключ скрипт возьмёт из AKYKO_KEY, из --key или спросит. По умолчанию он проверяет ключ запросом к /v1/models и пишет, если проверка не прошла; на unix для этой проверки нужен curl.

Опции

--print печатает всё, что будет записано, и выходит, ничего не меняя - разумный первый запуск, если не хочется отдавать скрипт в оболочку на слово.

Что скрипт делает с существующими файлами

• Перезаписываемый файл копируется рядом как .akyko-20260101-120000.bak с отметкой времени.
• JSON-конфиги дописываются, а не перезаписываются: чужие провайдеры и ключи остаются на месте, блок akyko обновляется. На unix для этого нужен jq - без него конфиг не трогается вообще, а скрипт печатает, что вписать руками.
• Текстовые конфиги - crushrc и rc-файл оболочки - правятся блоком между маркерами # >>> akyko >>> и # <<< akyko <<<.

Переменные окружения

Независимо от выбора инструментов скрипт дописывает блок переменных в rc-файл вашей оболочки - .zshrc, .bashrc (на macOS - .bash_profile, если он есть), config.fish или .profile. На Windows это пользовательские переменные окружения.

AKYKO_KEY=sk-...
AKYKO_API_KEY=$AKYKO_KEY
AKYKO_BASE_URL=https://api.akyko.ru/v1
OPENAI_API_KEY=$AKYKO_KEY
OPENAI_BASE_URL=$AKYKO_BASE_URL
OPENAI_API_BASE=$AKYKO_BASE_URL
ANTHROPIC_AUTH_TOKEN=$AKYKO_KEY
ANTHROPIC_BASE_URL=https://api.akyko.ru

Этого набора достаточно любому инструменту, который читает OPENAI_BASE_URL или ANTHROPIC_BASE_URL. Обратите внимание на разницу: у OpenAI-совместимого пути базовый URL с /v1, у Anthropic - только хост, путь клиент добавляет сам.

После установки нужен новый терминал - или source вашего rc-файла, иначе переменные не подхватятся.

Что настраивает скрипт

Для этих инструментов есть конфиг на диске, и скрипт пишет его сам. Если настраиваете руками, путь и содержимое - ниже; $XDG_CONFIG_HOME по умолчанию ~/.config. Имя модели в примерах - из каталога Модели, поменяйте на нужное.

Claude Code - --tools claude

~/.claude/settings.json, на Windows %USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.akyko.ru",
    "ANTHROPIC_AUTH_TOKEN": "sk-..."
  }
}

Единственный конфиг, в котором ключ лежит в открытом виде: Claude Code читает его только из файла или из переменной окружения ANTHROPIC_AUTH_TOKEN.

Codex CLI - --tools codex

~/.codex/config.toml, на Windows %USERPROFILE%\.codex\config.toml

model_provider = "akyko"

[model_providers.akyko]
name = "Akyko"
base_url = "https://api.akyko.ru/v1"
env_key = "AKYKO_KEY"
wire_api = "chat"

Строку model_provider скрипт добавляет только в новый файл. Если конфиг уже был и в нём есть свой model_provider, провайдер akyko допишется, а выбор останется за вами: строкой в конфиге или запуском codex --config model_provider=akyko.

Zed - --tools zed

$XDG_CONFIG_HOME/zed/settings.json, на Windows %APPDATA%\Zed\settings.json

{
  "language_models": {
    "openai_compatible": {
      "akyko": {
        "api_url": "https://api.akyko.ru/v1",
        "available_models": [
          {
            "name": "claude-sonnet-5-5",
            "display_name": "Akyko claude-sonnet-5-5",
            "max_tokens": 200000
          }
        ]
      }
    }
  }
}

Ключ Zed берёт из переменной AKYKO_API_KEY - имя он собирает из идентификатора провайдера. Запустите Zed из нового терминала, чтобы переменная подхватилась, или впишите ключ в Agent Settings - LLM Providers.

OpenCode - --tools opencode

$XDG_CONFIG_HOME/opencode/opencode.json, на Windows %USERPROFILE%\.config\opencode\opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "akyko": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Akyko",
      "options": {
        "baseURL": "https://api.akyko.ru/v1",
        "apiKey": "{env:AKYKO_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": {
          "name": "Akyko claude-sonnet-5-5"
        }
      }
    }
  },
  "model": "akyko/claude-sonnet-5-5"
}

Crush - --tools crush

$XDG_CONFIG_HOME/crush/crushrc, на Windows %USERPROFILE%\.config\crush\crushrc

provider add akyko --type openai-compat \
  --base-url "https://api.akyko.ru/v1" \
  --api-key "$AKYKO_KEY"
model add akyko/claude-sonnet-5-5 --name "Akyko claude-sonnet-5-5" --context-window 200000 --default-max-tokens 8192

После установки выберите модель Akyko в списке моделей - ctrl+l.

Droid - --tools droid

~/.factory/settings.json, на Windows %USERPROFILE%\.factory\settings.json

{
  "customModels": [
    {
      "model": "claude-sonnet-5-5",
      "displayName": "Akyko claude-sonnet-5-5",
      "baseUrl": "https://api.akyko.ru/v1",
      "apiKey": "${AKYKO_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 16384
    }
  ]
}

После установки выберите модель Akyko: /model, раздел Custom Models.

Qwen Code - --tools qwen

~/.qwen/settings.json, на Windows %USERPROFILE%\.qwen\settings.json

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5-5",
        "name": "Akyko claude-sonnet-5-5",
        "baseUrl": "https://api.akyko.ru/v1",
        "envKey": "AKYKO_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5-5"
  }
}

Goose - --tools goose

$XDG_CONFIG_HOME/goose/custom_providers/akyko.json, на Windows %APPDATA%\Block\goose\config\custom_providers\akyko.json

{
  "name": "akyko",
  "engine": "openai",
  "display_name": "Akyko",
  "description": "Akyko gateway",
  "api_key_env": "AKYKO_KEY",
  "base_url": "https://api.akyko.ru/v1/chat/completions",
  "models": [
    {
      "name": "claude-sonnet-5-5",
      "context_limit": 200000
    }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Обратите внимание: здесь в base_url указывается полный путь до /chat/completions, а не базовый URL. После установки выберите провайдер Akyko: goose configure, Change Provider.

Что настраивается внутри приложения

У этих инструментов конфига на диске, который можно безопасно править, нет: настройки живут в интерфейсе приложения. Скрипт их знает и печатает инструкцию, но записать за вас не может.

Инструмента нет в списке

Скрипт настраивает только перечисленное выше. Всё остальное подключается руками: если инструмент умеет работать с OpenAI-совместимым API, укажите базовый URL https://api.akyko.ru/v1 и ключ - больше ничего не нужно. Для клиентов, написанных под Claude, базовый URL - https://api.akyko.ru, см. Быстрый старт.