Kimi Code CLI Windows インストールチュートリアル: ログイン、MCP、ACP、および古い Kimi CLI からの移行

Moonshot AI は、レガシー Kimi CLI を新世代の Kimi Code CLI に移行しています。新しいバージョンは、コードの読み取りと変更、シェルの実行、ファイルの検索、Web ページへのアクセスが可能なターミナル AI プログラミングエージェントで、MCP、プラグイン、サブエージェント、フック、ACP エディターへのアクセスをサポートします。

プロジェクトアドレス：MoonshotAI/kimi-code

Windows クイックインストール

まず、Git for Windows をインストールします。 Kimi Code CLI は、Windows 上のシェル環境として Git Bash を使用し、PowerShell で公式のインストールスクリプトを実行します。

1

irm https://code.kimi.com/kimi-code/install.ps1 | iex

ターミナルを閉じて再度開き、バージョンを確認します。

1

kimi --version

Git Bash がカスタムディレクトリにインストールされている場合は、KIMI_SHELL_PATH を bash.exe の絶対パスに設定する必要があります。

ログインして初めて実行する

プロジェクトディレクトリに入ってから開始します。

1
2


cd C:\Work\your-project
kimi

初めて実行するときは、インタラクティブインターフェイスに /login と入力すると、Kimi Code OAuth または Moonshot AI オープンプラットフォーム API キーを選択できます。ログイン後、まず読み取り専用タスクを使用して以下を確認します。

1

读取这个项目，说明主要目录和启动入口，不要修改文件。

パスの識別が正しいことを確認した後、小規模な変更のタスクを与えます。

古い Kimi CLI を移行する方法

公式の手順では、Kimi Code CLI をインストールすると古い構成とセッションが自動的に移行され、古いリポジトリは徐々にメンテナンスを停止することが示されています。移行前に、元の構成ディレクトリをバックアップし、カスタムプロバイダー、MCP サーバー、およびワークスペースのパスを記録することをお勧めします。

移行後の主要なチェック:

kimi --version が新しいバージョンを指しているかどうか。
/login ステータスが有効かどうか。
MCP サービスが引き続き接続できるかどうか。
古いセッションを開くことができるかどうか。
Git Bash とプロジェクトのパスは正しいですか?

MCP と ACP の違いは何ですか

MCP は、外部ツールとデータソースをエージェントに追加するために使用されます。新しいバージョンは、/mcp-config を通じて会話形式で構成できます。 ACP を使用すると、Zed や JetBrains などのエディターが Kimi Code CLI セッションを直接起動できます。

ACP サービスコマンドは次のとおりです。

1

kimi acp

ACP を使用する前に、端末で /login を一度完了する必要があります。エディター設定はプロセスの開始のみを担当し、API キーをプレーンテキストでプロジェクトリポジトリに書き込むべきではありません。

インストールスクリプト実行前の確認方法

PowerShell の irm ... | iex は、ネットワークから返されるコンテンツを直接実行します。より安全な方法は、インストールスクリプトをブラウザで開くか、ダウンロードして実行前に確認することです。ハイライト:

ダウンロードソースが code.kimi.com かどうか。
バイナリはどのディレクトリにインストールする必要がありますか?
PATH の変更方法;
シェル設定を記述するかどうか。
アップグレードおよびアンインストールの方法。
管理者権限を必要とするかどうか。

企業のコンピューターは、エンドポイントセキュリティポリシー、エージェント、および Windows のインストールソースの Git も確認する必要があります。システム保護をインストールするために一時的にシステム保護をオフにしないでください。

初めてプロジェクトに参加するときは何をすべきですか?

最初は読み取り専用タスクから始めてください。「すべてを修正する」ように直接要求しないでください。推奨される手順:

Git リポジトリのルートディレクトリで kimi を実行します。
ディレクトリ構造とプロジェクトの説明のみを読み取るようにします。
識別された作業ディレクトリを確認します。
読み取るファイルのリストを要求します。
検証可能な小さな変更を加えます。
完了したら、git diff とテスト結果を確認します。

最初の変更作業としては、ドキュメントのリンクを修正したり、単体テストを追加したり、個々のコンポーネントを微調整したりすることが適切です。依存関係のアップグレード、データベースの移行、およびグローバル形式は、最初の検証には適していません。

ログイン方法の選択方法

キミコードOAuth

個人的なインタラクティブな使用とシンプルな構成に適しています。アカウントのサブスクリプション、通話クォータ、および組織のポリシーが CLI の使用をカバーしているかどうかに注意してください。

ムーンショット AI API キー

独立した請求、自動化、またはチーム管理が必要なシナリオに適しています。キーはユーザー構成変数またはセキュリティ環境変数に配置する必要があり、リポジトリに送信しないでください。

いずれの場合も、実際のリクエストは移行後に実行する必要があります。インターフェイスに「ログイン済み」と表示されているからといって、そのモデル、リージョン、クォータが確実に利用可能であることを意味するわけではありません。

MCP の構成と検証

新しいバージョンでは主に /mcp-config を介して MCP を管理することが推奨されていますが、古い Kimi CLI では kimi mcp コマンドも提供されています。ユーザーを移行するときは、2 つのドキュメントセットを混合しないでください。まず kimi --version を使用して現在の製品を確認し、次に対応するバージョンのヘルプを確認してください。

MCP サーバーを追加するときは、次の順序に従ってください。

サーバーリポジトリと権限の説明を読みます。
最初にテストプロジェクトにインストールします。
実際の本番トークンを転送しないでください。
公開されているツールのリストを表示します。
読み取り専用呼び出しを実行します。
ログに認証情報が出力されないことを確認します。
最後に、書き込みツールが開きます。

