快速开始

安装

  • minacode 仅支持 macOS 和 Linux

  • Python 3.11 或更新版本

  • 使用 uv 安装和运行

uv tool install minacode

升级

uv tool upgrade minacode

minacode 每天最多检查一次 PyPI；有新版本时，会在启动时和 /status 中提示。

配置

minacode 启动只需要一项配置：用于通信的 provider。先生成配置文件：

minacode --init-config

该命令会写入 ~/.minacode/config.toml。只有 [provider] 是必需的；其他设置都有内置默认值，常用选项会以注释形式列在文件中。

设置 provider

minacode 支持任何 OpenAI-compatible API，也直接支持 Anthropic。打开配置文件并填写一个 provider，例如 DeepSeek：

[provider]
active = "default"

[provider.default]
url = "https://api.deepseek.com"
key = "sk-..."
model = "deepseek-v4-flash"

配置项

含义

url

API 的 base URL

key

你的 API key

model

使用的模型名称

可以定义多个 [provider.<name>]，通过 active 选择；也可以在 session 中使用 /provider 切换。所有选项（包括 reasoning effort 和 host 专属设置）见配置。

启动 session

minacode

直接用自然语言输入任务，agent 就会开始读取文件、提出修改并运行命令。任何会修改文件或执行命令的操作都会先请求确认，除非使用 --yolo。agent 工作时仍可继续输入；见追加指令。

使用 /exit、/quit 或 Ctrl-D 退出。

命令行参数

参数

作用

-c, --last, --latest

恢复当前项目最近一次 session

--resume [UID]

恢复保存的 session；不提供 UID 时恢复本项目最近一次

--yolo

跳过修改型工具的确认提示

--theme {auto,light,dark}

覆盖终端颜色主题

--config <path>

使用指定配置文件，而不是 ~/.minacode/config.toml

--init-config

写入初始配置后退出

-h, --help

显示命令行帮助后退出

-v, --version

输出版本号后退出