Kimi CLI в этом разделе это новый терминальный агент Moonshot AI Kimi Code: пакет @moonshot-ai/kimi-code, команда kimi. Сторонний адрес он берёт из своего файла настроек, где поставщик описывается явно. Инструкция проверена на Kimi Code 2.1.0 в macOS. Инструкция для Codex выше написана для прежнего Python-клиента Kimi CLI 1.x: Moonshot его заархивировал, он хранит настройки в ~/.kimi и файл из этого раздела не читает. Данные старого клиента переносит команда kimi migrate нового.
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bashНа Windows: irm https://code.kimi.com/kimi-code/install.ps1 | iex, и перед первым запуском нужен Git for Windows. Через npm: npm install -g @moonshot-ai/kimi-code, требуется Node.js 22.19.0 и новее.
Настройки лежат в ~/.kimi-code/config.toml. Поставщик описывается записью [providers.<имя>]: обязательное поле type, дальше api_key или api_key_env, base_url и при желании custom_headers. Значение type выбирает протокол: openai для Chat Completions, openai_responses для Responses. В примере для Grok стоит openai_responses, в остальных openai; для Grok на Kimi Code 2.1.0 работают оба.
# ~/.kimi-code/config.toml
[providers.guard]
type = "openai"
base_url = "https://api.guardrelay.ai/v1"
api_key = "gd-ваш-ключ-из-бота"
[models."guard/claude"]
provider = "guard"
model = "claude-sonnet-5-5"
max_context_size = 1000000# ~/.kimi-code/config.toml
[providers.guard]
type = "openai"
base_url = "https://api.guardrelay.ai/v1"
api_key = "gd-ваш-ключ-из-бота"
[models."guard/k3"]
provider = "guard"
model = "k3"
max_context_size = 1048576# ~/.kimi-code/config.toml
[providers.guard]
type = "openai_responses"
base_url = "https://api.guardrelay.ai/v1"
api_key = "gd-ваш-ключ-из-бота"
[models."guard/grok"]
provider = "guard"
model = "cursor-grok-4.7-high"
max_context_size = 256000# ~/.kimi-code/config.toml
[providers.guard]
type = "openai"
base_url = "https://api.guardrelay.ai/v1"
api_key = "gd-ваш-ключ-из-бота"
[models."guard/composer"]
provider = "guard"
model = "composer-2.5"
max_context_size = 200000
max_output_size = 32000У записи модели обязательны три поля: provider, model и max_context_size. Первое ссылается на имя поставщика, второе это точный id, который уйдёт на сервер, третье это окно контекста, которым клиент считает свой бюджет. Числа по семействам лежат на странице Модели.
Поставьте в начало config.toml строку default_model = "guard/..." с псевдонимом из файла и запускайте просто kimi; kimi -m "guard/..." выбирает другую модель на один запуск. Для разового запроса kimi -p "…" Kimi Code 2.1.0 требует default_model: с одним -m он отвечает no default model configured. Если строка default_model в файле уже есть, например после /login, замените её значение: вторая такая строка ломает файл.
Это современный Node/TypeScript-клиент Moonshot. Используйте официальную инструкцию Kimi Code. На macOS/Linux выполните первый блок, на Windows PowerShell — второй, затем проверьте kimi --version.
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
kimi --versionirm https://code.kimi.com/kimi-code/install.ps1 | iex
kimi --versionПолучите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.
Создайте ~/.kimi-code-guard-glm/config.toml (Windows: %USERPROFILE%\.kimi-code-guard-glm\config.toml) и сохраните туда пример ниже. Переменная KIMI_CODE_HOME подключает этот профиль, не меняя обычный .kimi-code. max_context_size = 131072 — проверенная настройка бюджета истории самого Kimi Code, а не опубликованный максимум GLM; max_output_size = 4096 ограничивает пример одного ответа.
default_model = "guard/glm-5.3"
[providers.guard]
type = "openai_responses"
base_url = "https://api.guardrelay.ai/glm/v1"
api_key_env = "GUARD_API_KEY"
[models."guard/glm-5.3"]
provider = "guard"
model = "glm-5.3"
display_name = "GUARD API · GLM 5.3"
max_context_size = 131072
max_output_size = 4096
capabilities = ["tool_use"]
[models."guard/glm-5.3-flash"]
provider = "guard"
model = "glm-5.3-flash"
display_name = "GUARD API · GLM 5.3 Flash"
max_context_size = 131072
max_output_size = 4096
capabilities = ["tool_use"]macOS / Linux: введите ключ в скрытом приглашении. Переменная действует только в этом терминале и запущенном из него клиенте.
{
unset GUARD_API_KEY
until [ -n "${GUARD_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_API_KEY || break; printf "\n"; done
export GUARD_API_KEY
export KIMI_CODE_HOME="$HOME/.kimi-code-guard-glm"
kimi -m guard/glm-5.3
}Windows PowerShell: выполните команды в том же окне, из которого запускаете клиент. При открытии нового PowerShell задайте ключ снова.
$guardKey = Read-Host "Guard API key" -AsSecureString
$env:GUARD_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password
$env:KIMI_CODE_HOME = "$HOME/.kimi-code-guard-glm"
kimi -m guard/glm-5.3- В тестовой папке выполните
kimi -m guard/glm-5.3. Полное имя включает providerguard/. - Отправьте:
Прочитай README.md и ответь ровно GUARD_GLM_OK. Ничего не меняй. - В том же окне попросите назвать строку без повторного чтения. После выхода команда
kimi -cпродолжает предыдущий сеанс для текущей папки. - Для одного задания без интерактивного интерфейса используйте
kimi -m guard/glm-5.3 -p "Reply with exactly GLM_OK". Не добавляйте--auto: Kimi Code 2.1.0 не допускает его вместе с-p.
| Model ID | Что использовать |
|---|---|
glm-5.3 | Основная модель; текст и задачи с кодом. |
glm-5.3-flash | Быстрая модель; на уровне API принимает PNG и PDF во всех трёх протоколах, MP4 — только в Chat Completions. |
- Для
glm-5.3подтверждены Responses, capabilitytool_useи продолжение сеанса. Flash добавлен тем же provider, но его вложения через Kimi Code не проверялись. - Инструменты чтения, правки и терминала исполняет сам клиент. Этот профиль не подключает инструменты или MCP Z.AI автоматически.
- Проверка этой версии была текстовой и не подтверждает её кнопку вложений. Возможности Flash на уровне API не означают, что конкретный интерфейс умеет передать файл.
- Профиль использует OpenAI Responses (
openai_responses). Серверный промпт GLM для обычного API выключен по умолчанию; настройка клиента сама его не включает. - Native TXT, DOCX и XLSX не входят в подтверждённый GLM-контракт. Для документов используйте PDF; для изображений — PNG и модель
glm-5.3-flash.
| Признак | Что проверить |
|---|---|
401 invalid_api_key | Клиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент. |
404 model_not_found | Model ID равен ровно glm-5.3 или glm-5.3-flash; старые GLM ID, aliases, Turbo и FlashX не поддерживаются. |
404 или неверный путь | Base URL равен https://api.guardrelay.ai/glm/v1. Клиент сам добавляет /responses; не дописывайте его второй раз. |
400 invalid_request | Выбран указанный в инструкции API format; из старого профиля не перенесены reasoning, temperature, MCP или другие непроверенные поля. |
402 insufficient_balance | Проверьте доступный баланс и незавершённые резервы в личном кабинете. |
no default model configured | В начале файла должна быть одна строка default_model = "guard/glm-5.3"; не создавайте её второй раз. |
| Ключ не подхватился | Поле называется api_key_env = "GUARD_API_KEY", а переменная задана до запуска kimi. |
Ошибка --prompt вместе с --auto | Уберите --auto. Для интерактивной работы запускайте без -p; для одного задания оставьте -p без --auto. |
Это современный Node/TypeScript-клиент Moonshot. Используйте официальную инструкцию Kimi Code. На macOS/Linux выполните первый блок, на Windows PowerShell — второй, затем проверьте kimi --version.
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
kimi --versionirm https://code.kimi.com/kimi-code/install.ps1 | iex
kimi --versionПолучите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.
Создайте ~/.kimi-code-guard-gemini/config.toml (Windows: %USERPROFILE%\.kimi-code-guard-gemini\config.toml) и сохраните туда пример ниже. Переменная KIMI_CODE_HOME подключает этот профиль, не меняя обычный .kimi-code. max_context_size = 1048576 — окно модели из таблицы ниже, это бюджет истории самого Kimi Code; max_output_size = 4096 ограничивает пример одного ответа.
default_model = "guard/gemini-4-argon"
[providers.guard]
type = "openai_responses"
base_url = "https://api.guardrelay.ai/v1"
api_key_env = "GUARD_API_KEY"
[models."guard/gemini-4-argon"]
provider = "guard"
model = "gemini-4-argon"
display_name = "GUARD API · Gemini 4 Argon"
max_context_size = 1048576
max_output_size = 4096
capabilities = ["tool_use"]
[models."guard/gemini-3.8-flash"]
provider = "guard"
model = "gemini-3.8-flash"
display_name = "GUARD API · Gemini 3.8 Flash"
max_context_size = 1048576
max_output_size = 4096
capabilities = ["tool_use"]macOS / Linux: введите ключ в скрытом приглашении. Переменная действует только в этом терминале и запущенном из него клиенте.
{
unset GUARD_API_KEY
until [ -n "${GUARD_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_API_KEY || break; printf "\n"; done
export GUARD_API_KEY
export KIMI_CODE_HOME="$HOME/.kimi-code-guard-gemini"
kimi -m guard/gemini-4-argon
}Windows PowerShell: выполните команды в том же окне, из которого запускаете клиент. При открытии нового PowerShell задайте ключ снова.
$guardKey = Read-Host "Guard API key" -AsSecureString
$env:GUARD_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password
$env:KIMI_CODE_HOME = "$HOME/.kimi-code-guard-gemini"
kimi -m guard/gemini-4-argon- В тестовой папке выполните
kimi -m guard/gemini-4-argon. Полное имя включает providerguard/. - Отправьте:
Прочитай README.md и ответь ровно GUARD_GEMINI_OK. Ничего не меняй. - В том же окне попросите назвать строку без повторного чтения. После выхода команда
kimi -cпродолжает предыдущий сеанс для текущей папки. - Для одного задания без интерактивного интерфейса используйте
kimi -m guard/gemini-4-argon -p "Reply with exactly GEMINI_OK". Не добавляйте--auto: Kimi Code не допускает его вместе с-p.
| Model ID | Вход и окно |
|---|---|
gemini-4-argon | Текст, изображения, PDF; окно 1 048 576 токенов, общее на вход и ответ. |
gemini-3.8-flash | Текст, изображения, PDF; окно 1 048 576 токенов на вход. |
- Клиентские инструменты чтения, правки и терминала исполняет сам Kimi Code;
kimi -cпродолжает сеанс. - Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
- Профиль использует OpenAI Responses (
openai_responses). Серверный промпт — отдельная настройка семейства Gemini: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.
| Признак | Что проверить |
|---|---|
401 invalid_api_key | Клиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент. |
404 model_not_found | Model ID — точный ID из таблицы выше или короткое имя gemini; другие написания не поддерживаются. |
404 или неверный путь | Base URL равен https://api.guardrelay.ai/v1. Клиент сам добавляет /responses; не дописывайте его второй раз. |
400 invalid_request | Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие. |
402 insufficient_credit | Проверьте доступный баланс и незавершённые резервы в личном кабинете. |
no default model configured | В начале файла должна быть одна строка default_model = "guard/gemini-4-argon"; не создавайте её второй раз. |
| Ключ не подхватился | Поле называется api_key_env = "GUARD_API_KEY", а переменная задана до запуска kimi. |
Ошибка --prompt вместе с --auto | Уберите --auto. Для интерактивной работы запускайте без -p; для одного задания оставьте -p без --auto. |
Это современный Node/TypeScript-клиент Moonshot. Используйте официальную инструкцию Kimi Code. На macOS/Linux выполните первый блок, на Windows PowerShell — второй, затем проверьте kimi --version.
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
kimi --versionirm https://code.kimi.com/kimi-code/install.ps1 | iex
kimi --versionПолучите универсальный ключ gd-… по прямой ссылке на API в @guardapi и выберите API-пакет. Не вставляйте ключ в проект, репозиторий, текст задания или скриншот. Баланс и расход видны в личном кабинете.
Создайте ~/.kimi-code-guard-muse/config.toml (Windows: %USERPROFILE%\.kimi-code-guard-muse\config.toml) и сохраните туда пример ниже. Переменная KIMI_CODE_HOME подключает этот профиль, не меняя обычный .kimi-code. max_context_size = 1048576 — окно модели из таблицы ниже, это бюджет истории самого Kimi Code; max_output_size = 4096 ограничивает пример одного ответа.
default_model = "guard/muse-wonder-1.0"
[providers.guard]
type = "openai_responses"
base_url = "https://api.guardrelay.ai/v1"
api_key_env = "GUARD_API_KEY"
[models."guard/muse-wonder-1.0"]
provider = "guard"
model = "muse-wonder-1.0"
display_name = "GUARD API · Muse Wonder 1.0"
max_context_size = 1048576
max_output_size = 4096
capabilities = ["tool_use"]
[models."guard/muse-spark-1.3"]
provider = "guard"
model = "muse-spark-1.3"
display_name = "GUARD API · Muse Spark 1.3"
max_context_size = 1048576
max_output_size = 4096
capabilities = ["tool_use"]
[models."guard/muse-spark-1.2"]
provider = "guard"
model = "muse-spark-1.2"
display_name = "GUARD API · Muse Spark 1.2"
max_context_size = 1048576
max_output_size = 4096
capabilities = ["tool_use"]macOS / Linux: введите ключ в скрытом приглашении. Переменная действует только в этом терминале и запущенном из него клиенте.
{
unset GUARD_API_KEY
until [ -n "${GUARD_API_KEY-}" ]; do printf "Guard API key: "; read -r -s GUARD_API_KEY || break; printf "\n"; done
export GUARD_API_KEY
export KIMI_CODE_HOME="$HOME/.kimi-code-guard-muse"
kimi -m guard/muse-wonder-1.0
}Windows PowerShell: выполните команды в том же окне, из которого запускаете клиент. При открытии нового PowerShell задайте ключ снова.
$guardKey = Read-Host "Guard API key" -AsSecureString
$env:GUARD_API_KEY = [System.Net.NetworkCredential]::new("", $guardKey).Password
$env:KIMI_CODE_HOME = "$HOME/.kimi-code-guard-muse"
kimi -m guard/muse-wonder-1.0- В тестовой папке выполните
kimi -m guard/muse-wonder-1.0. Полное имя включает providerguard/. - Отправьте:
Прочитай README.md и ответь ровно GUARD_MUSE_OK. Ничего не меняй. - В том же окне попросите назвать строку без повторного чтения. После выхода команда
kimi -cпродолжает предыдущий сеанс для текущей папки. - Для одного задания без интерактивного интерфейса используйте
kimi -m guard/muse-wonder-1.0 -p "Reply with exactly MUSE_OK". Не добавляйте--auto: Kimi Code не допускает его вместе с-p.
| Model ID | Вход и окно |
|---|---|
muse-wonder-1.0 | Текст, изображения, PDF; окно 1 048 576 токенов. |
muse-spark-1.3 | Текст, изображения, PDF; окно 1 048 576 токенов. |
muse-spark-1.2 | Текст, изображения, PDF; окно 1 048 576 токенов. |
- Клиентские инструменты чтения, правки и терминала исполняет сам Kimi Code;
kimi -cпродолжает сеанс. - Вход в каталоге Guard: текст, изображения и PDF; ответ приходит текстом. Как передать файл или картинку, зависит от интерфейса клиента; эта инструкция вложения не описывает.
- Профиль использует OpenAI Responses (
openai_responses). Серверный промпт — отдельная настройка семейства Muse: он применяется, только если у ключа есть право и включена опция; настройка клиента сама его не включает.
| Признак | Что проверить |
|---|---|
401 invalid_api_key | Клиент получил полный действующий ключ gd-…; переменная задана в том же процессе, где запущен клиент. |
404 model_not_found | Model ID — точный ID из таблицы выше или короткое имя muse; другие написания не поддерживаются. |
404 или неверный путь | Base URL равен https://api.guardrelay.ai/v1. Клиент сам добавляет /responses; не дописывайте его второй раз. |
400 invalid_request | Выбран указанный в инструкции формат API; из старого профиля не перенесены лишние настройки: размышления, temperature, MCP и другие. |
402 insufficient_credit | Проверьте доступный баланс и незавершённые резервы в личном кабинете. |
no default model configured | В начале файла должна быть одна строка default_model = "guard/muse-wonder-1.0"; не создавайте её второй раз. |
| Ключ не подхватился | Поле называется api_key_env = "GUARD_API_KEY", а переменная задана до запуска kimi. |
Ошибка --prompt вместе с --auto | Уберите --auto. Для интерактивной работы запускайте без -p; для одного задания оставьте -p без --auto. |
Установите Kimi CLI по официальной инструкции Moonshot. На macOS/Linux выполните первую команду; на Windows PowerShell — вторую. Затем проверьте kimi --version.
curl -LsSf https://code.kimi.com/install.sh | bash
kimi --versionInvoke-RestMethod https://code.kimi.com/install.ps1 | Invoke-Expression
kimi --versionОткройте @guardapi → Категории → API, выберите пакет и сохраните ключ gd-…. Kimi CLI получит доступ к Codex через тот же универсальный ключ.
- Откройте
~/.kimi/config.toml(Windows:%USERPROFILE%\.kimi\config.toml). Если файла нет, запуститеkimiодин раз, затем выйдите: клиент создаст его. Для стороннего адреса/loginне подходит — он настраивает платформы Moonshot. - Добавьте таблицу
[providers.guard-codex]. Не заменяйте существующие[providers.*]и другие разделы.type = "openai_responses"выбирает/responses;openai_legacyвыбрал бы Chat Completions. - Добавьте отдельную таблицу
[models."guard-codex/astra"]. Это локальное имя в Kimi CLI; полеmodel = "gpt-6-astra"задаёт точный ID для Guard. - Поле
max_context_sizeобязательно в Kimi CLI. Для Astra, Sol и Luna укажите872000; это клиентский бюджет истории, а не обещание строгого серверного предела. По проверке от 23 сентября 2026 года Kimi CLI 1.48.0 выполнил Astra read/edit/test и same-session follow-up; Sol и Luna ответили на отдельные короткие запросы.
# Добавьте в ~/.kimi/config.toml; замените только gd-ваш-ключ
[providers.guard-codex]
type = "openai_responses"
base_url = "https://api.guardrelay.ai/codex/v1"
api_key = "gd-ваш-ключ"
[models."guard-codex/astra"]
provider = "guard-codex"
model = "gpt-6-astra"
display_name = "GUARD API · GPT-6 Astra"
max_context_size = 872000
capabilities = ["thinking", "image_in"]
[models."guard-codex/sol"]
provider = "guard-codex"
model = "gpt-6-sol"
display_name = "GUARD API · GPT-6 Sol"
max_context_size = 872000
capabilities = ["thinking", "image_in"]
[models."guard-codex/luna"]
provider = "guard-codex"
model = "gpt-6-luna"
display_name = "GUARD API · GPT-6 Luna"
max_context_size = 872000
capabilities = ["thinking"]Kimi CLI хранит api_key в config.toml; сделайте этот файл доступным только своей учётной записи и не добавляйте его в репозиторий. На macOS/Linux можно выполнить chmod 600 ~/.kimi/config.toml. Переменные OPENAI_API_KEY и OPENAI_BASE_URL, если они заданы в окружении, перекрывают значения этого типа провайдера: при неожиданном адресе или 401 проверьте их.
Последний сохранённый нативный каталог Guard объявляет следующие значения максимального окна для настройки клиентского бюджета. Это не проверенный жёсткий предел входа; клиент может сжать историю раньше. В подключении Guard все семь моделей принимают и сохраняют max_output_tokens (Responses), max_completion_tokens (Chat) и max_tokens (Messages) как advisory, без гарантии жёсткого лимита вывода managed Codex; списание идёт по фактическим токенам и денежным правилам ключа.
| ID модели | Контекст для настройки клиента |
|---|---|
gpt-6-astra | 872000 |
gpt-6.1-sol | 872000 |
gpt-6-sol | 872000 |
gpt-6-luna | 872000 |
gpt-5.6-sol | 872000 |
gpt-5.6-terra | 872000 |
gpt-5.6-luna | 872000 |
- В папке проекта выполните
kimi --model "guard-codex/astra". - В открывшемся сеансе введите
Ответь ровно OKи дождитесь ответа. Для разовой проверки можно использовать команду ниже с--promptи--print. - Следующий вопрос в этом же окне продолжает беседу. После выхода из той же папки запустите
kimi --continue; клиент восстановит последнюю сессию. Через/sessionsможно выбрать другую. - Если хотите более глубокое рассуждение, Kimi CLI поддерживает
--thinkingдля модели с capabilitythinking; этот переключатель запрашивает уровеньhigh, а не все возможные значения API.
kimi --model "guard-codex/astra"
# Разовый запрос:
kimi --model "guard-codex/astra" --prompt "Ответь ровно OK" --print
# Вернуться к последней беседе в этой папке:
kimi --continue| Признак | Что проверить |
|---|---|
| Ошибка чтения конфигурации | В файле нет второй таблицы с тем же именем; max_context_size присутствует и задан числом. |
401 | api_key — ваш действующий gd-…; чужой OPENAI_API_KEY не перекрыл его. |
404 | base_url оканчивается на /codex/v1, тип равен openai_responses, точный ID — gpt-6-astra. |
402 | Проверьте баланс и лимиты ключа в кабинете. |