Об этом проекте

Poe Code — это инструмент, который направляет ваших любимых кодинг-агентов (Claude Code, Codex, OpenCode, Goose и т. д.) через API Poe, так что вам нужна только одна подписка Poe вместо управления несколькими провайдерами или аккаунтами. Он работает с обычными CLI или десктопными приложениями агентов после однократной настройки, а также поддерживает запуск разовых промптов для скриптов и CI/CD. ## Быстрый старт Установите Poe Code как провайдера по умолчанию для агента (обновляет файлы конфигурации): ```bash npx poe-code@latest configure npx poe-code@latest configure codex # или claude, opencode, goose ``` Удалите переопределения с помощью `unconfigure`: ```bash npx poe-code@latest unconfigure claude ``` ## Аутентификация Использует ваш API-ключ Poe. При первом запуске вам будет предложено войти через браузер (OAuth). Вы также можете указать ключ напрямую: ```bash npx poe-code@latest login npx poe-code@latest login --api-key <your-key> export POE_API_KEY=<your-key> ``` Учётные данные хранятся в `~/.poe-code/`. Проверьте статус с помощью `poe-code auth status`, удалите с помощью `logout`. ## Утилиты - **Запуск разового промпта**: `npx poe-code@latest spawn codex "Say hello" --mode read` (режимы: yolo, auto, edit, read; обязателен в CI без TTY). - **Запуск против репозитория GitHub**: `--cwd github://owner/repo` или с ref/subdir, например `github://owner/repo#main:packages/auth`. - **Передача промпта через stdin**: `echo "Say hello" | npx poe-code@latest spawn codex --mode read`. - **Проверка GitHub PR**: `code-review install`, `code-review run <url>`, `code-review commit <url> --dry-run`. - **Тестирование настроенного сервиса**: `npx poe-code@latest test codex`. - **Установка CLI агентов**: `install claude-code`, `install codex`, `install opencode`, `install goose`. - **Опциональные флаги**: `--dry-run` (показать изменения без записи на диск), `--yes` (принять значения по умолчанию). ## Использование и биллинг Проверьте баланс вычислительных баллов и историю использования: ```bash poe-code usage poe-code usage list poe-code usage list --limit 100 poe-code usage list --filter claude ``` ## Модели Список доступных моделей API Poe с фильтрацией по эндпоинту, провайдеру или поиску: ```bash poe-code models poe-code models --endpoint /v1/responses poe-code models --endpoint /v1/chat/completions poe-code models --search claude ``` ## SDK Используйте Poe Code программно в своём коде: ```typescript import { spawn, getPoeApiKey, getPoeAuthIdentity } from "poe-code"; const apiKey = await getPoeApiKey(); const identity = await getPoeAuthIdentity(); const result = await spawn("claude-code", { prompt: "Fix the bug in auth.ts", cwd: "/path/to/project", model: "claude-sonnet-4-6" }); console.log(result.stdout); ``` - `spawn(service, options)` – запускает один промпт; опции включают `prompt`, `cwd` (локальный путь или локатор `github://`), `model`, `mode`, `args`. Возвращает `{ stdout, stderr, exitCode }`. - `spawn.pretty(service, options)` – то же самое, но отображает цветной поток событий ACP. - `getPoeApiKey()` – читает переменную окружения `POE_API_KEY` или файл учётных данных. - `getPoeAuthIdentity()` – получает идентификационные данные аккаунта Poe. Для композиции на основе плагинов используйте подпуть `poe-code/agent` с `agent()`, `openaiResponsesPlugin()`, `systemPromptPlugin()`. ## Research Preview Функции, подверженные критическим изменениям: - **SafeJS** – интерпретатор JavaScript с явными возможностями хоста, бюджетами выполнения, возобновляемыми контрольными точками. Опубликован как `@poe-platform/safe-js`. Полное соответствие не установлено. - **Pipeline** – запуск планов задач с настраиваемыми шагами, живым прогрессом, очередью последующих действий. - **Ralph** – агентный цикл сборки, итерирующий по markdown-документу. - **Experiment loop** – цикл оптимизации в стиле Карпатого (агент изменяет код, оценка eval, сохранение/отбрасывание через git). - **Poe Agent** – композируемая среда выполнения агентов. ## Обновление ```sh npx poe-code@latest update npx poe-code@latest update --package-manager pnpm ``` Для проверки версий, пробных запусков и управляемых рабочих деревьев см. полную справку.