快速开始
连接一个模型,进入你的项目。让 Mica 从理解代码开始,接着完成修改和验证。
本文档以当前仓库源码为准;已发布 CLI 的功能可能有所不同。可以通过 mica --version 查看版本,并对照Release 说明。
1. 安装 CLI
macOS 与 Linux 使用预构建安装器,支持 Apple Silicon、Intel Mac,以及 ARM64 / x64 Linux:
curl -fsSL https://github.com/qirong77/mica-code/releases/latest/download/install.sh | sh
mica --version看到版本号就表示命令已可用。预构建 CLI 无需 Bun;安装器会校验 SHA-256,将程序与随包依赖放在 ~/.local/lib/mica,入口是 ~/.local/bin/mica。
如果提示找不到 mica,在当前终端补上 PATH,并将相同设置加入自己的 shell 配置:
export PATH="$HOME/.local/bin:$PATH"升级到最新发布版本时,重新运行安装命令即可。也可以在 GitHub Releases 选择对应平台的归档。
从源码运行
需要参与开发或使用 Windows 时,通过源码入口启动:
git clone https://github.com/qirong77/mica-code.git
cd mica-code
bun install
bun run dev上面的 bun run dev 在源码仓库中启动终端 TUI,因此默认工作目录也是该仓库。要从源码在另一个项目中工作, 先进入目标项目,再通过绝对路径启动入口:
# 将路径替换为本机的项目目录和 mica-code 仓库绝对路径
cd /path/to/your-project
bun run /path/to/mica-code/apps/cli/src/index.ts上面是 POSIX shell 写法;Windows 用户可在 PowerShell 中换成本机的项目目录和源码入口绝对路径。
macOS / Linux 开发者也可在源码仓库运行 bun run build 构建并安装 CLI,之后在任意项目中使用 mica。构建的安装步骤默认写入 ~/.local/lib/mica、~/.local/bin, 并可能更新 shell 的 PATH 配置。
发布安装器目前提供 macOS / Linux 包;源码构建的自动安装步骤会生成 POSIX launcher,Windows 请使用上面的源码运行入口。
2. 连接模型
安装 CLI 后在项目目录启动 Mica,再通过终端里的 /config 打开配置页。如果使用源码入口,沿用上面指定目标项目的启动方式:
cd your-project
mica- 填写 provider。配置 API 地址与 API key。默认配置提供 DeepSeek 入口,也可以接入自己的兼容服务。
- 选择正确的协议。
openai_chat_completions对应 Chat Completions;openai_responses对应 Responses。按服务实际支持的接口填写。 - 配置并选择模型。在 provider 中填写服务提供的模型 ID(
models),再回到终端用/model选择。Mica 不会从服务商自动拉取可选模型。
配置页自动保存有效设置。API 地址、协议与模型配置的完整示例见模型与配置。
3. 完成第一个任务
从范围明确、可以运行验证的任务开始。例如:
阅读项目结构和测试配置,找出测试入口。
先说明你准备怎么改,再为一个边界情况补充测试,运行验证并汇报结果。运行过程中会看到思考、工具调用和执行结果。输入 @ 可以引用工作区文件,继续输入则可以补充要求。完成后查看改动和测试输出,再决定是否提交。
| 你想做什么 | 怎么操作 |
|---|---|
| 补充要求 | 运行中提交消息,在工具迭代边界进入当前任务。 |
| 撤回待发消息 | 输入框为空时按 Shift+←。 |
| 停止当前任务 | 终端按 Ctrl+C,桌面点击停止。 |
| 确认模型和用量 | 终端使用 /status,/context 查看上下文占用。 |
| 下次继续 | 使用 /resume,或在桌面侧栏打开历史会话。 |
配置与会话放在哪里
默认用户目录是 ~/.mica。模型配置在 config.json,会话在 sessions/,个人 Skills 在 skills/。终端与桌面共用同一份用户数据。
需要隔离项目或测试环境时,启动前设置 MICA_HOME:
MICA_HOME="$HOME/.mica-work" mica这个目录会同时隔离用户配置、会话与个人扩展。项目目录里的 Skills 和项目指令仍按当前工作目录发现。
遇到问题
- 无法连接模型:核对 API 地址、协议、key 和服务商返回的错误,见连接排查。
- PTY 或 npx 无法运行:确认启动 Mica 的环境能找到 Node.js 22+ 和 npm。
- 行为与预期不同:用
mica --version确认版本;源码开发中修改 CLI 后需要重新构建已安装的入口。