makecoder

v1.0.36

Published

6 days ago

MakeCoder: Unified AI agent CLI tool integrating Claude Code, Codex and Gemini CLI

Downloads

1,076

0High
0Medium
0Low

makecoder

cli ai claude gemini agent

Coder 超级编程智能体

简介

Coder 是 MakeCoder 平台的核心生产力工具。它是一个运行在终端的超级编程智能体。

多智能体引擎 (Multi-Agent)：内置并自动调度 Claude Code, Codex CLI, Gemini CLI 等顶尖编程引擎。
零配置 (Zero-Config)：无需配置Claude Code等，开箱即用。
全栈能力：支持文件读写、命令执行、代码重构与自动排错。可用于AI编程、AI运维、AI营销等全场景。

环境准备

在安装 Coder CLI之前，请确保您的电脑满足以下要求。

Node.js 环境 (必须)

Coder 依赖 Node.js 运行。推荐安装 v20 或更高版本。

| 操作系统 | 安装方式 | |:---|:---| | macOS | 推荐使用 Homebrew: brew install node | | Windows | 访问 Node.js 官网下载安装包 (LTS版本) | | Linux | 使用 apt: sudo apt install nodejs npm 或使用 nvm 管理 |

🤖 遇到困难？ 点击查看 AI 详细安装指导

Git Bash (Windows 用户必读)

如果您使用的是 Windows 系统，强烈建议安装并使用 Git Bash 作为默认终端，以获得最佳的交互体验。

安装 Git Bash (如果未安装): 打开 PowerShell 运行:
```
winget install --id Git.Git -e
```
使用提示: 安装完成后，请在 Git Bash 窗口中运行后续的所有 npm 和 coder 命令。

🤖 遇到困难？ 点击查看 Windows 环境配置 AI 解答

安装

安装 Coder CLI

使用 npm 全局安装最新版 Coder：

npm install -g makecoder

# 查看安装的版本
coder --version

升级安装 npm install -g makecoder@latest
-g 表示全局安装，允许在任何目录下使用 coder 命令。
国内 npm 安装加速 npm install -g makecoder --registry=https://registry.npmmirror.com

账号认证

如果未认证，运行 coder 会自动打开浏览器引导登录认证。

也可以手动创建API Key来认证：

MakeCoder 控制台 > 创建 > 复制 API Key
在终端运行以下命令：coder --save-auth --apikey <粘贴您的_API_KEY>

核心用法

交互模式

直接输入 coder 进入沉浸式编程对话。Coder 会记住上下文，适合处理复杂的重构任务。

coder

单任务模式

通过命令行参数直接下达指令，适合快速生成脚本或文件。

# 示例：生成算法文件
coder "使用 Python 编写一个快速排序算法并输出到 sort.py 文件"

参数技巧:
- -p: 执行完成后自动退出 (Print & Exit)，不进入交互模式。

切换模型内核

在交互模式中，输入 /model 即可切换底层驱动的大模型。

/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

调用特定智能体

如果您对特定引擎有偏好，也可以直接指定子智能体启动：

coder claude   # 强制使用 Claude Code 引擎
coder codex    # 强制使用 Codex 引擎
coder gemini   # 强制使用 Google Gemini 引擎

模型与引擎推荐

Claude Code + Claude Opus 4.5：目前最强编程能力，特别是后端和综合开发
- 命令行启动 coder claude
- 选择模型 Claude Opus 4.5：/model 然后选择 Claude Opus 4.5
Gemini CLI + Gemini 3.0 Pro：前端开发能力最强
- 命令行启动 coder gemini
- 选择模型 Gemini 3.0 Pro：/model 然后选择 Pro
- 示例：Gemini CLI + Gemini 3.0 Pro = 超级前端AI
Codex CLI + GPT 5.2
- 命令行启动：coder codex

最佳实践场景示例

Coder 能够处理从简单的脚本编写到复杂的全栈项目构建。以下是一些真实的指令示例，您可以直接复制运行。

Web开发快速脚手架

不想手动配置 Webpack 或 Vite？让 Coder 帮您瞬间搭建项目结构。

# 生成一个带有 TailwindCSS 的 Vue3 登陆页面
coder "创建一个 Vue3 单页应用，使用 TailwindCSS，包含一个现代化的登录界面，背景要是深色科技风"

数据分析与可视化

无需打开 Jupyter Notebook，直接在终端处理数据文件。

# 假设当前目录下有一个 sales.csv 文件
coder "读取当前目录下的 sales.csv，分析每月的销售趋势，并使用 Matplotlib 生成一张折线图保存为 trend.png"

运维与自动化

编写 Docker 配置或 Shell 脚本是 Coder 的强项。

# 为当前 Node.js 项目生成 Docker 环境
coder "为这个项目编写一个 Dockerfile，基于 Node 18 Alpine 镜像，并生成一个包含 Redis 的 docker-compose.yml"

# 批量处理文件
coder "编写一个 Shell 脚本，递归查找当前目录下所有大于 100MB 的日志文件并将其压缩，保留原始文件"

代码重构与解释

接手了别人的“屎山”代码？Coder 可以帮您阅读并优化。

# 为代码添加注释和类型提示
coder "读取 utils.py，为所有函数添加 Python 类型提示(Type Hints)和详细的中文 Docstring 注释"

# 解释复杂的正则表达式
coder "解释一下这个正则是什么意思：^([a-z0-9_\.-]+)@([\da-z\.-]+)\.([a-z\.]{2,6})$"

爬虫与工具脚本

编写一次性的小工具，不用动脑，直接下令。

# 编写一个简单的爬虫
coder "写一个 Python 脚本，抓取 Hacker News 首页的前 10 条新闻标题和链接，保存到 hn_top.md 文件中"

进阶技巧：像专家一样使用 Coder

Coder 内置了强大的上下文管理和指令系统。不需要离开终端，您就可以完成从项目分析、代码查阅、修改到提交的全流程。掌握这些技巧，能让您在终端内的开发效率提升 10 倍。

内置 `/` 指令系统

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）的提交信息。
```
> /git:commit
# 🤖 提议提交信息: "feat(auth): implement JWT login logic and add unit tests"
# ❓ 确认提交? (Y/n)
```
/git:status：查看git修改状态。

使用 `@` 精准引用上下文

显式地告诉 Coder “看哪里”，可以显著提高代码生成的准确度，并节省 Token 费用。

引用文件：

# 语法：coder "指令" @文件名
coder "解释这两个文件的调用关系，并修复循环引用" @src/main.py @src/utils.py

引用目录：

coder "根据这个模块的代码，为我生成一个 Swagger API 文档" @src/controllers/

常见问题 (FAQ)

Q: Windows 上运行 coder codex 报错 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 客服。