MakeCoder: Unified AI agent CLI tool integrating Claude Code, Codex and Gemini CLI
npm install makecoderCoder 是 MakeCoder 平台的核心生产力工具。它是一个运行在终端的超级编程智能体。
* 多智能体引擎 (Multi-Agent)：内置并自动调度 Claude Code, Codex CLI, Gemini CLI 等顶尖编程引擎。
* 零配置 (Zero-Config)：无需配置Claude Code等，开箱即用。
* 全栈能力：支持文件读写、命令执行、代码重构与自动排错。可用于AI编程、AI运维、AI营销等全场景。
在安装 Coder CLI之前，请确保您的电脑满足以下要求。
Coder 依赖 Node.js 运行。推荐安装 v20 或更高版本。
| 操作系统 | 安装方式 |
|:---|:---|
| macOS | 推荐使用 Homebrew: brew install node |
| Windows | 访问 Node.js 官网 下载安装包 (LTS版本) |
| Linux | 使用 apt: sudo apt install nodejs npm 或使用 nvm 管理 |
> 🤖 遇到困难？ 点击查看 AI 详细安装指导
如果您使用的是 Windows 系统，强烈建议安装并使用 Git Bash 作为默认终端，以获得最佳的交互体验。
1. 安装 Git Bash (如果未安装): 打开 PowerShell 运行:
``powershell`
winget install --id Git.Git -e
2. 使用提示: 安装完成后，请在 Git Bash 窗口中运行后续的所有 和 coder 命令。
> 🤖 遇到困难？ 点击查看 Windows 环境配置 AI 解答
-----
使用 npm 全局安装最新版 Coder：
`bash
npm install -g makecoder
* 升级安装
* 表示全局安装，允许在任何目录下使用 coder 命令。
* 国内 npm 安装加速 npm install -g makecoder --registry=https://registry.npmmirror.com$3
如果未认证，运行
会自动打开浏览器引导登录认证。也可以手动创建API Key来认证：
* MakeCoder 控制台 > 创建 > 复制 API Key
* 在终端运行以下命令：
coder --save-auth --apikey <粘贴您的_API_KEY>核心用法
$3
直接输入
进入沉浸式编程对话。Coder 会记住上下文，适合处理复杂的重构任务。`bash
coder
`$3
通过命令行参数直接下达指令，适合快速生成脚本或文件。
bash
示例：生成算法文件
coder "使用 Python 编写一个快速排序算法并输出到 sort.py 文件"
`* 参数技巧:
*
: 执行完成后自动退出 (Print & Exit)，不进入交互模式。$3
在交互模式中，输入
/model 即可切换底层驱动的大模型。`bash
/model Select model
Switch between models. Applies to this session and future sessions. For custom model names, specify with --model.
1. Claude Sonnet 4.5 Use the default model Claude Sonnet 4.5 · 1.5x/1.88x per Mtok
2. Claude Haiku 4.5 Claude Haiku 4.5 模型。0.53x~
❯ 3. Claude Opus 4.5 Claude Opus 4.5 for complex tasks · 2.5x/3.12x per Mtok ✔
4. GPT-5 GPT-5 for complex tasks · 1x/1x per Mtok
5. GPT-5.1 GPT-5 for complex tasks · 1x/1x per Mtok
6. GPT o3 GPT o3 for complex tasks · 1x/1x per Mtok
7. Gemini 2.5 Flash Gemini 2.5 Flash for complex tasks · 0.15x/0.32x per Mtok
8. Gemini 2.5 Pro Gemini 2.5 Pro for complex tasks · 1x/1x per Mtok
9. DeepSeek-V3.1 DeepSeek-V3.1 for complex tasks · 0.14x/0.17x per Mtok
10. DeepSeek-R1 DeepSeek-R1 for complex tasks · 0.29x/0.29x per Mtok
11. Qwen Max Qwen Max for complex tasks · 0.17x/0.17x per Mtok
12. Qwen3 Coder Plus Qwen3 Coder Plus for complex tasks · 0.29x/0.29x per Mtok
13. Kimi K2 Kimi-K2 for complex tasks · 0.29x/0.29x per Mtok
14. Kimi-K2-Instruct-0905 Kimi-K2-Instruct-0905 for complex tasks · 0.29x/0.29x per Mtok
15. Kimi-K2-Thinking Kimi-K2-Thinking for complex tasks · 0.29x/0.29x per Mtok
16. Doubao Seed 1.6 DoubanSeed-1.6 for complex tasks · 0.06x/0.04x per Mtok
17. GLM 4.5 GLM-4.5 for complex tasks · 0.29x/0.29x per Mtok
18. GLM 4.6 GLM-4.6 for complex tasks · 0.4x/0.24x per Mtok
`$3
如果您对特定引擎有偏好，也可以直接指定子智能体启动：
bash
coder claude # 强制使用 Claude Code 引擎
coder codex # 强制使用 Codex 引擎
coder gemini # 强制使用 Google Gemini 引擎
`$3
* Claude Code + Claude Opus 4.5：目前最强编程能力，特别是后端和综合开发
* 命令行启动
* 选择模型 Claude Opus 4.5： 然后选择 Claude Opus 4.5
* Gemini CLI + Gemini 3.0 Pro：前端开发能力最强
* 命令行启动
* 选择模型 Gemini 3.0 Pro： 然后选择 Pro
* 示例：Gemini CLI + Gemini 3.0 Pro = 超级前端AI
* Codex CLI + GPT 5.2
* 命令行启动：最佳实践场景示例
Coder 能够处理从简单的脚本编写到复杂的全栈项目构建。以下是一些真实的指令示例，您可以直接复制运行。
$3
不想手动配置 Webpack 或 Vite？让 Coder 帮您瞬间搭建项目结构。
bash
生成一个带有 TailwindCSS 的 Vue3 登陆页面
coder "创建一个 Vue3 单页应用，使用 TailwindCSS，包含一个现代化的登录界面，背景要是深色科技风"
`$3
无需打开 Jupyter Notebook，直接在终端处理数据文件。
bash
假设当前目录下有一个 sales.csv 文件
coder "读取当前目录下的 sales.csv，分析每月的销售趋势，并使用 Matplotlib 生成一张折线图保存为 trend.png"
`$3
编写 Docker 配置或 Shell 脚本是 Coder 的强项。
bash
为当前 Node.js 项目生成 Docker 环境
coder "为这个项目编写一个 Dockerfile，基于 Node 18 Alpine 镜像，并生成一个包含 Redis 的 docker-compose.yml"批量处理文件
coder "编写一个 Shell 脚本，递归查找当前目录下所有大于 100MB 的日志文件并将其压缩，保留原始文件"
`$3
接手了别人的“屎山”代码？Coder 可以帮您阅读并优化。
bash
为代码添加注释和类型提示
coder "读取 utils.py，为所有函数添加 Python 类型提示(Type Hints)和详细的中文 Docstring 注释"解释复杂的正则表达式
coder "解释一下这个正则是什么意思：^([a-z0-9_\.-]+)@([\da-z\.-]+)\.([a-z\.]{2,6})$"
`$3
编写一次性的小工具，不用动脑，直接下令。
bash
编写一个简单的爬虫
coder "写一个 Python 脚本，抓取 Hacker News 首页的前 10 条新闻标题和链接，保存到 hn_top.md 文件中"
`进阶技巧：像专家一样使用 Coder
Coder 内置了强大的上下文管理和指令系统。不需要离开终端，您就可以完成从项目分析、代码查阅、修改到提交的全流程。掌握这些技巧，能让您在终端内的开发效率提升 10 倍。
$3
Coder 并不只是被动回答问题，它内置了一系列快捷指令来主动管理工作流。在交互模式下输入
即可唤起。#### 项目启动与维护
*
/init —— 项目初始化与全量分析 (推荐) 这是接手一个现有项目时的第一步。 运行 /init，Coder 会快速扫描整个项目结构，分析配置文件（如 package.json, requirements.txt, go.mod），并建立项目的“知识索引”。
作用*：让 AI 瞬间理解当前项目的技术栈、依赖库和目录架构，避免 AI 瞎编不存在的函数或库。
场景*：刚 Clone 下来一个开源项目，或者刚打开一个复杂的旧项目时。
* /compact —— 内存整理 当对话过长导致 Token 消耗过大（或变慢）时，使用此命令。它会“压缩”历史记忆，遗忘不重要的闲聊，仅保留核心的代码逻辑和文件上下文。
* /clear：清屏并开启一个新的对话会话（重置上下文）。#### Git 自动化工作流
Coder 深度集成了 git 工具链，从此告别繁琐的 git 命令行。
*
/git:commit —— 智能提交 Coder 会阅读您的 git diff，自动生成符合规范（Conventional Commits）的提交信息。
`bash
> /git:commit
# 🤖 提议提交信息: "feat(auth): implement JWT login logic and add unit tests"
# ❓ 确认提交? (Y/n)
`
* ：查看git修改状态。$3
显式地告诉 Coder “看哪里”，可以显著提高代码生成的准确度，并节省 Token 费用。
* 引用文件：
`bash
# 语法：coder "指令" @文件名
coder "解释这两个文件的调用关系，并修复循环引用" @src/main.py @src/utils.py
`
* 引用目录：
bash
coder "根据这个模块的代码，为我生成一个 Swagger API 文档" @src/controllers/
`常见问题 (FAQ)
Q: Windows 上运行
报错 Child process exited with code: 3221225781？A: 这是由于系统缺少 C++ 运行库。
* 解决方法: 下载并安装 Visual C++ Redistributable (x64)。安装后重启 Git Bash 即可。
Q: 如何升级 Coder？
A: 重新运行安装命令即可覆盖更新：
npm install -g https://makecoder.com/download/makecoder-coder-latest`Q: 遇到其他问题？
A: 您可以访问 MakeCoder 官网 直接询问 AI 客服。