ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Kimi Code CLI 入门指南:从安装到第一次对话的完整实战

Kimi Code CLI 入门指南:从安装到第一次对话的完整实战 AI Agent代码智能体人工智能大模型CLI【免费下载链接】kimi-codeKimi Code CLI — The Starting Point for Next-Gen Agents项目地址https://gitcode.com/gh_mirrors/ki/kimi-code点击查看免费下载导读本篇指南面向首次接触 Kimi Code CLI 的开发者完整覆盖从环境准备、两种安装方式官方脚本与 npm、首次启动与登录认证到第一个自然语言任务、常用命令与快捷键速查、数据存放位置以及升级卸载的全流程。读完本文你将能够在本机快速装好并跑通 Kimi Code CLI掌握kimi、kimi -p、kimi -c三种基本启动方式理解~/.kimi-code/数据目录的作用并知道如何切换模型、管理会话与安全退出。Kimi Code CLI 是什么Kimi Code CLI 是一个运行在终端中的 AI Agent帮助完成软件开发任务和日常终端操作——阅读和修改代码、执行 Shell 命令、搜索文件、抓取网页并在执行过程中根据反馈自主规划和调整下一步行动。它适用于以下场景编写和修改代码实现新功能、修复 bug、完成重构理解项目探索陌生的代码库解答架构和实现层面的问题自动化任务批量处理文件、运行构建与测试、串联多个脚本从仓库实现看整套 CLI 以 TypeScript 编写通过 npm 分发运行在 Node.js 之上。其 npm 包名为moonshot-ai/kimi-codebin字段将kimi命令指向dist/main.mjs见 apps/kimi-code/package.json命令行参数解析使用 Commander.js见 apps/kimi-code/src/cli/commands.ts入口在 apps/kimi-code/src/main.ts。提示Kimi Code CLI 为全交互式 TUI终端用户界面应用推荐在支持真彩色与连字的现代终端中运行以获得最佳体验例如 Kitty 或 Ghostty。安装提供两种安装方式官方安装脚本推荐无需预装 Node.js和 npm 全局安装。脚本安装推荐macOS / Linuxcurl -fsSL https://code.kimi.com/kimi-code/install.sh | bashWindowsPowerShellirm https://code.kimi.com/kimi-code/install.ps1 | iexWindows 用户首次启动前还需要安装 Git for WindowsKimi Code CLI 会使用其中的 Git Bash 作为 Shell 环境。如果 Git Bash 安装在非标准路径请把KIMI_SHELL_PATH设为bash.exe的绝对路径。脚本会自动下载最新版本、校验 checksum并把kimi可执行文件放到你的PATH中。除了脚本安装仓库还提供基于 Node.js SEASingle Executable Application的原生二进制打包流程见 apps/kimi-code/scripts/native/build.mjs这也是脚本安装可以不依赖 Node.js 的原因。npm 安装需要 Node.js 22.19.0 或更高版本该版本要求同时体现在 apps/kimi-code/package.json 的engines字段中。先确认你的 Node 版本node --versionnpmnpm install -g moonshot-ai/kimi-codepnpmpnpm add -g moonshot-ai/kimi-code安装完成后验证可执行文件是否就绪kimi --version第一次启动进入项目目录后直接运行kimi启动交互界面cd your-project kimi只想执行一条指令而不进入交互界面时使用-pprompt 模式对应仓库中uiMode为print的无头运行路径见 apps/kimi-code/src/cli/options.tskimi -p 帮我看一下这个项目的目录结构继续上一次会话加-c对应CLIOptions.continue等价于-C见 apps/kimi-code/src/cli/commands.tskimi -c除上述基本用法外从 apps/kimi-code/src/cli/commands.ts 的选项定义还可以看到其他常用启动参数供进阶使用参数说明-S, --session [id]恢复指定会话不带 ID 时交互式选择-m, --model model指定本次调用的模型别名默认取config.toml中的default_model-y, --yolo以 Ask When Needed 模式启动常规编辑与命令自动执行高风险操作仍会询问--auto以 Never Ask 模式启动从不打断一切自动执行与决策--plan以 Plan 模式启动--output-format formatprompt 模式输出格式可选text或stream-json默认text--skills-dir dir从指定目录加载 Skills可重复传入--agent name以指定 Agent 配置启动新会话不可与--session/--continue组合--agent-file path从 Markdown 文件加载 Agent 定义其中-p与-y/--auto/--plan互斥-c与-S互斥这些冲突校验在validateOptions中实现见 apps/kimi-code/src/cli/options.ts。首次登录首次启动时需要配置 API 来源。在交互界面中输入/login进入登录流程/login/login会弹出平台选择器支持两种方式Kimi CodeOAuth— 验证码流程在任意设备打开链接、登录并输入验证码即可授权Kimi Platform API 密钥— 输入来自platform.kimi.com或platform.kimi.ai的 API 密钥从源码看登录流程对应kimi login子命令走设备码device-codeOAuth 流程还支持--region参数指定登录区域mainland-cnkimi.com或globalkimi.ai见 apps/kimi-code/src/cli/sub/login.ts。授权成功后OAuth 凭据会被保存到~/.kimi-code/credentials/目录权限为0700目录 /0600文件仅当前用户可读写。需要退出登录时输入/logout清除当前凭证。提示如果你想接入 Anthropic、OpenAI、Google 等其他供应商需要直接编辑~/.kimi-code/config.toml配置 API 密钥详见平台与模型。配置项完整说明见配置文件、环境变量和配置覆盖。第一个对话登录完成后用自然语言描述任务即可。先让它熟悉当前项目帮我看一下这个项目的目录结构简单介绍一下每个目录是做什么的Kimi Code CLI 会自动调用文件读取、搜索等工具浏览相关内容后给出回答。只读操作默认自动执行无需确认对于会修改文件或执行 Shell 命令的操作默认会在执行前征求确认。也可以直接描述更具体的任务在 src/utils 里新增一个函数用来把任意字符串转成 kebab-case并补一个单元测试Kimi Code CLI 会规划步骤、修改代码、运行测试并在每一步告诉你它做了什么。从仓库的测试看这类端到端能力有专门的验证覆盖见 apps/kimi-code/test/e2e 目录下的 e2e 测试以及 apps/kimi-code/test/cli 下的 CLI 单元测试可以印证文档描述的规划 → 执行 → 反馈 → 调整行为模型。提示不知道能做什么随时在输入框输入/help可以打开内置的命令和快捷键面板按↑/↓翻看Esc关闭。退出时输入/exit或按Ctrl-C两次或在输入框为空时按Ctrl-D。常用命令与快捷键速查第一次使用时记住下面这些就够了会话相关命令命令说明/new开启新会话清空当前上下文/sessions浏览历史会话选择恢复/model切换当前使用的模型/compact手动压缩上下文释放 token/fork派生当前会话为保留完整历史的独立副本仍停留在当前会话最常用快捷键快捷键说明Esc中断流式输出 / 关闭弹窗Ctrl-C中断输出空闲时连按两次退出Shift-Tab切换 Plan 模式Ctrl-S输出中途插入消息无需等待结束Ctrl-O折叠 / 展开工具输出和压缩摘要想看完整列表输入/help或访问斜杠命令参考和键盘快捷键。数据存放在哪里Kimi Code CLI 的本地数据默认保存在~/.kimi-code/下包含配置文件、会话记录、日志和更新缓存。如需迁移到别处通过KIMI_CODE_HOME环境变量指定新路径export KIMI_CODE_HOME$HOME/.config/kimi-code各平台的默认数据根路径为macOS/Users/name/.kimi-codeLinux/home/name/.kimi-codeWindowsC:\Users\name\.kimi-code数据根目录下的主要文件与用途如下完整结构见数据路径文件 / 目录用途config.toml主运行时配置供应商、模型、循环控制等tui.toml终端界面偏好含自动更新开关[upgrade].auto_install默认开启sessions/会话数据按workDirKey/sessionId/组织session_index.jsonl会话索引每行含sessionId、sessionDir、workDircredentials/OAuth 凭据目录0700、文件0600logs/kimi-code.log全局诊断日志updates/自动更新状态latest.json、install.json、rollout.log等bin/托管二进制缓存rg、fduser-history/按工作目录区分的输入历史AGENTS.md全局 Kimi 专属 Agent 指令可选mcp.json用户级 MCP server 声明可选skills/Kimi 专属用户级 Skills可选plugins/已安装 plugin 记录与副本注意一个细节设置KIMI_CODE_HOME后config.toml、会话、日志、OAuth 凭据、Kimi 专属用户级 Skills、全局AGENTS.md等Kimi Code 数据都会落到新路径而通用.agents资源如~/.agents/skills/仍保留在真实 OS home 下以便跨工具共享。需要清理数据时删除数据根目录即可重置全部运行时数据只想清理部分内容如重置配置删除config.toml、清理所有会话删除sessions/与session_index.jsonl、清除 OAuth 登录态运行/logout可参考数据路径中的清理对照表。完整说明见环境变量。升级与卸载升级运行kimi upgradeCLI 会检查最新版本并展示更新选项。选择Install update now后根据当前安装来源执行升级也可以直接用包管理器npm install -g moonshot-ai/kimi-codelatest从源码看upgrade是内置子命令upgrade与update互为别名支持-y, --yes跳过确认直接安装更新阶段的后台下载由隐藏命令__update_download承担见 apps/kimi-code/src/cli/commands.ts。卸载脚本安装的用户删除kimi可执行文件即可npm 安装的用户npm uninstall -g moonshot-ai/kimi-code卸载后如需彻底清除运行时数据可删除~/.kimi-code/或KIMI_CODE_HOME指定路径目录。下一步交互与输入 — 输入框操作、审批流程、Plan 模式和 Ask When Needed 模式详解会话与上下文 — 恢复会话、上下文压缩、导出会话常见使用案例 — 典型任务的 prompt 示例平台与模型 — 接入 Anthropic、OpenAI、Google 等第三方供应商配置文件 —config.toml各字段的完整说明赞分享AI Agent代码智能体人工智能大模型CLI【免费下载链接】kimi-codeKimi Code CLI — The Starting Point for Next-Gen Agents项目地址https://gitcode.com/gh_mirrors/ki/kimi-code点击查看免费下载相关推荐告别繁琐折腾用 PortMaster 为复古掌机搭建完整免费游戏库的实用指南告别繁琐折腾用 PortMaster 为复古掌机搭建完整免费游戏库的实用指南 刚把复古掌机拿到手时很多人以为最难的是选设备、刷系统直到真正开始找游戏才人工智能AI Agent代码智能体交互助手CLI工具调用最完整openai-node入门指南从安装到第一个GPT-4o对话应用最完整openai node入门指南从安装到第一个GPT 4o对话应用 引言为什么选择openai node 你是否还在为整合OpenAI API而编写繁AI 应用大模型后端Axios 入门实战安装、导入方式与第一次请求的完整指南Axios 入门实战安装、导入方式与第一次请求的完整指南 本文基于 axios 仓库官方入门文档法语版整理并结合当前仓库源码做深入佐证。读完后你将掌握网络后端前端上一篇贪吃蛇AI项目从图搜索到强化学习的完整技术指南下一篇stm32fxxx-hal-libraries USB开发详解从设备到主机的完整实现创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表