本页内容

快速开始

连接一个模型,进入你的项目。让 Mica 从理解代码开始,接着完成修改和验证。

本文档以当前仓库源码为准;已发布 CLI 的功能可能有所不同。可以通过 mica --version 查看版本,并对照Release 说明。

1. 安装 CLI

macOS 与 Linux 使用预构建安装器,支持 Apple Silicon、Intel Mac,以及 ARM64 / x64 Linux:

TERMINAL
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 配置:

TERMINAL
export PATH="$HOME/.local/bin:$PATH"

升级到最新发布版本时,重新运行安装命令即可。也可以在 GitHub Releases 选择对应平台的归档。

从源码运行

需要参与开发或使用 Windows 时,通过源码入口启动:

TERMINAL
git clone https://github.com/qirong77/mica-code.git
cd mica-code
bun install
bun run dev

上面的 bun run dev 在源码仓库中启动终端 TUI,因此默认工作目录也是该仓库。要从源码在另一个项目中工作, 先进入目标项目,再通过绝对路径启动入口:

TERMINAL
# 将路径替换为本机的项目目录和 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 打开配置页。如果使用源码入口,沿用上面指定目标项目的启动方式:

TERMINAL
cd your-project
mica
  1. 填写 provider。配置 API 地址与 API key。默认配置提供 DeepSeek 入口,也可以接入自己的兼容服务。
  2. 选择正确的协议。openai_chat_completions 对应 Chat Completions;openai_responses 对应 Responses。按服务实际支持的接口填写。
  3. 配置并选择模型。在 provider 中填写服务提供的模型 ID(models),再回到终端用 /model 选择。Mica 不会从服务商自动拉取可选模型。

配置页自动保存有效设置。API 地址、协议与模型配置的完整示例见模型与配置。

3. 完成第一个任务

从范围明确、可以运行验证的任务开始。例如:

发给 Mica 的任务
阅读项目结构和测试配置,找出测试入口。
先说明你准备怎么改,再为一个边界情况补充测试,运行验证并汇报结果。

运行过程中会看到思考、工具调用和执行结果。输入 @ 可以引用工作区文件,继续输入则可以补充要求。完成后查看改动和测试输出,再决定是否提交。

你想做什么怎么操作
补充要求运行中提交消息,在工具迭代边界进入当前任务。
撤回待发消息输入框为空时按 Shift+←。
停止当前任务终端按 Ctrl+C,桌面点击停止。
确认模型和用量终端使用 /status,/context 查看上下文占用。
下次继续使用 /resume,或在桌面侧栏打开历史会话。

配置与会话放在哪里

默认用户目录是 ~/.mica。模型配置在 config.json,会话在 sessions/,个人 Skills 在 skills/。终端与桌面共用同一份用户数据。

需要隔离项目或测试环境时,启动前设置 MICA_HOME:

TERMINAL
MICA_HOME="$HOME/.mica-work" mica

这个目录会同时隔离用户配置、会话与个人扩展。项目目录里的 Skills 和项目指令仍按当前工作目录发现。

遇到问题

  • 无法连接模型:核对 API 地址、协议、key 和服务商返回的错误,见连接排查。
  • PTY 或 npx 无法运行:确认启动 Mica 的环境能找到 Node.js 22+ 和 npm。
  • 行为与预期不同:用 mica --version 确认版本;源码开发中修改 CLI 后需要重新构建已安装的入口。

接下来

文档随项目持续更新编辑此页