手順を書いてモデルに渡す方法は、もうご存じのはずです。ここで新しいのは、その実行がノートパソコン上ではなく、クラウドで、チームの実際のアカウントに対して、トリガーをきっかけに、チームメイトの前で行われることです。
なので、案内は飛ばしてください。すでに作ったもののほとんどは、ここに居場所があります — 名前が違うだけです。
| 今あるもの | Okou ではこうなる |
|---|---|
CLAUDE.md / AGENTS.md | My Okou の個人用 Instructions。Legacy Agents では選択したエージェントの Instructions |
スキル / SKILL.md | 再利用可能な手法のための ワークフロー |
| 自分で実行している MCP サーバー | ワークスペースで MCP が有効な場合の カスタムコネクター |
| シェル内の API キーと環境変数 | コネクター — シークレットはモデルの外に置かれます |
cron とノートパソコン上のスクリプト | ワークフロー上の 自動化 |
| ターミナルタブを増やすこと | ワークスペースごとに購入する、より多くの同時実行 |
| あなたの Claude または Codex サブスクリプション | そのままあなたのもの — Settings → Models で接続します |
まずは、推論に対して二重に課金されることと、すでにあるものを書き換えることにつながる 2 つを取り除くことから始めます。
どの体験を使っていますか？
このドキュメントは両方の体験を扱います。Settings → Personal → My Okou が利用できる場合は、My Okou の手順に従ってください。New agent のある Agents ページを使っている場合は、Legacy Agents の手順に従ってください。利用可否はメンバーごとに異なる場合があります。これらのドキュメントは、あなたの体験を変更しません。
どちらの体験でも、複数のチャットやタスクを同時に実行し、ワークフローを再利用し、レビュー済みの作業をチームと共有できます。ランタイムのサブエージェントは実行ツールであり、作成する必要のある別の製品プロフィールではありません。
1. すでに料金を支払っているサブスクリプションで実行する
Okou は、プロバイダーのアカウントが対応していれば、Free プランおよび有料プランで、自分の Claude または Codex アカウント経由でモデル呼び出しをルーティングできます。
これには 2 つの側面があり、担当する人も異なります。
管理者がルートを選ぶ
Settings → Models で、ワークスペースの管理者が各モデルの提供方法を決めます。選択肢の 2 つは次のとおりです。
- Claude subscription — 各メンバーが自分の Pro、Max、または Team プランを接続します。
- Codex subscription — 各メンバーが自分の Pro または Team プランを接続します。
ルートを決めるのはポリシーであり、モデルピッカーではありません。そのため、あるモデルがこれらのいずれかに設定されていない場合、あなたの個人接続がそのモデルを提供することはありません。
自分のアカウントを接続する
Settings → Models の Personal セクションでは、自分の資格情報で、自分の実行でのみ使われます：
- Claude Code OAuth — Claude ベースのモデルルートには Claude Code ログインで接続します。Okou が Claude の承認ページを開くので、そこで Okou を承認し、表示された認可コードをコピーしてダイアログに貼り付けます。
- ChatGPT (Codex) — Codex のデバイスログインで接続します。Okou がデバイスコードをコピーし、承認ページを開きます。OpenAI にコードを貼り付けてアクセスを承認し、Okou が接続を完了するまでダイアログを開いたままにしてください。
プロバイダーごとに複数のアカウントを接続して、1 つをアクティブにできます。接続すると、アカウントメニューに各サブスクリプションの残り時間が表示されます — 5 時間のウィンドウと週次のウィンドウ — そのため、長い実行が限界に達する前に、制限が近いことを確認できます。
始める前に知っておくことが 3 つあります。
- Free プランと有料プランの両方で、自分のプロバイダーを持ち込めます。プロバイダーのアカウントは、選択したルートをサポートしている必要があります。
- 無料の ChatGPT プランは Okou 経由で Codex を使えません。Plus または Pro が必要です。
- モデルがどのルートを通っても、ツール呼び出し、生成、保存は引き続き Okou クレジットに課金されます。サブスクリプションがカバーするのは「考えること」であって、「実行すること」ではありません。
チャット作成欄の横にあるモデルピッカーは モデル を選びます。ポリシーによってそのモデルに割り当てられた ルート を上書きすることはありません。モデルはエージェントでもワークフローでもなく、チャットスレッド上に存在します — モデル を参照してください。
2. スキルをワークフローとして持ち込む
あなたが skill と呼ぶものを、Okou では ワークフロー と呼びます。つまり、適用場面を示す説明、作業の進め方を示す指示、そして任意のファイルを同梱した、名前付きの手順です。あなたがすでに書いた SKILL.md は、ほぼ一行ずつそのままワークフローの指示です。
移行する最速の方法は、チャットでそのまま渡すことです。書き直す必要も、実行する必要もありません。
- ファイルをそのまま入れる。
SKILL.mdを、近くに置いてあったチェックリスト、テンプレート、参照ファイルと一緒に、チャットへ直接ドラッグします。 - または Okou にリンクを渡す。 skill フォルダの GitHub URL を貼り付けると、Okou が全体を自分で読み取ります。
そのうえで、どうしてほしいかを伝えます。
「これが Claude Code で使っている skill です。これをこのワークスペースで private Workflow にしてください。手順はそのままにして、ローカルのファイルパスとシェルの手順を connectors に置き換え、まだ到達できないものを教えてください。」
Okou はファイルを読み取り、名前、description、instruction を下書きし、保存する前に結果を表示します。
移行する際に修正するとよい 4 つの違い
- My Okou のワークフローはワークスペース内に存在します。 非公開ワークフローはあなたに属し、公開ワークフローはワークスペース内で共有されます。Legacy Workflows は引き続き 1 つの Agent に紐づきます。実行時には、あなた自身が接続したアカウントと権限が使用されます。ローカルシェルのアクセス権は引き継がれません。ツールが利用できない場合は、実際の接続先と、付与された名前付き権限を確認してください。
- 名前は小文字のスラッグです —
triage-bug-report、2 文字以上 64 文字以下です。ワークフローが利用可能なチャットでは、/triage-bug-reportを使って明示的に呼び出すことも、作業内容をそのまま説明して Okou に説明文との一致を任せることもできます。ワークフローが自動的に起動するかどうかは、正確な説明文にかかっています。 - 新しいワークフローは既定で非公開です。 ワークスペースに対して 公開 にするには、保存の副作用ではなく、明示的な操作が必要です。My Okou では、同名の非公開ワークフローが公開版より優先されます。Legacy Agents では、所有元の Agent の公開範囲も確認してください。
- 認証情報は引き継がれません。 ローカルのスキルで環境変数やキーとして扱っていたものは、代わりに コネクタ に置き換えます。これにより、シークレットはプラットフォーム上に保持され、モデルの手の届かない場所に置かれます。適したファーストパーティ製コネクタがない場合は、キーを指示に貼り付けるのではなく、カスタムコネクタ を作成してください。
そのまま引き継がれるものが 1 つあります。それは補助ファイルです。テンプレート、チェックリスト、ブランドガイドライン、参照データは、あなたの SKILL.md の横に置いていたのと同じようにワークフローに添付できます。
個人用 Instructions とタスク手順を分ける
スキルはワークフローになります。My Okou では、個人の設定や好みは Settings → Personal → My Okou → Instructions に記述し、このワークスペース内の自分に対してのみ適用されます。再利用できるチームのルールや作業手順は、ワークスペースのワークフローに入れます。個人用 Instructions を保存しても、影響するのは Okou が次に開始する作業であり、すでに進行中の作業には適用されません。Legacy Agents では、代わりに選択した Agent の Instructions を編集してください。
Legacy Agents のみ:
保存する前に、個人の好みと再利用可能な手順を分けるよう Okou に依頼してください。個人の Instructions はワークスペースのポリシーにはならず、アカウント権限を変更することもできません。
3. そのあと、ローカル CLI にはない部分を使う
モデルのルートと手順が整ったら、Okou の残りはノートパソコンではできない部分です。
- コネクター — エージェントが読み書きできる認可済みサービスで、資格情報はネットワーク境界に保持され、すべての呼び出しが実行ログに表示されます。これは、シェルプロファイルに山ほど入っている個人用アクセストークンの置き換えです。
- カスタムコネクタ — ファーストパーティの connector がない内部 API 向けです。管理者が HTTPS プレフィックスと認証を一度登録します。ワークスペースで有効になっている場合、Streamable HTTP の MCP エンドポイントも同じ方法で登録できるため、すでに Claude Code に公開しているサーバーにもここから到達できます。
- Concurrent runs — ワークスペースの次元として追加でき、開きっぱなしにしたことを覚えておく必要がある 2 つ目のターミナルタブではありません。長いジョブが短いジョブを待たせることはなくなります。
- オートメーション — ワークフローに付けるトリガーです。スケジュール、新しいメール、マージされた pull request、カレンダーイベント、webhook などがあります。これは、手順を「思い出して実行するコマンド」ではなく、チームメイトに変える部分です。
- Instructions and experience modes — My Okou の個人設定と、分離された legacy Agent プロフィールのガイダンスを保持します。
- インテグレーション — 1 台のマシン上の 1 つのターミナルからではなく、Slack、Telegram、または web から到達できる同じ agent です。
4. dotfile に置いたままにせず共有する
ローカル環境との本当の違いは、あなたが作ったものを他の人が使えることです — ターミナルを開くことのない人も含めて。
- My Okou: レビュー済みの公開ワークフローを共有します。Legacy Agents: さらに、そのワークフローを所有する Agent も公開にします。
- その前に、指示文やファイルから認証情報と一時的なデータを取り除いてください。
- Settings → People → Add member からチームメンバーを招待します。既定の役割は Member です。チームメンバーを招待する を参照してください。
- 各メンバーは、それぞれ自分のアカウントと自分の Claude または Codex のサブスクリプションを接続します。ログイン情報を共有することはありません。
新規ユーザー向け の手順 3 から 6 では、個人の Instructions（または従来のエージェントの設定）、ワークフローの共有、スケジュール設定について、より詳しく説明しています。仕組みは同じで、違っていたのは最初の出発点だけです。
