Kimi Code CLIを始める
Kimi Code CLIは、ターミナル上で動作するAIエージェントです。コードの読み取りや変更、シェルコマンドの実行、ファイル検索、ウェブページの取得を行いながら、作業中のフィードバックに応じて次の手順を自律的に計画・調整し、ソフトウェア開発や日常的なターミナル操作を支援します。
次のような場面に適しています。
- コードの作成・変更：新機能の実装、バグ修正、リファクタリングの完了
- プロジェクトの理解：初めて触れるコードベースを探索し、アーキテクチャや実装に関する質問に回答
- タスクの自動化：ファイルの一括処理、ビルドやテストの実行、複数スクリプトの連携
CLIはTypeScriptで書かれ、npm経由で配布され、Node.js上で動作します。
始める前に
- オペレーティングシステム：macOS、Linux、またはWindows（PowerShell経由）
- Kimiアカウント：有効なKimiメンバーシップのサブスクリプション、または呼び出し可能なAPIキー
インストール
インストール方法は2つあります。公式インストールスクリプト（推奨、Node.jsの事前インストール不要）と、npmによるグローバルインストールです。
インストールスクリプト（推奨）
macOS / Linux:
Windows（PowerShell）:
このスクリプトは最新リリースを自動でダウンロードし、チェックサムを検証したうえで、kimi実行ファイルをPATH上に配置します。
Windowsでは、初回起動前にGit for Windowsをインストールしてください。Kimi Code CLIは同梱のGit Bashをシェル環境として使用します。Git Bashをカスタムの場所にインストールしている場合は、KIMI_SHELL_PATHにbash.exeの絶対パスを設定してください。
npmでインストール
Node.js 22.19.0以降がすでにインストールされている場合は、npmから直接インストールできます。
pnpmを使う場合は次のとおりです。
インストールの確認
インストール後、実行ファイルが利用できることを確認します。
kimiコマンドが見つからない場合は、ターミナルを開き直すか、source ~/.bashrc（または~/.zshrc）を実行してください。
macOS Gatekeeperの影響により、
kimiの初回実行には通常より時間がかかることがあります。以降の起動を速くするには、使用しているターミナルアプリをシステム設定 → プライバシーとセキュリティ → デベロッパツールに追加してください。
アップグレードとアンインストール
アップグレード：kimi upgradeを実行します。CLIが最新バージョンを確認し、更新オプションを表示します。現在のインストール元に応じてアップグレードするには、Install update nowを選択します。パッケージマネージャーから直接アップグレードすることもできます。
アンインストール：スクリプトでインストールした場合は、kimi実行ファイルを削除します。npmでインストールした場合は次を実行します。
初回起動
対話型ターミナル
プロジェクトディレクトリに移動し、kimiを実行して対話型UIを起動します。
1回だけ指示する
対話型UIに入らずに1つの指示だけ実行するには、-pを使用します。
セッションを再開する
前回のセッションを再開するには、-Cを追加します。
初回ログイン
初回起動時には、APIソースを設定する必要があります。対話型UIで/loginを入力し、ログインフローを開始します。
/loginを実行すると、2つの選択肢に対応したプラットフォーム選択画面が開きます。
- Kimi Code（OAuth） — デバイスコードフロー。任意のデバイスでリンクを開いてサインインし、コードを入力して認可します
- Kimi Platform APIキー —
platform.kimi.comまたはplatform.kimi.aiのAPIキーを入力します
サインアウトするには、/logoutを入力して現在の認証情報を消去します。
Anthropic、OpenAI、Google、その他のプロバイダーに接続したい場合は、~/.kimi-code/config.tomlを直接編集してAPIキーを設定してください。すべての設定オプションの詳細は、環境変数と設定上書きのドキュメントを参照してください。
AGENTS.mdを生成する
プロジェクトディレクトリで/initコマンドを実行します。Kimi Code CLIがプロジェクト構造を自動でスキャンし、AGENTS.mdファイルを生成します。
AGENTS.mdは、プロジェクトの背景情報、ビルド手順、コード規約、その他のコンテキストをAIに提供し、AIがプロジェクトをより正確に理解できるようにするために使われます。
最初の会話
ログインしたら、自然言語でタスクを説明します。まずはKimi Code CLIにプロジェクトを把握させるのがおすすめです。
Kimi Code CLIは、応答前にファイル読み取り、検索、その他のツールを自動で呼び出し、関連コンテンツを参照します。読み取り専用の操作は、デフォルトでは確認を求めず自動で実行されます。ファイルを変更したりシェルコマンドを実行したりする操作については、実行前に確認を求めます。
より具体的なタスクを直接説明することもできます。
Kimi Code CLIは手順を計画し、コードを変更し、テストを実行して、各ステップで何を行ったかを知らせます。
何をすればよいか分からない場合は、いつでも/helpと入力すると、組み込みコマンドとキーボードショートカットのパネルを開けます。↑/↓で一覧を移動し、Escで閉じます。終了するには、/exitと入力するか、Ctrl-Cを2回押すか、入力ボックスが空の状態でCtrl-Dを押します。
よく使うコマンドとキーボードショートカット
セッションコマンド
| コマンド | 説明 |
|---|---|
/new | 現在のコンテキストをクリアして、新しいセッションを開始します |
/sessions | セッション履歴を参照し、再開するセッションを選びます |
/model | 現在のモデルを切り替えます |
/compact | コンテキストを手動で圧縮し、トークンを解放します |
/fork | 現在のセッションをフォークし、履歴を保持したまま独立して続行します |
よく使うキーボードショートカット
| ショートカット | 説明 |
|---|---|
Esc | ストリーミング出力を中断する / ポップアップを閉じる |
Ctrl-C | 出力を中断します。待機中に2回押すと終了します |
Shift-Tab | Planモードを切り替えます |
Ctrl-S | 現在の応答完了を待たずに、ストリーミング中にメッセージを差し込みます |
Ctrl-O | ツール出力を折りたたむ / 展開する |
完全な一覧は、/helpを入力するか、操作と入力をご覧ください。
データの保存場所
Kimi Code CLIはデフォルトで、設定ファイル、セッション記録、ログ、更新キャッシュなどのローカルデータを~/.kimi-code/配下に保存します。別の場所に移動するには、KIMI_CODE_HOME環境変数で新しいパスを指定します。ディレクトリ構成の詳細は、環境変数のドキュメントを参照してください。
FAQ
APIキーを入力しましたが、認証に失敗したと表示されます。
まず、キーとBase URLが同じプラットフォームに属していることを確認してください。api.kimi.comとapi.moonshot.cnは完全に独立した2つのアカウントシステムであり、APIキーを相互に使うことはできません。
| プラットフォーム | Base URL | 課金 | キー作成 |
|---|---|---|---|
| Kimi Code | OpenAI互換: https://api.kimi.com/coding/v1Anthropic互換: https://api.kimi.com/coding/ | Kimiメンバーシップのサブスクリプション（quotaを含む） | Kimi Code Console |
| Kimi オープンプラットフォーム | https://api.moonshot.cn/v1 | 従量課金 | Kimi オープンプラットフォーム |
インストール後にkimiコマンドが見つかりません。
インストールスクリプトはkimiをPATHに追加しますが、反映するにはターミナルの再起動、またはsource ~/.bashrc（またはsource ~/.zshrc）の実行が必要です。それでも見つからない場合は、~/.local/binがPATHに含まれているか確認してください。
/loginを実行してもブラウザがポップアップしませんでした。
リモートサーバーやヘッドレス環境では、/loginがURLを表示します。そのURLを手動でブラウザにコピーして、認可を完了してください。
問題や提案がある場合は、GitHub Issuesでフィードバックをお寄せください。
次のステップ
- 操作と入力 — 入力ボックスの操作、承認フロー、Planモード、YOLOモードの解説
- セッションとコンテキスト — セッションの再開、コンテキストの圧縮、セッションのエクスポート
- よくあるユースケース — 典型的なタスク向けのプロンプト例