Kimiを実際に使う手順：ウェブでの質問・ファイル・プラグイン、Kimi Code（CLI・デスクトップ・VS Code）での作業、APIの呼び出しを、場面ごとに「何を開き、何を入力し、何が返るか」で並べる

3行でいうと

場面は8つです。ウェブで質問する、ファイルを渡す、文書ファイルを作らせる、プラグインを使う、Kimi Code CLIで作業する、Kimi Code Desktopで作業する、VS Codeで質問する、APIで呼ぶ。最後に「最初の1時間の順番」の案を付けました。
ウェブのKimiでは、新しい用件は「新建会话」で別の会話にする、長い会話は要点をまとめさせる、がヘルプの注意です。
Kimi Codeでは、読み取りだけの操作は自動で動き、ファイルの変更とシェルのコマンドは、実行の前に確認が出る、と公式にあります。
APIでは、返ってきた「アシスタントのメッセージ全体」を、次の要求にそのまま渡す必要があります。内容の文字だけを残すと、公式は誤りの例として挙げています。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はKimiを入れていますが、使い心地はこの記事には書いていません。手順は公式の手順を順に並べたもので、返事の中身は、公式の説明から読み取れる範囲でしか書いていません（実際の返事は、入れた内容で変わります）。指示文の例と、コードの例は、公式の記載に合わせて、この記事で組んだもので、動作は確かめていません。画面の表記は変わります。手元の画面と照らして読んでください。

先に結論

ウェブは、入力欄に書いて送る。 続きは同じ会話で、別の用件は新しい会話で。モデルは入力欄の上のボタンで変えます。
コードの作業は、読み取りから始める。 公式のDesktopのページは「まず読み取りの質問、次に小さな変更」の順を案内し、CLIのページも最初の例に読み取りの質問を挙げています。
変更や実行は、承認の画面で内容を見てから。 承認を自動にする設定の中身は、この記事の範囲では読んでいません。
APIは、呼び出しの形が公式の文書で決まっている。 固定されて指定できない設定がある、画像は公開URLで渡せない、という決まりを先に読んでおくと、やり直しが減ります。

前提：用語をそろえる

ターン／セッション：ヘルプの言い方で、1回のやり取りがターン、会話全体がセッションです。
プラグイン：外のツールをKimiにつなぐ部品です（くわしくは08）。
差分（diff）表示：ファイルのどこがどう変わるかを、前と後で並べて見せる画面です。
スラッシュコマンド：/ で始めて入力する、CLIの操作用の命令です。
ツール呼び出し（tool calling）：モデルが、あなたのプログラムの関数を呼ぶよう頼む仕組みです。実際に関数を動かすのは、あなたのプログラムです。
トークン：文章を処理する単位です（01）。

たとえ話：「相談」と「作業の依頼」

ウェブのKimiは、窓口での相談に近く、返事を見て、次の質問をします。Kimi Codeは、作業場に人を呼んで依頼する形に近く、読むだけの作業は任せ、道具を持ち出すとき（ファイルの変更、コマンド）は声をかけてもらいます。APIは、自分のプログラムの中から、決まった書式で依頼書を出す形です。これは僕らのたとえで、公式の表現ではありません。

場面1：ウェブで質問する

公式のヘルプ「開始使用 Kimi」の順です。

手順

ブラウザで kimi.com を開き、サインインします（05の節A）。
入力欄（ダイアログボックス）に、質問を書きます。この記事の例：

text 中学生にも分かるように、「APIキー」とは何かを3文で説明してください。

入力欄の上のモデル切替ボタンで、モデルを確かめます。ヘルプの説明では、K2.6は速い質問と会話向け、K3は会話とエージェント作業向け、K3 集群は大量の検索や一括処理向けです。
送信します。期待される結果は、返事の文が会話に表示されることです。
続きを聞くときは、同じ会話の入力欄に書きます。この記事の例：

text いまの説明を、手紙にたとえて言い直してください。

別の話題に移るときは「新建会话」を押します。ヘルプは、前の文脈が新しい用件の邪魔をしないよう、用件ごとに会話を分けるよう書いています。

