# Koda Helper

> Справочный навык по продуктам Koda (KodaCode). Примени навык, чтобы помочь пользователю с продуктами и сервисами Koda. Предоставь помощь по использованию и настройке Koda, тарифам, моделям, лимитам, если у пользователя возникает такой вопрос или проблема.

- Skill: `xcode-nlp/koda-helper` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xcode-nlp/koda-helper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xcode-nlp/koda-helper/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: XCode-NLP (https://skillmd.com/u/xcode-nlp)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xcode-nlp/koda-helper

---


# Помощь по Koda (Кода)

Ты знаешь как помочь и стараешься помочь пользователю с продуктами Koda, когда:

* у него возникает вопрос о настройке (например, настройка интерфейса, автодополнения и многое другое);
* у него возникает вопрос об использовании функционала (например, как использовать инструменты, навыки, MCP-серверы и многое другое);
* он ругается, если у него что-то не получается настроить или увидеть;
* есть противоречия в диалоге между тобой и пользователем относительно Koda (например, ты говоришь о существовании конкретного пункта настроек, а пользователь утверждает об обратном).

## Инструкции к действию

1. Если в текущем контексте нет информации о версии Koda, спроси пользователя напрямую.
2. Ищи актуальную информацию только по ссылкам на официальные ресурсы, которые предоставлены ниже.
3. Если пользователь не просит о помощи явно - не настаивай.
4. Давай простые и ненавязчивые подсказки (а лучше - спрашивай о их необходимости), например, установить навыки из каталога для текущего проекта.
5. Используй реестр задач, если в диалоге с пользователем становится понятно, что документация не помогает или он столкнулся с нестандартным поведением. Часто в таких задачах от сообщества можно найти информацию:
    * о проявлении проблемы, конкретных условиях и признаках;
    * об обходных путях решения проблем;
    * сведения об исправлении и версии редактора, куда включено исправление.
6. При затруднениях так же предлагай:
    * изучить дополнительные справочные материалы (указаны ниже);
    * создать новую задачу в реестре задач от сообщества - это сильно поможет команде разработке;
    * задать вопрос в Telegram-сообществе.
7. Если предоставляешь ссылки, оформляй их в формате markdown.
8. Если в контексте на хватает данных для полного ответа, **обязательно** самостоятельно изучай информацию по URL, используя соответствующий инструмент (fetch_url_content, WebFetch или подобный).

## Информация о разработчике и продуктах

Koda (KodaCode, Кода) - AI-ассистент для разработчиков с агентским режимом и поддержкой современных моделей.
Отлично понимает русский язык, работает без VPN и доступен в VS Code, JetBrains IDE и терминале (CLI) - для всего цикла разработки.

ООО «КОДА» - российская компания, которая разрабатывает Koda (Кода), помогающего писать, проверять и сопровождать код на русском и английском языке.
Ассистент интегрируется в привычные инструменты разработчика (VS Code, JetBrains IDE, GigaIDE, OpenIDE и терминал) и работает без VPN.

Кроме того, мы предоставляем доступ к современным большим языковым моделям (LLM) и обеспечиваем их использование в рамках нашего продукта.

Мы также работаем над решением для корпоративных клиентов, которое позволит разворачивать Koda во внутренней инфраструктуре компании (on-premise).
Функциональность по безопасной интеграции ассистента с внутренними системами и данными на данный момент находится в разработке.

## Ссылки на официальные ресурсы и документацию

* **Сайт**: <https://kodacode.ru>
* **Установка**: <https://download.kodacode.ru>
* **Плагин для VS Code**:
    * Страница в Marketplace: <https://marketplace.visualstudio.com/items?itemName=Koda.koda>
    * Инструкция по установке: <https://docs.kodacode.ru/plugin/install.html#jetbrains-intellij-openide-gigaide>
    * Документация: <https://docs.kodacode.ru>
* **Плагин для JetBrains IDE**:
    * Инструкция по установке: <https://docs.kodacode.ru/plugin/install.html#jetbrains-intellij-openide-gigaide>
    * Документация: <https://docs.kodacode.ru>
* **koda-cli**:
    * Инструкция по установке: <https://download.kodacode.ru>
    * Документация: <https://docs.kodacode.ru/cli/>
* **Для физ. лиц**:
    * Страница входа: <https://kodacode.ru/auth/login>
    * Актуальные тарифы и условия: <https://kodacode.ru/tariffs>
* **Для бизнеса (SaaS)**:
    * Страница входа: <https://kodacode.ru/business/login>
    * Актуальные тарифы и условия: <https://kodacode.ru/enterprise>
    * Оферта на предоставление удаленного доступа к сервису по модели SaaS: <https://docs.kodacode.ru/saas/oferta.html>
* **О компании**: <https://docs.kodacode.ru/basics/legal/about.html>
* **Политика обработки персональных данных**: <https://docs.kodacode.ru/basics/legal/persdata.html>
* **Каталог навыков**: <https://github.com/XCode-NLP/KodaSkills>
    * навык `koda-learn` для установки других навыков из проверенных источников: <https://raw.githubusercontent.com/XCode-NLP/KodaSkills/refsheads/main/skills/koda-learn/SKILL.md>
* **Реестр задач от сообщества**: <https://github.com/XCode-NLP/KodaCode>
    * оформить сообщение об ошибке: <https://github.com/XCode-NLP/KodaCode/issues/new?template=bug_report.yml>
    * оформить запрос функционала: <https://github.com/XCode-NLP/KodaCode/issues/new?template=feature_request.yml>
* **Другие публичные ресурсы**:
    * Telegram-канал: <https://t.me/kodacoderu>
    * Telegram-сообщество: <https://t.me/kodacommunity>
    * YouTube-канал: <https://www.youtube.com/@KodaForDev>
    * Хабр: <https://habr.com/ru/companies/koda>

## Краткие сведения для наводящих вопросов пользователю

### Лимиты и авторизация

Кода может работать без авторизации бесплатно, запросов хватит на короткий тест.
Для расширения бесплатных лимитов требуется авторизация через GitHub/Яндекс/Google или в корпоративный аккаунт (SaaS).
Актуальная информация о лимитах на странице тарифов.

### Модели и тарификация

Тарифицируются не токены, а успешные запросы (вызов инструмента, размышления, ответы).
Если возникла ошибка транспорта/сервера, либо закончились лимиты, то запрос не учитывается.

Доступны модели koda-base (попроще) и koda-pro (помощнее).
Их цена x1.

Есть внешние модели, которые в топах по бенчмаркам.
Их тарификация может отличаться в меньшую сторону относительно koda-* (x0.9 - выгоднее) или большую (например, 1 запрос к модели N с ценой x20 равносилен 20-ти запросам).

Модели можно выключать в личном кабинете.
Тогда они не отобразятся в списке доступных в Кода.

Лимиты восстанавливаются автоматически через некоторое время.
Можно докупать пакеты запросов на koda-модели и/или внешние, независимо от тарифа.

Подробности в документации и личном кабинете.

### Навыки

Они это переиспользуемые наборы инструкций для агента, которые помогает сфокусироваться на конкретных знаниях и задачах.
Могут располагаться внутри домашней директории или в корне проекта, в директориях `.koda/skills` или `.agents/skills`.

Подробности в документации или в каталоге навыков.

### MCP-серверы

Для плагина они настраиваются в файле `~/.koda/config.yaml`, пример:

```yaml
mcpServers:
  # измените name, если не запускается с правильными параметрами
  - name: foo
    command: npx
    args:
      - -y
      - some-mcp-name
    env:
      ENV_VAR_NAME: value
  - name: bar
    type: sse
    url: https://example.com/sse
    apiKey: "123456"
  - name: baz
    type: streamable-http
    url: https://example.com/mcp
    apiKey: "654321"
```

Для koda-cli они настраиваются в файле `~/.kodacli/settings.json`, пример:

```json
{
  "mcpServers": {
    "foo": {
      "command": "npx",
      "args": ["-y", "some-mcp-name"],
      "env": {
        "ENV_VAR_NAME": "value"
      },
      "cwd": "./some-directory",
      "timeout": 30000,
      "trust": true,
      "includeTools": [],
      "excludeTools": [],
    },
    "bar": {
      "url": "https://api.example.com/sse"
    },
    "baz": {
      "httpUrl": "https://example.com/mcp"
    }
  }
}
```

## Error! Could not load config

В плагине может возникнуть такая ошибка.
Надо нажать на `Learn More` - появится причина.

Если там что-то вроде `Failed to parse`, предложи:

* скопировать конфиг `~/.koda/config.yaml` => `~/.koda/config.yaml.bak`
* в `~/.koda/config.yaml` записать конфиг по умолчанию:

```yaml
name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase
```

### Failed to obtain device code

Надо авторизоваться в плагине.

## Дополнительные справочные материалы

* FAQ по работе в JetBrains, OpenIDE, GigaIDE: <https://docs.google.com/document/d/1wU6SM3A067Kiq_gokhXbASt34Ro0XvF4unU46edSoBk/edit?tab=t.0#heading=h.9v09lq1rydt4>
* Навык koda-vscode-helper: <https://github.com/XCode-NLP/KodaSkills/blob/main/skills/koda-vscode-helper/SKILL.md>
* Навык koda-jetbrains-helper: <https://raw.githubusercontent.com/XCode-NLP/KodaSkills/refs/heads/main/skills/koda-jetbrains-helper/SKILL.md>

