--- title: "AIエージェントに話しかける例" description: "KUMODeckの使い方を覚える必要はありません。プロジェクトのフォルダ（Webアプリでもゲームでも）でAIエージェント（Claude Code・Codex・Cursorなど）を開き、自分の言葉で頼むだけです。" url: "/ja/docs/ask-claude-code/" lang: ja index: "/ja/llms.txt" --- # AIエージェントに話しかける例 KUMODeckの使い方を覚える必要はありません。プロジェクトのフォルダ（Webアプリでもゲームでも）でAIエージェント（Claude Code・Codex・Cursorなど）を開き、自分の言葉で頼むだけです。 どのテンプレートにも`AGENTS.md`が入っていて、KUMODeckの機能の足し方・破ってはいけない約束・次に打つコマンドをアシスタントに伝えます。このページは、そのままコピーして使える頼み方と、そのときアシスタントが裏で打つコマンドの一覧です。 いつもあなたの手元に残るのは2つだけです。**パスワードを打つこと**（`kumodeck signup` / `kumodeck login`をあなたのターミナルで）と、**支払うこと**（カードはStripeの画面であなたが入力）。それ以外は全部頼めます。 ## 最初に1回: 準備 ```sh npm install -g kumodeck kumodeck signup # これだけはあなたが打ちます。パスワードはアシスタントを通りません ``` 続けて前払いで入金します。無料枠がないので、使った分は前払い残高から原価で差し引かれます（[料金](/ja/docs/pricing/index.md#前払い残高)）。 ```text KUMODeckのアカウントに、前払いを最低額だけ入金して ``` ```sh kumodeck billing topup # 最低5ドル。Stripeの支払いURLを出して（開いて）、あなたが支払うと残高を表示します ``` アシスタントは支払いのURLを見せて待つだけで、カード情報は見ません。あとで「前払いの残高はあといくら？」と聞けば`kumodeck billing`を打ちます。デプロイが`402`で失敗したら残高を使い切っています。入金すれば、同じデプロイがそのまま通ります。 招待コードがあれば「この招待コードを使って」で`kumodeck billing redeem <コード>`を打ちます（招待クレジットは利用料だけに使えます。メールの確認が済むと入ります）。 会話の中から利用料やプロジェクトの様子を見たりするなら、MCPサーバーを1回つなぎます（[AIエージェントから使う（MCP）](/ja/docs/claude-code/index.md)。Codex・Cursorなども同じ頁にあります）。Claude Codeなら次のとおりです。 ```sh claude mcp add --transport http kumo https://mcp.kumodeck.com/mcp ``` ほかのエージェントでは、`https://mcp.kumodeck.com/mcp`を`kumo`という名前のMCPサーバーとして追加します（[その他のMCP対応エージェント](/ja/docs/claude-code/index.md#その他のmcp対応エージェント)）。 ## Webアプリを始める ```text KUMODeckでWebアプリの習慣トラッカーを作って。一人ひとりの習慣を保存して、どの端末でも続きから見られるように。スマホで試したいからKUMODeckでホスティングして ``` アプリのフォルダでアシスタントが打つコマンド（テンプレートは要りません）: ```sh kumodeck whoami # ログイン済み？ まだなら`kumodeck login`をあなたに頼みます kumodeck init # プロジェクトと鍵を作ります kumodeck features on saves # 一人ひとりのデータ（APIのplayer = あなたの利用者1人） kumodeck config push kumodeck deploy --env development # URLを表示します ``` アプリ本体は、アシスタントがいつものビルドの道具などで書き、ビルドしたフォルダをデプロイします。コードはあなたのもので、KUMODeckはバックエンドだけです。小さなアプリなら、設計の質問を並べて止まらずに、無理のない既定で作ってから、何を選んだかを1行で伝えます（変えたいときはそう言ってください）。答えは、あなたが使っている言葉で返します。 ## ゲームを始める ```text KUMODeckのphaserテンプレートでspace-dodgeという新しいゲームを作って、新しいプロジェクトにつないで ``` アシスタントが打つコマンド: ```sh kumodeck whoami # ログイン済み？ まだなら`kumodeck login`をあなたに頼みます kumodeck create space-dodge --template phaser --init ``` あとは好きなように作り変えます（「プレイヤーを宇宙船にして、隕石を足して」）。ゲームのコードはあなたのもので、KUMODeckはバックエンドだけです。 ## 公開する ```text スマホで試したいから、developmentにデプロイして ``` ```sh kumodeck config push # プロジェクトの設定（development） kumodeck deploy --env development # URL（…/space-dodge--dev/）を表示します ``` この最初のdevelopmentへのデプロイの直後に、1回だけ「本番（皆が見るアプリ）にも出す？」と聞きます。そのあとdevelopmentに出し直したとき（機能やDBを足したときなど）は聞き直しません。本番を新しくしたいときに「本番に出して」と言ってください。 ```text よさそう。本番に出して ``` ```sh kumodeck config push --env production kumodeck deploy --env production # 本番のアプリやゲーム。URLを表示します（--env を付けないと試し用の development） ``` ## Xに出す ```text Xでのシェアをオンにして、ゲームオーバー画面にスコアをシェアする「友だちに挑戦」ボタンを付けて ``` ```sh kumodeck share on # カード画像・共有リンク・投稿ごとの流入（両方の環境）。 に書くカード用のタグを出す ``` アシスタントは`kumo.share({ kind: 'challenge', score })`を呼ぶボタンを足し、届いた挑戦状をメニューに出します。続けて: ```text 告知ポスト用の計測リンクをちょうだい。明日、そこから何人来たか教えて ``` ```sh kumodeck share link "launch post" # Xに投稿するURL kumodeck share stats # リンクごとの訪問・新しい利用者・開かれた数 ``` 詳しくは[Xでのシェア](/ja/docs/guides/sharing/index.md)。 ## 機能を足す どれも頼むのは1回です。アシスタントは頼まれたことに要る機能だけをONにし（すべて既定OFF）、`kumo.config.json`を直し、SDKを呼び、developmentに反映して、何をONにしたかを伝えます。 | 頼み方 | やること | |---|---| | 「進み具合をクラウドにセーブして」 | `kumodeck features on saves` → `kumo.saves.set / get` | | 「自分の順位も出る、毎日リセットのハイスコアランキングを足して」 | ランキングのSkill（`.agents/skills/leaderboard/`。`.claude/skills/`にも同じもの）が、自分のデータベースと[Functions](/ja/docs/guides/functions/index.md)の上に、テーブル・スコアを受ける口・ゲームのコードを組み立てます。コードはあなたのもので、自由に変えられます | | 「Xでログインできるようにして」 | あなたが自分のXアプリを作り、キーをダッシュボードに貼ります（[手順](/ja/docs/guides/auth/index.md#自分のxアプリ)）。そのあと`auth.providers.x.enabled` → `kumo.auth.signInWithProvider('x')` | | ゲーム向け: 「オンラインで2人対戦にして」 | `kumodeck features on multiplayer` → `multiplayer.modes` → `kumo.rooms.quickMatch`（[マルチプレイ](/ja/docs/guides/multiplayer/index.md)） | | 「SQLのDBを使う自分のサーバーのプログラムがほしい」 | `kumodeck create api --template functions-starter` → `kumodeck functions enable` → `kumodeck functions deploy`（[Functions](/ja/docs/guides/functions/index.md)） | ## 直す ```text クラウドセーブがdevelopmentでは動くのに、本番だと失敗する。直して ``` ```sh kumodeck features --env production # productionでsavesがOFFなのを見つけます kumodeck config push --env production # 本番が変わるので、先にあなたに確かめます ``` CLIのエラーは次に打つコマンドを教えます（`--json`なら`hint`に入ります）。だからアシスタントはたいてい自分で直せます。設定の間違いは`multiplayer.modes.0.maxPlayers`のように場所を示して拒否されます。 ```text 新しい版が壊れてる。本番を1つ前の版に戻して ``` ```sh kumodeck deployments # * = 公開中 kumodeck rollback 4 ``` ## 費用を見る MCPサーバーをつないでいれば: ```text 先月インフラにいくら使った？ 前払いの残高はあといくら？ ``` アシスタントは`usage_get`（部品ごとの費用。原価）、`usage_daily`（日ごと）、`prepaid_get`（前払い残高）を使います。MCPなしなら`kumodeck usage`と`kumodeck billing`です。 ## アシスタントがしないこと - パスワードを打つ・聞く、アカウントを作る - 秘密鍵（`sk_…`）やログインの提供元の秘密を、コードや会話に書く - 利用者にKUMODeckの名前を見せる（「Powered by KUMODeck」を出さない） - 頼まれていない機能をONにする、黙って本番を変える - カード情報を入力する・代わりに支払う（見せるのはStripeの支払いURLだけ）