快速开始
添加一个 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,令牌只显示“已设置”,不会显示内容。
运行第一个任务
进入一个项目目录,用 exec 运行一轮对话:
cd ~/src/my-project
hanafubuki-agent exec "解释这个仓库是做什么的"exec 把过程打印到终端,回合结束后退出。默认情况下,所有需要审批的操作都会被拒绝,模型会得知这一点并继续,所以这一步不会修改任何东西。更多用法见 exec。
打开终端界面
hanafubuki-agent在底部的输入框中输入消息,按 Enter 发送。需要审批的操作会弹出确认:按 y 允许一次,按 n 或 Esc 拒绝。输入 / 查看所有命令,按两次 Ctrl-C 或输入 /quit 退出。
下次想继续这次对话时,运行 hanafubuki-agent resume --last。