配置

minacode 默认读取 ~/.minacode/config.toml。使用 minacode --init-config 生成带注释的初始配置，或通过 --config <path> 指定其他文件。

只有 [provider] 是必需的。其他配置项都会使用内置默认值，因此最小配置只需一个 provider。随时可以用 /config 查看解析后的完整配置。

Provider

定义一个或多个 [provider.<name>]，再通过 [provider] active 选择当前 provider：

[provider]
active = "default"

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

在 session 中使用 /provider [NAME] 切换 provider，使用 /model [MODEL] 切换模型。

Provider 选项

配置项	默认值	含义
url	—	API 的 base URL
key	—	API key
model	—	模型名称
api	auto	请求格式：auto、anthropic 或 chat；auto 根据 host 和模型选择。
reasoning	medium	Reasoning effort：off、minimal、low、medium、high、xhigh
chat_reasoning	auto	Chat API reasoning 格式：auto、off、reasoning、reasoning_effort、thinking 或 enable_thinking
prompt_cache_key	auto	稳定的 prompt-cache key；设为 off 可关闭，也可提供自定义值
timeout	180	请求超时秒数
available_models	—	/model 选择器中显示的模型
temperature	—	Sampling temperature；省略则使用 server 默认值
max_tokens	—	输出 token 上限，自动 compaction 时会预留这部分空间
strict_tools	false	在支持的 API（OpenAI、DeepSeek）上使用严格 tool-call schema；可通过 /strict 切换

对于已知 host，auto 会选择合理默认值，所以通常只需填写 url、key 和 model。显式设置的值始终优先。已测试 DeepSeek、OpenCode、阿里云和 ZenMux；其他 OpenAI-compatible 与 Anthropic endpoint 也可以使用。

Runtime

以下设置均可省略，表中列出其默认值。

配置项	默认值	含义
yolo	false	启动时关闭确认提示
max_context_tokens	245760（240K）	用于计算自动 compaction 预算的 context 总上限
max_agent_steps	200	单轮任务的最大工具步数
shell_timeout	60	shell 命令最大运行秒数
bash_wait_timeout	10	前台命令转为后台任务前的等待秒数；0 表示禁用
max_parallel_tools	4	并发执行只读工具的上限；1 表示禁用并发
session_retention_days	7	启动时删除超过该天数未使用的 session；0 表示永久保留
theme	auto	终端主题：auto、light 或 dark；--theme 可覆盖

部分配置可以用 /set 在当前 session 中修改，按 Tab 可补全支持的 key。/yolo 用于切换 yolo。

数据目录

[paths]
data_dir = "~/.minacode"   # sessions, code index, OAuth tokens, user skills, update cache

Session 保存在 <data_dir>/projects/<project>/，每个工作目录对应一个子目录，其中存放该项目的 session 日志和 latest 指针，因此恢复操作始终限定在所属项目内。当某个项目的最后一个 session 过期后，对应目录会被一并删除。