【免费下载链接】makiAn efficient AI coding agent extendable by neovim-like Lua plugins项目地址https://gitcode.com/gh_mirrors/maki3/maki点击查看免费下载Maki 是一个高效省 token 的 AI 编程智能体AI coding agent基于 Rust 编写终端界面启动即达 60 FPS并可用类 Neovim 的 Lua 插件自由扩展。本文是一份 Maki 安装完全指南覆盖 Linux、macOS、Windows 与 Nix 多平台一条命令完成 Maki 安装再配上 API Key几分钟内即可跑起你的第一个 AI 编码会话。一、安装方式速览Maki 各平台安装方式汇总按你的系统选择对应章节即可平台推荐方式安装目录Linux / macOS官方安装脚本 或 Homebrew~/.local/binWindows (PowerShell)install.ps1脚本%LOCALAPPDATA%\makiWindows (Git Bash)与 Linux 相同的install.sh%LOCALAPPDATA%\makiNix 用户nix run github:tontinton/makiNix 沙箱管理源码党cargo install --locked --path .cargo 默认目录所有官方渠道都直接下载预编译二进制无需 Rust 编译环境整个安装通常不到 1 分钟。二、Maki Linux/macOS 安装步骤一条命令macOSIntel / Apple Silicon与 Linuxx86_64 / ARM64共用同一个安装脚本。推荐做法先下载、阅读脚本再执行官方脚本 install.sh 逻辑非常透明仅 170 余行# 下载安装脚本并查看内容 curl -fsSL https://maki.sh/install.sh -o install.sh cat install.sh # 确认后执行 chmod x install.sh sh install.sh追求速度的话直接一行搞定curl -fsSL https://maki.sh/install.sh | sh脚本会自动识别你的系统架构如aarch64-apple-darwin、x86_64-unknown-linux-musl、拉取最新 release 二进制、放入~/.local/bin并提示 PATH 配置。如果不想装到默认位置可用环境变量MAKI_INSTALL_DIR覆盖安装目录。使用 Homebrew 安装 MakiMac 用户更熟悉 brew 的话一条命令即可brew install maki三、Maki Windows 安装PowerShell 与 Git Bash 两种方式方式一PowerShell原生终端同样建议先下载脚本再执行脚本为 install.ps1# 下载并查看脚本内容 irm https://maki.sh/install.ps1 -OutFile install.ps1 Get-Content install.ps1 # 执行安装 .\install.ps1一行流版本irm https://maki.sh/install.ps1 | iex方式二Git Bash在 Git Bash 中直接使用 Linux/macOS 的脚本即可curl -fsSL https://maki.sh/install.sh | sh 两种方式都会把 Maki 安装到%LOCALAPPDATA%\maki并自动写入用户 PATH安装后重启终端再执行maki。Windows 目前提供 x86_64 构建ARM64 设备通过系统模拟运行。四、Nix 用户一行命令零残留如果你的日常环境是 Nix最简单的方式是直接运行nix run github:tontinton/maki仓库内自带 flake.nix基于 crane 构建也支持从源码构建开发壳nix develop即可获得包含 cargo、just、stylua 等完整工具的 devShell。五、源码安装与从 Git 仓库构建想跟 main 分支或参与开发仓库提供 justfile 任务集git clone https://gitcode.com/gh_mirrors/maki3/maki cd maki just install # 等价于 cargo install --locked --path . just test # 运行全量测试注意源码构建需要 Rust 1.99见 Cargo.toml。普通用户直接用上面的二进制安装脚本更省事。六、安装成功验证与 Maki 自我更新安装完成后在新终端验证maki --version # 输出版本号说明安装成功 maki # 直接启动 TUI 交互界面Maki 内置自我更新机制实现见 src/update.rs无需手动重新跑安装脚本maki update # 升级到最新 release maki rollback # 回滚到上一版本更新流程会先备份旧二进制maki_backup失败可自动恢复Windows 下会先把运行中的maki.exe重命名再替换避免文件锁问题。七、Maki 首次配置连接 AI 提供商二进制装好只是第一步Maki 还需要一个模型提供商API Key 或 OAuth。两种方式任选方式一交互式登录推荐支持 OAuth 与 API Key 选择器maki auth login # 交互选择器OpenAI / xAI 等支持 OAuth maki auth status # 查看各提供商配置状态方式二环境变量export ANTHROPIC_API_KEY你的key # 或 OPENAI_API_KEY / GEMINI_API_KEY 等一个环境变量里可填多个 key逗号分隔触发限流时会自动轮换。完整提供商列表Anthropic、OpenAI、Google、DeepSeek、Mistral、Ollama 本地部署等 20 家见 README.md 的 Supported providers 章节与 site/docs/content/providers/_index.md。想固定默认模型编辑全局配置~/.config/maki/init.luaLua 语法与插件同语言maki.setup({ provider { default_model anthropic/claude-sonnet-4-6, }, })八、常见安装问题排查PATH / 权限 / 版本1. 提示command not found: makiPATH 未生效Linux/macOS 安装到~/.local/bin后若该目录不在 PATH 中脚本会主动提示。在~/.bashrc或~/.zshrc中追加export PATH$HOME/.local/bin:$PATHWindows 则是重启终端若仍找不到检查%LOCALAPPDATA%\maki是否已加入用户 PATH。2. 目录无写入权限脚本默认目录不可写时会尝试 sudo否则报错退出。手动指定一个可写目录即可export MAKI_INSTALL_DIR$HOME/.maki/bin # Windows: $env:MAKI_INSTALL_DIR sh install.sh3. 旧版本被 shadow 了脚本会检测 PATH 中是否已有同名maki且指向别处如 cargo 安装版并提示移除或调整 PATH 顺序避免装了新版却跑旧版。4. 想锁定/回退特定版本安装脚本支持传入 tag 参数如sh install.sh v0.5.5日常使用则用maki update/maki rollback管理详见 site/docs/content/cli/_index.md。九、5 分钟跑通第一个 AI 编码会话cd 你的项目目录 maki然后输入需求按 Enter 即可。第一天值得记住的快捷键权限仓库内文件编辑直接放行bash 与联网工具会先询问y单次允许 /s本会话 /a本项目/yolo跳过提示Plan 模式Tab切换先出计划再动手换模型/model会话中随时切换续聊明天用maki --continue接着上次聊跑命令输入!cargo test自己执行!!则对 agent 隐藏总结Maki 安装怎么选普通用户Linux/macOS 用一行curl脚本或brew install makiWindows 用install.ps1Nix 用户nix run github:tontinton/maki最省心开发者git clone后just install任务集见 justfile装好后执行maki auth login配置好提供商5 分钟内就能体验这个 60 FPS、省 token 的 AI 编程智能体。更多细节可阅读官方快速上手文档 site/docs/content/quick-start/_index.md。赞分享【免费下载链接】makiAn efficient AI coding agent extendable by neovim-like Lua plugins项目地址https://gitcode.com/gh_mirrors/maki3/maki点击查看免费下载相关推荐5分钟装好TheFeedAndroid/iOS/Windows/macOS/Linux全平台安装完全指南含Termux5分钟装好TheFeedAndroid/iOS/Windows/macOS/Linux全平台安装完全指南含Termux TheFeedthefeed是5分钟上手AgentDockDocker、Linux、macOS、Windows多平台完整安装指南5分钟上手AgentDockDocker、Linux、macOS、Windows多平台完整安装指南 AgentDock 是一个面向 AI Agent 的独立工5 分钟装好清风输入法 WindInputWindows、macOS 与 Linux 三平台安装完全指南5 分钟装好清风输入法 WindInputWindows、macOS 与 Linux 三平台安装完全指南 清风输入法 WindInput 是一款 轻量、快速、创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考