MCP はエージェントの機能を拡張し、攻撃対象領域も拡大します。ファイル、ブラウザ、データベース、およびクラウドプラットフォームサーバーは、デフォルトで同じレベルの信頼に設定されるべきではありません。

Zed または JetBrains で ACP を使用する

ACP を使用すると、エディターは標準入出力経由で Kimi Code CLI を起動できます。 Zed を例に挙げると、構成構造は次のとおりです。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


{
  "agent_servers": {
    "Kimi Code CLI": {
      "type": "custom",
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

プロセスの起動に失敗したことを示すメッセージがエディターに表示された場合は、まず同じユーザー環境のターミナルで次のコマンドを実行します。

1

kimi acp

一般的な理由としては、エディターが最新の PATH を継承していない、kimi が別のユーザーディレクトリにインストールされている、Git Bash が見つからない、または /login がまだ完了していないなどが挙げられます。

ビデオ入力はどのようなシナリオに適していますか?

Kimi Code CLI は、画面録画またはデモビデオを入力として取得することをサポートしています。アニメーションのリズム、レプリケーションのステップ、参照効果など、言葉で説明するのが難しい UI の動作を説明するのに適しています。

アカウント情報、通知、トークン、顧客データ、無関係なデスクトップ領域のアップロードを避けるために、使用する前にビデオをトリミングしてください。エージェントが「ビデオを理解」できるという事実は、エージェントがビデオに登場するシステムに自動的にアクセスできることを意味するものではありません。実際の変更は、現在のワークスペースとツールの権限によって依然として制限されています。

サブエージェントとフックを安全に有効にする方法

組み込みの coder、explore、および plan サブエージェントはコンテキストを分離できますが、複数のエージェントが同じワークスペースを操作することもできます。タスクでは以下を指定する必要があります。

explore 読み取り専用。
plan はファイルを書き込みません。
coder は、指定されたディレクトリのみを変更します。
削除、インストール、Git プッシュを確認する必要があります。
完了したら、メインセッションとの差分を均一に表示します。

ライフサイクルフックを使用すると、リスクの高いコマンドをブロックし、ツール呼び出しをログに記録し、通知を送信できます。フック構成自体も実行可能境界であるため、サードパーティのフックをインストールする前に確認する必要があります。

レガシー移行チェックリスト

プロジェクト	検査方法
実行可能ファイル	`kimi --version`
シェル	`KIMI_SHELL_PATH` で Git Bash を確認する
ログイン	起動後にリクエストを確認して実行する
セッション	古いセッションを開いて内容を確認する
MCP	サーバーとツールのリストを表示
プロバイダー	API アドレス、モデル、キーを確認する
編集者	`kimi acp` を再テスト
フック	古い構成が重複していないか無効であることを確認します。

更新時のリスクを軽減する方法

CLI の更新により、権限プロンプト、プラグインインターフェイス、および設定形式が変更される場合があります。アップグレードする前に構成をバックアップし、リリースと移行の手順を確認してください。アップグレード後、まずテストリポジトリで読み取り専用タスクを実行します。チームが固定ワークフローに依存している場合は、すべてのメンバーが異なる時間に自動的にアップグレードするようにしないでください。

トラブルシューティングの順序

現象	優先順位のチェック
`kimi` が見つかりません	新しい端末 `PATH`、ユーザーをインストール
バッシュが見つかりません	Windows 用 Git、`KIMI_SHELL_PATH`
ログインは成功しましたが、リクエストできません	クォータ、リージョン、プロバイダー、モデル
MCP は利用できません	現在のバージョン、サーバーの起動および認証
ACP の起動に失敗しました	エディターの環境変数と `kimi acp`
古いセッションがなくなった	ディレクトリとバックアップの移行
コマンド承認例外	フック、権限設定、プロジェクト戦略

Windows に関するよくある質問

プロンプトで `kimi` が見つかりません

まず新しいターミナルを開き、インストールディレクトリに PATH が追加されているかどうかを確認します。古いウィンドウでインストールスクリプトを繰り返し実行しないでください。

Bash が見つからないというプロンプト

Git for Windows がインストールされていることを確認し、KIMI_SHELL_PATH をチェックします。パスは、Git GUI や git.exe ではなく、実際の bash.exe を指す必要があります。

危険なコマンドを実行したい場合、エージェントは何をすべきですか?

セッション全体を一度に許可しないでください。まずコマンド、作業ディレクトリ、ターゲットパスを確認してください。グローバルソフトウェアを削除、上書き、プッシュ、またはインストールする場合は、個別に確認してください。新しいバージョンでは、高リスクのツール呼び出しをさらにインターセプトできるライフサイクルフックがサポートされています。

新しいバージョンをインストールした後、古い Kimi CLI を保持できますか?

2 つはコマンド名と設定を共有する場合があります。公式の方向性は、 Kimi Code CLI に移行することです。ロールバックする必要がある場合は、移行前のバックアップと公式のアンインストール手順に頼る必要があります。長期間共存した後、運試しとして PATH シーケンスに依存することはお勧めできません。

PowerShell では実行できるのに、エディターでは実行できないのはなぜですか?

通常、エディターはインストール前に、更新されたユーザー環境変数を読み取らずに起動されます。完全に終了してエディタを再度開き、使用しているアカウントと端末環境を確認します。

概要

Windows に Kimi Code CLI をインストールする鍵は、最初に Git Bash を準備し、次に /login と読み取り専用の検証を完了することです。古い AMI CLI ユーザーはできるだけ早く移行する必要がありますが、「インストールが成功した」ことだけを確認するのではなく、セッション、MCP、プロバイダー、プロジェクトのパスを項目ごとに確認してください。

Windows クイック インストール