Codex KKP

KKP: Kotlin Claude Code sKill Plugin.

Обзор

中文 | English

Codex KKP — плагин для Claude Code, обеспечивающий бесшовную интеграцию с Codex AI Agent для анализа кода, реализации задач и совместной работы. Предоставляет субагент и скилл для Codex AI Agent.

Возможности

• Мультиплатформенность: нативные бинарники для macOS, Linux и Windows
• Оптимизация результатов: по умолчанию возвращаются только завершённые результаты для снижения потребления токенов
• Режимы sandbox: настраиваемые уровни безопасности (read-only, workspace-write, danger-full-access)
• Управление сессиями: возобновление предыдущих сессий и сохранение контекста
• Субагенты Claude Code: параллельный запуск субагентов для повышения производительности
• Без сахара, без калорий: очень полезно

Использование

После установки и настройки плагин Codex KKP доступен внутри Claude Code. Плагин предоставляет субагент и скилл для анализа кода, реализации задач и совместной работы.

Проверить успешную установку можно с помощью /agents или вопроса «What skills do you have?». После успешной установки можно давать Claude Code инструкции на использование субагентов или скиллов Codex, например:

Claude Code самостоятельно решает, использовать скиллы или агентов, исходя из промпта.

Файловые операции

По умолчанию codex-kkp требует от codex режима sandbox=read-only. Если необходимо, чтобы codex напрямую изменял файлы, Claude Code должен явно указать режим sandbox=workspace-write или передать параметр --full-auto (более опасный вариант) при вызове codex-kkp.

Это описано в прогрессивной документации скилла, однако если Claude Code не может разобраться самостоятельно, добавьте соответствующие детали в промпт.

Codex вернёт содержимое файловых операций при условии использования tool API вроде apply_patch, а не Bash/Command-операций.

Установка

Загрузка из репозитория

1. Скачать/клонировать исходники из репозитория

1.1 Скачать исходники

Скачайте исходный код ветки plugins/release и распакуйте архив.

1.2 Клонировать репозиторий

Или клонируйте репозиторий и переключитесь на ветку plugins/release.

2. Добавить в маркетплейс Claude Code

Запустите claude:

Используйте /plugin:

Выберите Add marketplace:

и укажите локальный путь к скачанному/клонированному репозиторию.

Загрузка из releases

Перейдите в раздел releases и выберите версию (например, последнюю).

Выберите нужные файлы из assets, скачайте и настройте их:

1. Скачать zip-файл маркетплейса

Архив codex-agent-collaboration-marketplace.zip в Assets — полный пакет маркетплейса, включающий плагины и скиллы.

После скачивания и распаковки запустите Claude Code:

Используйте команду /plugin:

Выберите Add marketplace:

Затем укажите локальный путь к распакованной директории маркетплейса (директория, содержащая папку .claude-plugin).

2. Скачать zip-файл скиллов

Архив codex-agent-collaboration.zip в Assets содержит единый мультиплатформенный пакет скиллов. Скачайте и распакуйте его, затем поместите извлечённую директорию в папку скиллов (например, <PROJECT_DIR>/.claude/skills/codex-agent-collaboration/).

Один ZIP-файл включает исполняемые файлы для всех поддерживаемых платформ:

• macOS x86_64 (Intel) — executables/codex-kkp-cli-macosx64
• macOS ARM64 (Apple Silicon) — executables/codex-kkp-cli-macosarm64
• Linux x86_64 — executables/codex-kkp-cli-linuxx64
• Linux ARM64 — executables/codex-kkp-cli-linuxarm64
• Windows x86_64 — executables/codex-kkp-cli-mingwx64

Claude Code автоматически выберет подходящий исполняемый файл для вашей системы.

3. Скачать отдельный бинарный файл

Отдельные бинарные файлы (например, codex-kkp-cli-macosx64, codex-kkp-cli-mingwx64) в Assets — это исполняемые файлы для каждой платформы. Можно скачать только файл для своей платформы и самостоятельно настроить скиллы.

Примечание: все исполняемые файлы используют единое именование без расширений (включая сборки для Windows (mingwx64)).

Настройка

После завершения установки плагина можно заранее настроить параметры.

Отредактируйте файл .claude/settings.local.json в вашем проекте и добавьте следующую конфигурацию в свойство permissions.allow:

Установка только скилла

{
  "permissions": {
    "allow": [
      "Skill(codex-agent-collaboration-plugin:codex-agent-collaboration)",
      "Bash(~/.claude/skills/codex-agent-collaboration/executables/codex-kkp-cli-macosx64:*)"
    ]
  }
}

Установка полного плагина через маркетплейс

{
  "permissions": {
    "allow": [
      "Skill(codex-agent-collaboration-plugin:codex-agent-collaboration)",
      "Bash(~/.claude/marketplace/codex-kkp-skills-marketplace/codex-agent-collaboration-plugin/skills/codex-agent-collaboration/executables/codex-kkp-cli-macosx64:*)"
    ]
  }
}

При локальной загрузке замените ~/.claude/marketplace/ на путь к локально скачанному codex-kkp-skills-marketplace.

В Bash путь указывает на исполняемый файл внутри установленного пакета плагина, соответствующий платформе вашей системы. Возможно, потребуется небольшая корректировка в зависимости от реальной ситуации.

Удаление

Иногда при попытке обновить или удалить плагин могут возникнуть трудности. Если это произошло, можно удалить плагин вручную, удалив соответствующую директорию из папки маркетплейса или скиллов.