文档

Coder 超级编程智能体

由coder创建,最终由coder 被浏览 98 用户

简介

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

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

环境准备

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

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 作为默认终端,以获得最佳的交互体验。

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

    winget install --id Git.Git -e
    
  2. 使用提示: 安装完成后,请在 Git Bash 窗口中运行后续的所有 npmcoder 命令。

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


下载与安装

安装 Coder CLI

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

npm install -g https://makecoder.com/download/makecoder-coder-latest
  • -g: 表示全局安装,允许在任何目录下使用 coder 命令。
  • makecoder-coder-latest: 始终指向官方最新版本。

验证安装:

coder --version
# 输出示例: 1.0.6

账号认证

连接 Coder 到您的 MakeCoder 云端账户。

  1. 登录 MakeCoder 控制台
  2. 点击 "创建" 并复制 API Key。
  3. 在终端运行以下命令:
coder --save-auth --aksk <粘贴您的_API_KEY>

成功提示: 终端显示 ✅ 认证信息已保存到配置文件 即表示连接成功。


核心用法

交互模式 (Interactive Mode)

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

coder

单任务模式 (Task Mode)

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

# 示例:生成算法文件
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

(支持 Claude 4.5, GPT-5, DeepSeek-V3, Qwen Max 等全球最新模型)

调用特定智能体

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

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

好的,为了让用户更直观地感受到 Coder 的强大,我们可以增加一个**“最佳实践场景 (Use Cases)”**章节。

这些示例涵盖了前端开发、后端脚本、数据分析、运维部署以及旧代码重构等常见场景。您可以直接将以下内容添加到文档的“使用”或“示例”部分。

模型与引擎推荐

  • 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
    • 开启早期预览功能:/settings 确认 Preview Features (e.g., models) 是开启的 true。空格键可以切换状态。
    • 选择模型 Gemini 3.0 Pro Preview:/model 然后选择 Pro (gemini-3-pro-preview, gemini-2.5-pro)
    • 示例:Gemini CLI + Gemini 3.0 Pro = 超级前端AI

最佳实践场景示例

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}){seo}quot;

爬虫与工具脚本

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

# 编写一个简单的爬虫
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++ 运行库。

Q: 如何升级 Coder?

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

Q: 遇到其他问题?

A: 您可以访问 MakeCoder 官网 直接询问 AI 客服。

文档

CursorCodex CLIGemini CLIClaude Code
评论
  • 推荐试一试 Claude Opus 4.5,目前地球上最强的编程模型,比上一版本降价 2/3,可以用了
{link}