poe-code

Poe Code는 선호하는 코딩 에이전트(Claude Code, Codex, OpenCode, Goose 등)를 Poe API를 통해 라우팅하는 도구로, 여러 제공업체나 계정을 관리하는 대신 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 ``` ## 인증 Poe API 키를 사용합니다. 첫 실행 시 브라우저 로그인(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; TTY 없는 CI에서 필수). - **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 ``` ## 모델 사용 가능한 Poe API 모델 목록, 엔드포인트, 제공자별 필터 또는 검색: ```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 계정 ID 가져오기. 플러그인 우선 구성의 경우 `poe-code/agent` 하위 경로를 `agent()`, `openaiResponsesPlugin()`, `systemPromptPlugin()`과 함께 사용하세요. ## 연구 미리보기 주요 변경 가능 기능: - **SafeJS** – 명시적 호스트 기능, 실행 예산, 재개 가능한 체크포인트를 갖춘 JavaScript 인터프리터. `@poe-platform/safe-js`로 게시. 완전한 적합성은 미확립. - **Pipeline** – 구성 가능한 단계, 실시간 진행 상황, 대기 중인 후속 작업으로 작업 계획 실행. - **Ralph** – 마크다운 문서를 반복하는 에이전트 빌드 루프. - **실험 루프** – Karpathy 스타일 최적화 루프 (에이전트가 코드 변경, 평가 점수, git으로 유지/폐기). - **Poe Agent** – 구성 가능한 에이전트 런타임. ## 업데이트 ```sh npx poe-code@latest update npx poe-code@latest update --package-manager pnpm ``` 버전 확인, 드라이 런, 관리 워크트리에 대한 전체 참조는 문서를 참조하세요.