====== huanyuf-helper 一键配置工具使用教程 ======

''huanyuf-helper'' 是一个 npx 工具，可以自动将本站的 API 配置写入主流 AI 编程工具，省去手动改配置文件的麻烦。

===== 支持的工具 =====

^ 工具名 ^ 说明 ^ 配置方式 ^
| ''claude'' | Claude Code（Anthropic 官方 CLI） | 自动配置 |
| ''droid'' | Droid（Factory AI 编程工具） | 自动配置 |
| ''openclaw'' | OpenClaw / Moltbot | 自动配置 |
| ''opencode'' | OpenCode（终端 AI 编码助手） | 自动配置 |
| ''continue'' | Continue（VS Code/JetBrains 插件） | 自动配置 |
| ''codex'' | Codex CLI（OpenAI 命令行工具） | 自动配置 |
| ''cursor'' | Cursor（AI 代码编辑器，需 Pro 订阅） | 需手动配置 |
| ''cline'' | Cline（VS Code AI 编程插件） | 需手动配置 |

===== 使用方法 =====

== 交互式向导（推荐） ==

直接运行，按提示操作：

<code bash>
npx huanyuf-helper@latest
</code>

运行后会有交互式向导：
  - 输入你的 API Key
  - 勾选要配置的工具（可多选）
  - 自动写入配置，完成！

<note tip>建议用 ''@latest'' 确保使用最新版本。</note>

== 配置单个工具 ==

直接指定工具名，跳过选择步骤：

<code bash>
npx huanyuf-helper@latest config droid
npx huanyuf-helper@latest config openclaw
npx huanyuf-helper@latest config continue
</code>

== 查看配置状态 ==

<code bash>
npx huanyuf-helper@latest status
</code>

== 撤销配置 ==

<code bash>
# 撤销单个工具
npx huanyuf-helper@latest revoke droid

# 撤销全部
npx huanyuf-helper@latest revoke
</code>

===== 准备工作 =====

你需要一个本站的 API Key。

登录 [[https://huanyuf.top|本站]] 后，在令牌页面创建 API Key。

===== 常见问题 =====

**Q: 提示 401 错误？**

A: API Key 填错了。去 [[https://huanyuf.top|令牌页面]] 重新生成一个。

----

**Q: 配置后模型不出现？**

A: 尝试重启对应工具。如果还是不行，运行 ''status'' 命令检查配置是否写入成功。

----

**Q: cursor / cline 提示需要手动配置？**

A: 这两个工具的配置在 GUI 里，''huanyuf-helper'' 无法自动写入。参考对应工具的手动配置教程。