# Coder 超级编程智能体

## 简介

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

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

 ![](https://makecoder.com/wiki/api/attachments.redirect?id=5334c126-432d-4074-82e5-928bd503ace3)

## 环境准备

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

### Node.js 环境 (必须)

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

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

> 🤖 **遇到困难？** [点击查看 AI 详细安装指导](https://makecoder.com/chat/share/0aeb363f-334e-4fc9-b59c-c70d5003d371)

### Git Bash (Windows 用户必读)

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


1. **安装 Git Bash** (如果未安装): 打开 PowerShell 运行:

   ```powershell
   winget install --id Git.Git -e
   ```
2. **使用提示**: 安装完成后，请在 **Git Bash** 窗口中运行后续的所有 `npm` 和 `coder` 命令。

> 🤖 **遇到困难？** [点击查看 Windows 环境配置 AI 解答](https://makecoder.com/chat/share/d2955b52-3da4-4ece-b71c-c0bccc3747d5)


-----

## 安装

### 安装 Coder CLI

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

```bash
npm install -g makecoder

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

* 升级安装 `npm install -g makecoder@latest`
* `-g` 表示全局安装，允许在任何目录下使用 `coder` 命令。
* [国内 npm 安装加速](https://makecoder.com/chat/share/bf28a2af-4a39-4881-89c0-2552450c6c74) `npm install -g makecoder --registry=https://registry.npmmirror.com`

### 账号认证

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

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

* [MakeCoder 控制台](https://makecoder.com/my/apikeys) > 创建 **>** 复制 API Key
* 在终端运行以下命令：`coder --save-auth --apikey <粘贴您的_API_KEY>`

## 核心用法

### 交互模式

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

```bash
coder
```

### 单任务模式

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

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

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

### 切换模型内核

在交互模式中，输入 `/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
```

### 调用特定智能体

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

```bash
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](https://makecoder.com/wiki/doc/Si5zJrirEa)
* Codex CLI + GPT 5.2
  * 命令行启动：`coder codex`

## 最佳实践场景示例

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

### Web开发快速脚手架

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

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

### 数据分析与可视化

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

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

### 运维与自动化

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

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

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

### 代码重构与解释

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

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

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

### 爬虫与工具脚本

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

```bash
# 编写一个简单的爬虫
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）的提交信息。

  ```bash
  > /git:commit
  # 🤖 提议提交信息: "feat(auth): implement JWT login logic and add unit tests"
  # ❓ 确认提交? (Y/n)
  ```
* `/git:status`：查看git修改状态。

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

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

* **引用文件**：

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

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

## 常见问题 (FAQ)

**Q: Windows 上运行** `coder codex` 报错 `Child process exited with code: 3221225781`？

**A:** 这是由于系统缺少 C++ 运行库。

* **解决方法**: 下载并安装 [Visual C++ Redistributable (x64)](https://aka.ms/vs/17/release/vc_redist.x64.exe)。安装后重启 Git Bash 即可。

**Q: 如何升级 Coder？**

**A:** 重新运行安装命令即可覆盖更新： `npm install -g https://makecoder.com/download/makecoder-coder-latest`

**Q: 遇到其他问题？**

**A:** 您可以访问 [MakeCoder 官网](https://makecoder.com/) 直接询问 AI 客服。