# エージェントプラグイン Source: [エージェントプラグイン]() Documentation index: [llms.txt]() Last updated: 2026-10-20 現在の ChatCut Agent Plugin は、Claude Code、Codex、WorkBuddy から ChatCut のプロジェクトを作成・編集するためのプラグインです。ホスト型の接続を使い、認可はエージェントが開くブラウザー画面で行います。公開 npm パッケージ `@chatcut/skill` v0.2.1 の CLI は、下で説明する別の導入方式です。 ## 現行プラグインの対応アプリ | デスクトップアプリ | インストールの開始方法 | | --- | --- | | **Claude Code** | ChatCut のアバターメニューで **Agent Plugin → Claude Code → Copy** を選択 | | **Codex** | ChatCut のアバターメニューで **Agent Plugin → ChatGPT/Codex → Copy** を選択 | | **WorkBuddy** | [WorkBuddy の専用インストールガイド](https://chatcut.io/workbuddy)に従う。アバターメニューに WorkBuddy 用の Copy ボタンはありません | この手順はデスクトップのエージェントアプリで使います。Claude や ChatGPT の Web サイト、ChatCut の Web エディターにインストール指示を貼り付ける手順ではありません。 ## 現行プラグインのインストールと認可 1. ChatCut の Web アプリにサインインし、アバターメニューの **Agent Plugin** から、使うアプリの **Copy** を選びます。 2. 対応するデスクトップアプリで新しい会話またはタスクを開き、コピーした指示を貼り付けて送信します。WorkBuddy は専用ガイドに従ってください。 3. エージェントが開く ChatCut の認可ページでサインインし、アクセスを許可します。Cookie、アクセストークン、パスワードをエージェントの会話に貼り付けないでください。 4. インストール後は新しい会話またはタスクを開始し、ChatCut を使ってどのように編集したいかを伝えます。ツールはセッション開始時に読み込まれるため、インストール中の会話に後から追加されるわけではありません。 Claude Code の新しい会話に送る指示： Command ```sh /goal Read chatcut.io/claude to install and use the ChatCut plugin ``` Codex デスクトップアプリの新しいタスクに送る指示： Command ```sh /goal Read chatcut.io/chatgpt to install the ChatCut plugin and set up a new task for me. ``` WorkBuddy では上の2つの指示を流用せず、専用ガイドの手順を使います。接続エラーで認可ページが開かない場合と、開いた後に認可が中断された場合は段階を分けて扱ってください。現行プラグインの更新方法と接続の問題は、[現在の英語版ガイド](https://pr-558-preview.chatcut.dev/docs/agent-plugin#common-installation-problems)で確認できます。 ## 別方式：公開 npm CLI v0.2.1 公開 npm パッケージ `@chatcut/skill` v0.2.1 は、`chatcut` CLI と Claude Code 向けのスキル登録を提供する別方式です。以下はこの公開 CLI バージョンの説明です。現行の Claude Code / Codex / WorkBuddy プラグインのインストールには、上の手順を使ってください。 ### インストール方法 `npm install -g @chatcut/skill`を実行してから（`pnpm add -g`や`yarn global add`でも同じように動作します）、Claude Codeを再起動します。グローバルインストールが必須です。スキルはPATH上の`chatcut`バイナリをそのまま呼び出すため、`npx @chatcut/skill submit`では動作しません。インストール時のpostinstallステップがSKILL.mdを`~/.claude/skills/chatcut/SKILL.md`にコピーし、Claude Codeがスキルを自動的に読み込みます。この登録はベストエフォートで、失敗してもnpmインストール自体は成功します。インストール後もClaude Codeがスキルを認識しない場合は、`chatcut install`を実行して手動で登録してください。 ### 動作要件 `chatcut`CLIにはNode.js 18以降が必要です（package.jsonの`engines.node >=18`）。 ### CLIでできること `chatcut`コマンドには9つのサブコマンドがあります。`install`（`--link`オプション付き）、`update`、`login`、`logout`、`pick`、`submit`、`status `、`watch `、`help`です。中心になるのは`submit`で、必須の`--prompt `と、繰り返し指定できる1つ以上の`--asset `（typeは`audio`、`gif`、`image`、`video`のいずれか）を受け取り、さらに任意で`--name `、`--resolution <480p|720p|1080p>`、`--format `、`--codec `、`--max-turns `、`--model `を指定できます。素材のパスが手元にない場合は、`chatcut pick`でネイティブのファイル選択ダイアログが開き、`submit --asset`にそのまま渡せる`path:type`形式の行が出力されます。 ### `chatcut submit`が動画を作成する仕組み `submit`にプロンプトとメディアを渡すと、パイプライン全体が自動で走ります。編集内容を普通の言葉で説明し、素材は公開URLかローカルの絶対パスで指定します。どちらもまったく同じように扱われます。CLIがローカルでトランスコードしてアップロードし、ChatCutのエージェントがサーバー側でタイムラインを組み立て、クラウドで動画がレンダリングされ、署名付きのダウンロードURLが返ります。`--resolution`と`--format`を指定しない場合、CLIは1080pの動画を既定とする書き出し指示をプロンプトの末尾に自動で追加します。ジョブの送信は有料の操作なので、エージェントが送信前に文言を変えた場合は、いったん処理を止めて実際の`--prompt`テキストを提示し、承認を求めることが義務付けられています。 ### 所要時間と進捗の確認方法 `chatcut submit`はジョブが完全に終わるまで戻りません。トランスコード、アップロード、エージェントの編集ループ、クラウドレンダリングのすべてが終わってから終了し、その間ずっと読みやすい進捗をstderrに出力し続けます。内部的には3秒ごとにジョブの状態をポーリングし、40分以内に終わらない場合はタイムアウトエラーで打ち切ります。 ### 生成結果の保存先 `chatcut submit`は実行のたびに新しいChatCutプロジェクトを作成し（`--name`で名前を指定するか、既定の名前をそのまま使います）、実行が終わった時点でそのプロジェクトの`projectId`、ジョブの`jobId`、レンダリング済みファイルの署名付き`outputUrl`を、標準出力に1行のJSONとして出力します。 ### `chatcut login`の要否 必要ありません。保存済みのAPIキーが見つからない場合は、`submit`が自動でブラウザーを開いてログイン画面を表示し、完了後そのままジョブを続行します。そのため、初回のsubmitの前に`chatcut login`を別途実行する必要はありません。このログインではChatCutのログインページを開いたブラウザーウィンドウが表示され、承認するとCLIが裏側でその結果を長期有効なAPIキーと交換します。フロー全体は未完了のまま5分経過するとタイムアウトします。 ### 「Codexプラグイン」との違い `@chatcut/skill` v0.2.1 が自動登録するスキルの保存先は `~/.claude/skills/chatcut` です。この登録方式は、現行の Codex プラグインの導入とは異なります。Codex で現行プラグインを使う場合は、上の[現行プラグインのインストールと認可](https://pr-558-preview.chatcut.dev/ja/docs/agent-plugin#%E7%8F%BE%E8%A1%8C%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%A8%E8%AA%8D%E5%8F%AF)に従ってください。 関連情報：[ChatCutエディターの画面構成](https://pr-558-preview.chatcut.dev/ja/docs/editor-overview)。 ### ChatCutエージェントプラグインのインストールとログイン `npm install -g @chatcut/skill`でこのCLIをグローバルにインストールし（`pnpm add -g`や`yarn global add`でも同じように動作します）、Claude Codeを再起動します。Node.js 18以降が必要です。インストールすると`SKILL.md`が`~/.claude/skills/chatcut/`に登録され、Claude Codeがスキルを自動的に読み込みます。（`--ignore-scripts`を使った場合など）この登録が行われなかったときは、`chatcut install`を実行して手動で登録します。グローバルインストールが必須で、Claude Codeの中から`npx @chatcut/skill`を使うことはできません。 ログインを別の手順として済ませておく必要はありません。最初の`chatcut submit`を実行するとブラウザーが開いてPKCEベースの認可交換が始まり、完了しないまま5分経過するとタイムアウトします。先にログインしておきたい場合は、`chatcut login`を実行してください。 関連情報：[ChatCutへのログイン方法](https://pr-558-preview.chatcut.dev/ja/docs/sign-in-and-account#chatcut%E3%81%B8%E3%81%AE%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3%E6%96%B9%E6%B3%95)。 ### ChatCutエージェントプラグインでできることと制限 `@chatcut/skill` v0.2.1 の `chatcut` CLI は、プロジェクトの作成、メディアのアップロード、自然言語によるAI編集ジョブの実行、署名付きダウンロードURLの返却までを1つのコマンドでまとめて行います。`chatcut submit`にはプロンプトと素材（URLまたはローカルファイルパス）を渡します。コーデックがブラウザー互換でない場合、フレームレートが30fpsを超える場合、ビットレートが8Mbpsを超える場合にだけローカルでトランスコードし、長辺を1920pxに収めます。それ以外はファイルを手を加えずにアップロードします。その後はChatCutのサーバー側エージェントによる編集とクラウドレンダリングが終わるまで処理をブロックし、進捗をstderrに、最終的な`jobId`／`projectId`／`outputUrl`のJSON行をstdoutに出力します。 制限：submitは3秒ごとにポーリングし、40分でタイムアウトします。`chatcut status `はジョブの状態を1回だけ確認し、`chatcut watch `は最大20分間ポーリングします。CLIは24時間ごとに新しいバージョンの有無を確認し（結果はキャッシュされます）、知らせるだけでコマンドをブロックすることはありません。 関連情報：[ChatCutエージェントプラグインのインストールとログイン](https://pr-558-preview.chatcut.dev/ja/docs/agent-plugin#chatcut%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%A8%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3)。