hanafubuki-agent

快速开始

添加一个 Provider,选择模型,运行第一个任务,再打开终端界面。

下面的步骤以 OpenAI 为例。其他服务和本地推理服务的设置方法相同,只是地址和协议不同,详见 Provider 与模型。

也可以在界面中设置

不必先添加 Provider:在什么都没有配置时运行 hanafubuki-agent,会在 Provider 处打开设置中心,在其中添加一个 Provider 并填写地址和令牌、测试它并选择模型,完成后第一条消息就会运行(见首次设置)。下面的步骤在命令行中完成同样的设置。

准备 API 令牌

把令牌放进一个环境变量。providers add 只从环境变量读取令牌,不接受在命令行上直接写出,以免令牌留在 Shell 历史中。

export OPENAI_API_KEY=sk-...

添加 Provider

hanafubuki-agent providers add OpenAI --base-url https://api.openai.com/v1 --api-key-env OPENAI_API_KEY

命令会打印新 Provider 的 ID,例如 added provider-1。第一个添加的 Provider 自动成为默认 Provider。

令牌在添加时从环境变量读出,保存到配置目录的 providers.toml 中(在 Unix 上只有你自己可以读取),之后不再需要这个环境变量。

选择模型

hanafubuki-agent providers default provider-1 --model gpt-5.1
hanafubuki-agent providers list

--model 设置新会话默认使用的模型。providers list 显示当前模型和每个 Provider,令牌只显示“已设置”,不会显示内容。

检查环境

hanafubuki-agent doctor

每项检查打印一行 ok、FAIL 或 skip。加上 --online 还会实际连接默认 Provider,列出它的模型。各项的含义见故障排查。

运行第一个任务

进入一个项目目录,用 exec 运行一轮对话:

cd ~/src/my-project
hanafubuki-agent exec "解释这个仓库是做什么的"

exec 把过程打印到终端,回合结束后退出。默认情况下,所有需要审批的操作都会被拒绝,模型会得知这一点并继续,所以这一步不会修改任何东西。更多用法见 exec。

打开终端界面

hanafubuki-agent

在底部的输入框中输入消息,按 Enter 发送。需要审批的操作会弹出确认:按 y 允许一次,按 n 或 Esc 拒绝。输入 / 查看所有命令,按两次 Ctrl-C 或输入 /quit 退出。

下次想继续这次对话时,运行 hanafubuki-agent resume --last。

接下来

本页目录