公式が挙げる、使えるもの

ヘルプによると、設定なしで使える道具として、ウェブ検索（Web Search）、ページの取得（Fetch Tool）、画像検索（Image Search）、Pythonの実行（IPython）、記憶（Memory）があります。出力の形は、テキスト、Markdown、コードブロック、JSON、Mermaidの図、LaTeXの数式が挙げられています。どの場面でどの道具が動くかは、画面や設定で変わるため、返事に出た表示を見て確かめてください。

長い会話のとき

ヘルプは、長い会話では、要点をまとめさせて情報が抜ける危険を減らす、と書いています。この記事の例：

ここまでの会話の決まったことを、箇条書きで5つにまとめてください。

まとめを確かめたら、新しい会話にその箇条書きを貼って続ける、という進め方もあります（これは僕らの見立てです）。

場面2：ファイルを渡して質問する

手順

ウェブの入力欄から、ファイルを選んでアップロードします（アップロードの操作の表示は、取得したヘルプには書かれていません。手元の画面で確かめてください）。
公式のヘルプが挙げる、渡せるものは次のとおりです。

種類	形式
画像	PNG、JPEG、WebP、GIF
動画	MP4
文書	PDF、Word、Excel、TXT、Markdown
オンラインの資料	URLで渡す

指示を書きます。この記事の例：

text 添付した資料の要点を、見出しごとに3行で書いてください。分からない箇所は「不明」と書いてください。

期待される結果は、資料の内容にもとづく返事です。返事が資料のどこから来たのかは、確かめてください（AIの返事は、誤ることがあります）。

ファイルの大きさと数の上限は、公式の資料で数字が食い違う所があります（01の「気をつけること」）。上限に当たったときは、公式のヘルプで最新の数字を見てください。

場面3：文書ファイルを作らせる

ヘルプは、K3は編集できるファイル（.pptx、.docx、.xlsx、.pdf）を作れる、K2.6は主にテキストの出力、と書いています。

手順

入力欄の上のモデルを、K3にします（K3で作れるとヘルプにあるため）。
作りたいものを書きます。この記事の例：

text 新入社員向けに、会議室の予約のしかたを説明する5枚のスライドを作ってください。1枚に伝えることは1つにしてください。

期待される結果は、ファイルが作られることです。ファイルの受け取り方（どこに出るか、どのボタンで保存するか）は、取得したヘルプには書かれていません。スライドやドキュメントなどの機能の説明は、02を参照してください。
作られたファイルは、自分で開いて、内容を確かめます。

場面4：プラグインを入れて使う（ウェブ・アプリ）

公式のヘルプ「Kimiプラグインとは」の順です。くわしい種類と権限は08に書きました。

手順

サインインしていることを確かめます。公式は、サインインしていないとプラグインは入れられず、使えない、と書いています。
入力欄の「+」を押すか、入力欄で「/」を打ちます。モバイルも同じ操作です。
マーケットで探すか検索し、プラグインの詳細を開いて「Install」を押します。
サービスによっては、OAuth（ブラウザで本人確認して権限を渡す方式）のサインインが出ます。何に権限を渡すかを読んでから、許可します。
使うときは、「/」か「+」から「Plugins」を選んで呼び出します。また、必要なことを文で書くと、Kimiがプラグインを選ぶこともあります。使われたときは、返事に「Using the xx plugin」の形の表示が出る、と書かれています。
外すには、アンインストールするか、権限を取り消します。アンインストールするとOAuthの権限も取り消されるので、再び使うには入れ直して許可し直します。

使える範囲は、K3とK3 Swarmのモデル、Deep Research、Build、PPTの場面、Kimi Workのデスクトップ、と公式にあります。Kimi Clawの会話とKimi Plusの会話では対応しない、と書かれています。プラグインによっては、会員のクレジットを使います。

場面5：Kimi Code CLIでプロジェクトを読ませ、小さく変更する

手順（公式の順）

作業するフォルダに移って、kimi を起動します。

sh cd your-project kimi

サインインしていなければ、/login（05の節D）。
最初の指示は、読み取りの質問にします。この記事の例：

