# エージェントプラグイン Source: [エージェントプラグイン]() Documentation index: [llms.txt]() Last updated: 2026-07-13 ChatCutエージェントプラグインは、公開npmパッケージ`@chatcut/skill`（現在はv0.2.1）です。「chatcut」という名前のClaude Codeスキルと、テキストプロンプトと素材のURLまたはローカルファイルパスのリストからAI編集済みの動画を作成するコマンドラインツール`chatcut`をインストールします。 ## インストール方法 `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`はClaude Code専用のスキルで、CLIは`~/.claude/skills/chatcut`に登録され、パッケージのどこにもOpenAI Codexと連携する仕組みはありません。 関連情報：[ChatCutエディターの画面構成](https://pr-444-preview.chatcut.dev/ja/docs/editor-overview)。 ## ChatCutエージェントプラグインのインストールとログイン `npm install -g @chatcut/skill`でプラグインをグローバルにインストールし（`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-444-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エージェントプラグイン（Claude Codeスキルである`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-444-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)。