opper-cli

スキルのバージョンは2026-10-21です。 これはローカルにインストールされたコピーであり、古くなっている可能性があります。セッションごとに一度、https://skills.opper.ai/versions.json を取得し、その "opper-cli" エントリーと2026-10-21を比較してください。異なる場合は、https://skills.opper.ai/opper-cli/SKILL.md を読み、残りのセッションではこのコピーの代わりにそちらに従い、インストール済みの Opper スキルが古くなっていることをユーザーに一度だけ伝えてください（npx skills update で更新するか、手動でクローンした場合は git pull を実行してください）。インストール済みファイルは編集しないでください。取得に失敗した場合は、このコピーを使い続けてください。

opper のサブスキルです。探索とセットアップのガイダンスについては、まずこちらを参照してください。 ソース：https://github.com/opper-ai/opper-skills/blob/main/opper-cli/SKILL.md

Opper CLI

npm パッケージ @opperai/cli として配布される、公式の Opper CLI です。ソース：github.com/opper-ai/cli。Node.js ≥ 20.12 が必要です。

この CLI は、API の薄いラッパーにとどまりません。コーディングエージェント（Claude Code、OpenCode、Codex、Hermes、Pi）も起動し、モデルのトラフィックを Opper 経由にルーティングします。また、バンドルされたスキルをインストールし、AI コードエディターを Opper に接続します。

エージェントを活用したセットアップ、プラットフォーム操作、モデルのテストには、opper-mcp スキルを優先してください。MCP を接続すると Opper のツールを利用できます。opper launch はエージェント自身の推論を Opper 経由でルーティングします。また、この CLI では opper keys create --project <uuid> --name <name> --output <env-file> を使ってアプリケーションキーを非公開で取得できます。opper keys create --help を参照し、生成されたシークレットを読み取ったり表示したりしないでください。

インストール

npm i -g @opperai/cli
opper --version

認証

opper login    # OAuth device flow — recommended
opper whoami   # confirm the active slot

状態は ~/.opper/config.json に、デバイスフローで登録されたスロットのリストとして保存されます。任意のコマンドで --key <slot> を指定してスロットを選択します（デフォルトは default）。opper config list/get/remove でスロットを確認または削除できます。

opper login はブラウザーで対話的に認証するため、キーをコマンドに入力したり貼り付けたりする必要はありません。ブラウザーを使わない方法については、opper config --help を参照してください。

リクエスト時の解決順序：環境変数 OPPER_API_KEY > --key で指定したスロット（または default）。

常に --help を使用してください — これが信頼できる情報源です

サブコマンドの仕様は、このスキルの更新よりも速く変化します。フラグや引数の順序を推測する前に、次を実行してください。

opper --help              # top-level command list, grouped by domain
opper <command> --help    # subcommands and flags

引数なしで opper を実行すると、対話型メニューが表示されます（Account · Agents · Skills · Opper）。

トップレベルのコマンドグループ

グループ	機能
login / logout / whoami	OAuth デバイスフローとスロットの確認。
config list/get/remove	認証スロットを確認または削除します（スロットは opper login で作成されます）。
call <name> <instructions> [input]	Opper 関数を実行します。input を省略すると標準入力を使用します。--model、--stream に対応。レガシー — 廃止予定の /v3/call インターフェースを使用します。これを前提に新たな実装を行わないでください（注意事項を参照）。
functions list/get/delete	保存済み関数を管理します。
indexes ...	ナレッジベースです。ナレッジベース機能とともに廃止予定です。新たに使用を開始しないでください。
models list/create/get/delete	組み込みモデルとカスタムモデル（LiteLLM ベース）を管理します。
traces list/get/delete	実行トレースを確認します。
usage list	トークンとコストの分析情報を表示します。CSV へのエクスポートも可能です。
image generate <prompt>	画像を生成します。
agents list / launch <agent>	Opper 経由でコーディングエージェントを一覧表示し、起動します。
editors list/opencode/continue	AI コードエディターを Opper に接続します。
skills list/install/update/uninstall	バンドルされた Opper の SKILL.md ドキュメントを ~/.claude/skills/ と ~/.codex/skills/ にインストールします。
version	CLI のバージョンを表示します（--version / -v も使用できます）。

