Документация API go2llm

Инструменты для кода

go2llm говорит тремя стандартными протоколами: Anthropic Messages (/v1/messages), OpenAI Chat Completions (/v1/chat/completions) и OpenAI Responses (/v1/responses). Любой инструмент, которому можно задать свой base URL и API-ключ для одного из этих форматов, подключается без доработок. Ниже — точные шаги для конкретных coding-агентов и честный статус проверки каждого.

Что реально проверено

ИнструментПротоколСтатус
Claude CodeAnthropic Messages✅ проверено живым запросом
OpenCodeOpenAI Chat Completions✅ проверено живым запросом
Kilo CodeOpenAI Chat Completions📄 по документации Kilo Code, вручную не тестировали
Codex CLIOpenAI Responses✅ проверено живым запросом 2026-09-14: codex exec 0.151.0, wire_api = "responses", модель qwen3-8-flash
Claude Agent SDK, LangChain ChatAnthropicAnthropic Messages📄 POST /v1/messages/count_tokens отвечает, поэтому подсчёт контекста больше не бросает исключение; сборку агента целиком вручную не тестировали
Cursor—проверка живым запросом не сделана, статус не заявляем
Другой OpenAI-совместимый клиент (Cline, RooCode, Continue.dev, Aider и т.п.)OpenAI Chat Completions📄 работает, если клиент поддерживает свой base URL
Другой Anthropic-совместимый клиентAnthropic Messages📄 работает, если клиент поддерживает свой base URL

Claude Code

export ANTHROPIC_BASE_URL=https://go2llm.tech
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
export ANTHROPIC_MODEL=claude-haiku-4-5
claude

Используйте именно ANTHROPIC_AUTH_TOKEN, а не ANTHROPIC_API_KEY. Если на машине уже есть вход в Claude Code под личным аккаунтом (claude.ai или Anthropic Console), ANTHROPIC_API_KEY может уступить сохранённому логину, и запрос уйдёт мимо go2llm с 401. ANTHROPIC_AUTH_TOKEN всегда обращается к указанному ANTHROPIC_BASE_URL.

Перед запуском проверьте, что у выбранной модели в GET /v1/models есть messages в endpoints.

OpenCode

Добавьте провайдера в opencode.json (проектный файл или ~/.config/opencode/opencode.json):

{
  "provider": {
    "go2llm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "go2llm",
      "options": { "baseURL": "https://go2llm.tech/v1" },
      "models": { "claude-haiku-4-5": {}, "gpt-5.6-luna": {} }
    }
  }
}

Ключ передайте через opencode auth login (сохранится в ~/.local/share/opencode/auth.json, не в репозитории) либо добавьте "apiKey": "YOUR_API_KEY" в options для локального теста. Запуск:

opencode run "..." -m go2llm/claude-haiku-4-5

Kilo Code

Kilo Code — расширение VS Code без отдельного CLI, поэтому шаги ниже даны по документации Kilo Code и не проверены нами вручную.

  1. Settings → Providers → Custom provider.
  2. Provider API — OpenAI Compatible.
  3. Base URL — https://go2llm.tech/v1.
  4. API key — ваш ключ go2llm.
  5. Модели можно не вводить руками: Kilo Code сам запрашивает GET /v1/models и предлагает список.

Codex CLI

Endpoint POST /v1/responses у go2llm опубликован и проверен живым прогоном Codex CLI 2026-09-14: версия CLI 0.151.0, codex exec прочитал файл тестового проекта, исполнил инструменты, внёс правку и показал корректный diff — 21 432 токена. Прогон был на модели qwen3-8-flash; через /v1/responses обслуживаются те же модели, что на /v1/chat/completions. Интерактивный TUI codex мы не гоняли — только codex exec.

model = "gpt-5.3-codex"
model_provider = "go2llm"

[model_providers.go2llm]
name = "go2llm"
base_url = "https://go2llm.tech/v1"
env_key = "GO2LLM_API_KEY"
wire_api = "responses"

model и model_provider — ключи верхнего уровня ~/.codex/config.toml, они обязаны стоять выше любой таблицы […]. Ключ передаётся переменной окружения из env_key, в файл его не пишем:

export GO2LLM_API_KEY=gk_sk_ВАШ_КЛЮЧ
codex

Шим stateless: previous_response_id и store: true отклоняются с 400 stateful_responses_unsupported, background: true — с 400 background_unsupported. Обслуживаются ровно те модели, что и на /v1/chat/completions. usage.cost_usd приходит.

Подробный разбор, curl для проверки endpoint'а без Codex и история «почему это год не работало» — на странице Codex API. Другие проверенные живым запросом ответы на задачу coding-агента — OpenCode и Claude Code с этой страницы.

Claude Agent SDK и LangChain

POST /v1/messages/count_tokens отвечает в форме Anthropic: тело как у /v1/messages, ответ — {"input_tokens": N}. Раньше этого маршрута не было, и Anthropic SDK, Claude Agent SDK и LangChain ChatAnthropic падали с исключением на управлении контекстом ещё до первого запроса к модели. Теперь не падают.

Счёт — оценка, а не вендорский токенайзер, и ответ говорит об этом прямо: рядом с input_tokens приходит блок go2llm с "exact": false и названием метода. SDK читают input_tokens и лишние поля игнорируют. Вызов требует ключа, но денег не стоит.

Сборку агента целиком вручную мы не тестировали — статус в таблице выше отражает ровно это.

Cursor

Проверка живым запросом не сделана, поэтому мы не утверждаем ни что Cursor работает, ни что не работает. Как только проверка пройдёт, здесь появится либо инструкция, либо разбор причины отказа — как это сделано с Codex CLI.

Другой OpenAI Chat Completions-совместимый клиент

Подходит для инструментов вроде Cline, RooCode, Continue.dev, Aider и им подобных — поштучно мы их не проверяли, но протокол у go2llm стандартный:

  • Base URL: https://go2llm.tech/v1
  • Ключ: заголовок Authorization: Bearer YOUR_API_KEY
  • Каталог моделей: GET https://go2llm.tech/v1/models
  • Запросы: POST /v1/chat/completions

Другой Anthropic Messages-совместимый клиент

  • Base URL: https://go2llm.tech
  • Ключ: заголовок x-api-key: YOUR_API_KEY
  • Запросы: POST /v1/messages

Прежде чем считать клиент совместимым, отправьте тестовый запрос и сверьте usage.cost_usd в кабинете.

CI и сервер

  • Храните ключ в secrets CI, а не в YAML или репозитории.
  • Используйте отдельный ключ с минимальной квотой и списком разрешённых моделей.
  • Перед основной задачей проверяйте /status, /v1/models и короткий запрос.
  • Не печатайте заголовок Authorization или x-api-key в логах.

Цены на все модели — на странице биллинга, техническая справка — в документации.

Получить ключ и сделать первый запрос за 3 минуты → https://go2llm.tech/