text このプロジェクトのディレクトリ構成を見て、各ディレクトリの役割を短く説明してください。

公式の例も同じ趣旨です。読み取りだけの操作は、自動で動きます。 4. 次に、小さな変更を頼みます。この記事の例：

text README.md の先頭に、このプロジェクトの目的を1行で書き足してください。

ファイルの変更に当たると、確認が出ます。内容を読んで、承認か拒否を選びます。公式は、ファイルの変更とシェルのコマンドは確認が要る、と書いています。
結果を、自分でファイルを開いて確かめます。

続ける・整える（公式のスラッシュコマンド）

やりたいこと	操作
別の用件にする	`/new`（文脈を消す）
前の会話を見て、再開する	`/sessions`。起動時に前回の続きは `kimi -c`
文脈が長くなった	`/compact`（圧縮してトークンを空ける）
いまの会話を、履歴ごと複製して別の方向を試す	`/fork`
モデルを替える	`/model`
一度だけ指示して終える	`kimi -p "..."`
コマンドの一覧	`/help`

画面外から使う場合

IDEから動かす kimi acp、MCPでツールを足す、スキルで手順を教える、は08にあります。

場面6：Kimi Code Desktopで作業する

公式のDesktopのQuick Startの順です。

手順

Desktopを起動します。サインインします（05の節C）。
「New session」を押します。
入力欄（Composer）の上のフォルダ名を押し、「Choose folder…」などから作業のフォルダを選びます。選んだ場所が入力欄の上に出ていることを確かめます。
承認の方式を確かめます。公式は、最初のセッションには「Always Ask」を選ぶよう書いています。
読み取りの質問を送ります。この記事の例：

text このフォルダの構成をまとめてください。変更はしないでください。

次に、小さな作業を頼みます。この記事の例：

text hello.txt というファイルを作り、中に「こんにちは」と書いてください。