Opper 経由でエージェントを起動する

opper launch <agent> は、注目の新機能です。エージェント名の後に続く内容は、そのままエージェントの CLI に渡されます。エージェントごとに接続方法が異なるため、最新の一覧については github.com/opper-ai/cli の README を取得してください。

opper agents list             # NAME / DISPLAY / KIND / STATE / CONFIG / COMMAND
opper launch claude           # Claude Code (via ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN)
opper launch opencode         # OpenCode
opper launch codex            # OpenAI Codex
opper launch hermes           # Hermes (isolated HERMES_HOME, leaving your existing ~/.hermes/ unchanged)
opper launch pi               # Pi (pi.dev)
opper launch <agent> --install  # also installs the upstream agent when it is not already present

内部では、これらはすべて /v3/compat/... にルーティングされます（opper-api スキルを参照）。

グローバルフラグ

フラグ	説明
--key <slot>	使用する API キーのスロット（デフォルト：default）。
--debug	詳細な診断出力を表示します。
--no-telemetry	匿名テレメトリを無効にします。
--no-color	ANSI カラーを無効にします。
-v, --version	CLI のバージョンを表示します。
-h, --help	ヘルプを表示します（ドメイン別に分類）。

見落としやすい注意点

• OPPER_API_KEY 環境変数は --key より優先されます。 環境変数が設定されている場合、--key <slot> フラグは効果がありません。スロットを使うには、環境変数を解除してください。
• opper call は廃止予定のレガシーな /v3/call サーフェスを利用します。 手早く試す用途には問題ありませんが、これを基に構築したり、アプリケーションコードにコピーしたりしないでください。これは response_format を使う互換チャットエンドポイントです（opper-api スキルとその references/migration.md を参照）。
• opper call の引数の順序は <function> <instructions> <input> です — 順序を間違えやすいので注意してください。
• モデル識別子には provider/<id-with-dashes> を使います（例：anthropic/claude-sonnet-4-6、anthropic/claude-opus-4-7、openai/gpt-4o）— バージョンであっても、ドットではなくハイフンを使います。opper models create で登録したカスタムモデルは LiteLLM を基盤としています。現在利用可能なモデルは opper models list または curl -s https://api.opper.ai/v3/models で一覧表示できます。
• opper usage list の --fields では count を指定できません。 cost と count は常に自動で含まれます。有効な --fields は total_tokens、prompt_tokens、completion_tokens です。
• スキルは ~/.claude/skills/ と ~/.codex/skills/ にインストールされます。 Codex のインストールでは、各スキルが ~/.codex/config.toml の管理対象 [[skills.config]] ブロックにも登録されます。
• 不足していた点は、ユーザーの了承を得て Opper に伝えてください。 途中で何か（モデル、ドキュメント、説明できなかったエラーなど）が不足していた、不明確だった、または誤っていた場合は、一般的なフィードバックとして送信することを提案し、ユーザーの同意を得てから送信してください。Opper MCP の send_feedback ツール、または POST https://agents.opper.ai/feedback に JSON の message を指定して送信できます（同じ URL への GET でフィールドを確認できます）。API キーは不要で、返信は送信されません。API キー、ユーザーのコード、個人データは決して含めないでください。

次に確認する場所

対象	参照先
インストール、エージェントの対応状況一覧、リリース、ライセンス	github.com/opper-ai/cli
引数とフラグの最新リファレンス	opper <command> --help
CLI の基盤となるプラットフォーム（互換エンドポイント、モデル）	opper-api スキル
エージェントを Opper ツールに接続し、モデルをテストする方法	opper-mcp スキル
アプリケーションコードに Opper を組み込む方法（/v3/compat の OpenAI／Anthropic／Google SDK）	opper-api スキル