Matcha CLI · 现已推出

MatchaCode

从想法到能跑的代码

更从容地写代码。

在终端里读懂仓库、规划改动、写出功能，并跑完测试。模型随你选。

curl -fsSL https://cli.matchacode.net/install.sh | bash

macOS 与 Linux。本地运行，模型随你选。

探索示例作品
AI 生成的建筑网站效果图：米白排版、庭院住宅照片与项目目录。
作品与可能

作品与可能

从一个想法，展开更多可能

一个有个性的网站，一处清楚的数据视图，或一个顺手的小工具。从你想做的事开始。

AI 生成的建筑网站效果图：米白排版、庭院住宅照片与项目目录。
01品牌网站

为好作品，留出空间

自然光、细腻的材质与有呼吸感的排版，让作品成为主角。

示例任务为建筑工作室制作响应式作品集。

AI 生成的数据看板效果图：访问指标、灰蓝趋势曲线与来源图表。
02业务应用

让数据一目了然

把趋势、来源和关键指标，整理成一处清楚的视图。

示例任务为数据看板添加趋势分析和日期筛选。

AI 生成的移动端预约网页效果图：工作室照片、日期、可选时段和确认摘要。
03移动端网页

把每一步，安排妥当

从选择日期到确认时段，让小屏幕上的流程也从容清晰。

示例任务完善预约流程与提交状态，适配手机布局。

AI 生成的 JSON 工具效果图：深色界面并列展示输入、格式化结果与校验状态。
04开发者工具

做一个真正顺手的工具

输入、整理、检查。在简单的界面里，把一件事做好。

示例任务制作 JSON 格式化与校验工具。

探索更多使用场景看看它怎么工作

工作区

从一句请求，到一次完成

读仓库、写方案、改文件、跑测试。在终端里，把一件事做完。

工作流程示意
阅读演示文字

给 API 加上限流，并补好测试。

读取

正在读取 src/api/route.ts、src/api/route.test.ts 与 AGENTS.md

方案

  1. 在 handler 外包一层限流
  2. 补测试，保留现有断言

改动

- export const POST = handler+ export const POST = withRateLimit(handler)

测试

npm test

限流已加入，12 个测试通过。

功能

它能做什么

功能示意

  1. 展开的纸面由一条绿色路径相连，示意仓库的代码结构。
    src/
    index.tsformat.ts
    01

    读懂仓库

    读文件、搜索代码，弄清项目在做什么。

  2. 两层错开的纸面嵌入一条绿色纸带，示意精确的代码改动。
    format.ts
    return name;return name.trim();
    02

    写功能、改代码

    直接修改文件，改动会以行内 diff 呈现。

  3. 三级纸台阶通向玻璃门槛，示意等待批准的计划。
    1. 读取
    2. 计划
    3. 批准
    等待你的批准
    03

    先计划再改

    方向还不清楚时，先读代码、写方案，你同意后再动手。

  4. 整齐的纸块中有一块偏离原位，示意需要修复的测试。
    format.test.ts
    失败 通过
    04

    修测试、看失败

    运行命令和测试，检查结果，再从失败处接着改。

  5. 两种可替换的结构置于连续轨道上，示意在同一会话中切换模型。
    模型 A模型 B
    同一会话
    05

    切换模型

    在会话中指定模型名称，换用已配置服务商提供的模型。

  6. 纸质规则和工具模块连接石墨色工作台，示意项目规则与工具。
    项目
    AGENTS.mdMCP技能
    06

    沿用规则和工具

    读取项目规则，并通过 MCP 与 skills 连接已有工具。

模型

模型随你选

带上 API Key，接入 xAI、OpenAI、Anthropic，或使用 Ollama 与其他兼容端点。

MatchaCode 不是模型厂商。下列名称是开源、闭源、本地与聚合平台的例子，不是官方服务商清单，也不构成背书。

约定

始终由你掌握

Matcha CLI 在你的机器上运行。没有 MatchaCode 账号，也没有官方云。

存放位置与请求去向 · 示意
  • ~/.matcha/├─ sessions/├─ rules/└─ config.toml

    在本机

    会话和规则留在本地

    保存在你机器上的 ~/.matcha，和配置放在一起。

  • matcha

    请求

    响应

    你的服务商

    云端 API · 本地 Ollama

    请求发往你选的服务商

    用自己的密钥接云端 API，或用本地 Ollama。

  • # ~/.matcha/config.toml[permission]allow = ["Bash(npm test)"]ask   = ["Bash(git push *)"]deny  = ["Bash(rm -rf *)"]

    deny > ask > allow

    改动与命令按你的权限执行

    先选权限模式，再加允许、询问或拒绝规则。

迁移

原来的规则可以接着用

Matcha CLI 读取其他助手已经在用的约定，不必从零重写。

  1. 01

    按原样读取这些规则文件

    AGENTS.mdCLAUDE.mdCursor rules
  2. 02

    先预览再导入配置

    /import-claude

    预览导入

  3. 03

    接着上次的会话

    /resume-cursor/resume-claude/resume-codex

CLI

在终端里工作

  1. 01

    在仓库里工作

    用 @ 带上文件。diff、命令、任务列表都在同一段对话里。

    matcha "fix the failing auth test and run it"
  2. 02

    接着上次的会话

    /resume 打开上次的会话。matcha -c 继续最近一次。也可以退回上一步。

    matcha -c
  3. 03

    先计划再动手

    还不确定时先读代码、写方案。你同意后再改。

    /plan
  4. 04

    会话中切换模型

    指定已配置服务商提供的模型名称，接着当前工作继续。

    /model grok-4.5

产品形态

CLI 现已可用

  • CLI

    现已推出

    在终端里读仓库、改文件、跑命令。

    下载

  • IDE 插件

    即将推出

    同一套助手，在编辑器里继续工作。

  • 桌面应用

    即将推出

    在桌面上继续工作。

  • 移动应用

    即将推出

    以后可以在手机上接着做同一件事。

开始

开始使用

下载 CLI，选好模型即可开始。目前主要支持 macOS 和 Linux。

curl -fsSL https://cli.matchacode.net/install.sh | bash

MatchaCode 本身暂不收费。没有账号，也没有官方云。模型费用由你选择的服务商收取。