承認のカードが出たら、コマンドやファイルを見て、承認か拒否を選びます。
作ったファイルが「Changes」パネルに出ること、コマンドの出力が会話に出ることを確かめます。ターミナルのパネル（Ctrl + `）でも、同じコマンドを動かせます。

場面7：VS Codeで、コードを指して質問する

手順（公式のVS Codeの順）

VS Codeでフォルダを開きます（拡張はワークスペースが必要）。
Ctrl+Shift+K（MacはCmd+Shift+K）で、Kimiの入力欄を開きます。
@ を打って、ファイルかフォルダを指定します。この記事の例：

text @src/main.py の処理の流れを、順番に説明してください。

変更案が出たら、差分表示で見ます。公式は、確認してから反映され、元に戻せる、と書いています。
返事がないときの確認点は、05の節Eのとおりです。

場面8：APIで呼ぶ（OpenAI互換）

呼び出し先と準備は05の節F。ここでは、呼び出しのときに公式が決めていることを、場面ごとに並べます。

8-1 いちばん短い呼び出し（curl）

この記事で組んだ例です（公式の概要のページのcurlの形に合わせました。動作は確かめていません）。

curl https://api.moonshot.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MOONSHOT_API_KEY" \
  -d '{
    "model": "kimi-k3.1-pro",
    "messages": [
      {"role": "user", "content": "1+1はいくつですか。数字だけで答えてください。"}
    ]
  }'

期待される結果は、JSONで返事が返ることです。返事の文は choices の中のメッセージにあります（OpenAIのSDKの例では completion.choices[0].message.content）。

8-2 思考の強さを変える

K3系は、思考がつねにオンで止められません。強さは、トップレベルのフィールド reasoning_effort で決めます（low、high、max。既定は max）。公式のK3クイックスタートは、返事に時間がかかるときは low にする、と書いています。

8-3 指定してはいけない設定

K3については、temperature=1.0、top_p=0.95、n=1、presence_penalty=0、frequency_penalty=0 が固定で、要求に入れないよう、公式が書いています。max_completion_tokens の既定は131072、上限は1048576です。

8-4 続きの会話（マルチターン）

公式の決まりは、返ってきたアシスタントのメッセージ全体を、次の要求の履歴にそのまま足すことです。文字だけを残して、思考などの部分を落とすと、誤りの例になる、と書かれています。この記事の骨組みの案（動作は確かめていません）：

messages = [{"role": "user", "content": "最初の質問"}]
r = client.chat.completions.create(model="kimi-k3.1-pro", messages=messages)
messages.append(r.choices[0].message)   # メッセージ全体を足す
messages.append({"role": "user", "content": "続きの質問"})
r2 = client.chat.completions.create(model="kimi-k3.1-pro", messages=messages)

8-5 画像を渡す

公開URLでは渡せません。base64のデータURL、またはアップロードしたファイルの ms://<file-id> で渡します。
画像を渡すとき、content は文字列ではなく、オブジェクトの配列にします。
動画は、client.files.create(..., purpose="video") でアップロードし、ms://<file-id> で参照する、と書かれています。

content の中の細かい書き方（image_url の形など）は、取得した要約には含まれていませんでした。公式の画像入力のガイドで確かめてください。

8-6 ツール呼び出し

公式のクイックスタートの要点は次のとおりです。

モデルがツールの呼び出しを返したら、それぞれに対応する tool_call_id を付けた tool メッセージを、履歴に足します。
動的に読み込んだツールの定義は、サーバーが覚えていません。後の要求の履歴にも、定義を含めます。

8-7 公式が「いまは勧めない」と書くもの

K3のウェブ検索は、更新中で、本番向けにはいまは勧めない、と公式のクイックスタートにあります。

8-8 Anthropic形式で呼ぶ

Anthropic互換のMessages APIは、https://api.moonshot.ai/anthropic の下の POST /anthropic/v1/messages で、max_tokens が必須です。くわしい手順と、Claude Codeなどからの使い方は07にあります。

最初の1時間の順番（この記事の案）

「この順で試すと、迷いにくいのではないか」という、この記事の案です。公式が示す順番ではありません。

時間の目安	やること	参照
最初の10分	入口を決める。ウェブなら kimi.com を開き、短い質問を1つ送る	05の節A、場面1
次の10分	モデル切替ボタンで、モデルの違いを画面で確かめる。新建会话で別の話題を試す	場面1
次の10分	自分のファイルを1つ渡して、要点をまとめさせる。返事を原文と見比べる	場面2
次の15分	コードを書く人は、Kimi CodeをCLIかDesktopで入れ、読み取りの質問、小さな変更の順に	05の節C・D、場面5・6
最後の15分	APIを使う人は、キーを作って環境変数に置き、curlで1回呼ぶ。つなぎ先のツールがあれば07へ	05の節F、場面8

誤解されやすい点

「ウェブのKimiとKimi Codeは同じ画面」ではない。 別の製品で、入れ方も、承認の仕組みも別です（01、05）。
「返事が出たから正しい」ではない。 返事は、元の資料と見比べてください。
「APIでもウェブと同じ設定が使える」ではない。 K3では、指定できない設定があります（場面8-3）。
「画像はURLを貼れば渡せる」ではない。 公開URLは使えず、base64かファイルIDです（場面8-5）。

気をつけること

この記事は、実際に使って確かめた記録ではありません。運営者はKimiを入れていますが、使い心地はこの記事には書いていません。公式の資料を、2026年10月25日に読んだ範囲です。
例の指示文とコードは、すべてこの記事で組んだものです。そのまま動くとは限りません。
ウェブでのファイルの受け取り方、アップロードのボタンの表記、承認を自動にする設定の中身、Agent・Deep Research・PPT・Buildなどの各機能のヘルプは、この記事では読んでいません（02と、公式のヘルプを参照）。
入力した内容が、学習に使われうること、中国本土のサーバーに保管されることは、01と04にあります。機密の情報や、他人の個人情報は、入れる前に考えてください。
ファイルの変更やコマンドの実行は、承認の画面で内容を読んでから許可してください。公式のプラグインのページは、Kimi Computer Use（デスクトップのアプリを操作するプラグイン）について、お金、アカウント、公開に関わる作業は任せないよう書いています（08）。
価格や上限は変わることがあります。購入の前に、公式の料金のページで確かめてください。