Skip to content

editors.md

Latest commit

 

History

History
93 lines (66 loc) · 3.55 KB

editors.md

File metadata and controls

93 lines (66 loc) · 3.55 KB
Raw

Подключение редакторов

Прокси притворяется OpenAI-совместимым сервером. Подойдёт любой клиент, где можно задать свой base URL.

Общие параметры

Параметр Значение
Base URL http://127.0.0.1:8000/v1
API key любое непустое значение (sk-local)
Модель CodeChat

Ключ не проверяется — прокси авторизуется в GigaCode сам, по SberID. Но многие редакторы не дают сохранить пустое поле, поэтому впишите что угодно.

Устойчивость к формату base URL

Редакторы по-разному достраивают путь, поэтому префикс нормализуется. Все варианты работают и дают один результат:

/v1/chat/completions        /chat/completions
/api/v1/chat/completions    /openai/v1/chat/completions
/oai/v1/chat/completions    /v1/v1/chat/completions

Так что base URL можно указывать и как http://127.0.0.1:8000, и как http://127.0.0.1:8000/v1 — ошибиться сложно.

Cline / Roo Code (VS Code)

  1. Provider: OpenAI Compatible
  2. Base URL: http://127.0.0.1:8000/v1
  3. API Key: sk-local
  4. Model ID: CodeChat

Работает и чат, и агентный режим с инструментами.

Zcode

Настраивается так же. Обратите внимание: Zcode присылает около 29 схем инструментов, и агент активно перечитывает файлы — контекст растёт быстро. Следите за предупреждением [WARN] context is … и начинайте новый чат.

Continue.dev

{
  "models": [{
    "title": "GigaCode",
    "provider": "openai",
    "model": "CodeChat",
    "apiBase": "http://127.0.0.1:8000/v1",
    "apiKey": "sk-local"
  }]
}

Open WebUI

Settings → Connections → OpenAI API: URL http://127.0.0.1:8000/v1, любой ключ. Для просмотра рассуждений поставьте GIGACODE_SHOW_REASONING=field.

Клиенты со своим списком моделей

GET /v1/models отдаёт 13 имён: канонические модели плюс распространённые алиасы (gigacode, codechat, qwen3-32b и другие). Работает и GET /v1/models/{любое_имя} — некоторые клиенты проверяют модель перед каждым запросом.

Если редактор требует имя, которого нет в списке:

GIGACODE_EXTRA_MODELS=gpt-4o,claude-3-5-sonnet

Имена появятся в /v1/models, а запросы уйдут в CodeChat.

Если редактор ведёт себя странно

Посмотрите, что он на самом деле присылает:

curl -s -X POST http://127.0.0.1:8000/debug/echo \
  -H "Content-Type: application/json" \
  -d '{"model":"CodeChat","messages":[{"role":"user","content":"hi"}]}'

В ответе два объекта: received — что прислал клиент, upstream_would_be — что ушло бы в GigaCode. Этого обычно достаточно, чтобы понять расхождение.

Дальше — troubleshooting.md.