PokeAPI

主题

Reasonix 接入教程 ​

Reasonix 是一款面向终端、桌面端和编辑器的开源编程 Agent，支持添加 OpenAI-compatible 与 Anthropic-compatible Provider。本文说明如何把 Poke API 配置为 Reasonix 的模型服务。

本文按 Reasonix CLI / Desktop 1.19.1 的当前配置方式编写并验证，日期为 2026-08-02。Reasonix 更新较快；如果本机字段名称略有变化，请以“Provider、API 地址、模型、API Key”这些配置语义为准。

Reasonix 的 Base URL 是例外

在 Reasonix 中配置 OpenAI-compatible Provider 时，必须填写：

text
https://www.poke2api.com/v1

Reasonix 会在这个地址后追加 /chat/completions。如果只填 https://www.poke2api.com，实际请求会缺少 /v1，通常返回 404。

一、准备 ​

开始前请准备：

  1. 一个可用的 Poke API Key；
  2. 该 Key 所属分组可以使用的模型名称；
  3. 已安装 Node.js。通过 npm 安装 Reasonix 时，当前包要求 Node.js 18 或更高版本；没有环境时先阅读 Node.js 环境安装。

不要把真实 API Key 写入项目文件、聊天记录、截图或 Git 仓库。Reasonix 会把 Provider 配置与密钥分开保存。

二、安装 Reasonix ​

在 PowerShell、Terminal 或其他终端中执行：

bash
npm install -g reasonix
reasonix --version

安装成功后会输出类似：

text
reasonix v1.19.1

版本号可能高于本文示例。后续可以使用 reasonix upgrade 更新稳定版。

三、使用配置向导接入（推荐） ​

运行：

bash
reasonix setup

在 Provider 管理器中新增一个 OpenAI-compatible 自定义 Provider，并按下表填写：

配置项填写内容说明
Provider 名称pokeapi可自定义，建议只使用字母、数字和短横线
API 地址 / Base URLhttps://www.poke2api.com/v1必须包含 /v1，不要填写到 /chat/completions
模型列表 URLhttps://www.poke2api.com/v1/models建议显式填写，便于刷新模型
API Key你的 Poke API Key只粘贴到密钥输入框
模型从模型列表刷新，或手动填写以当前 Key 的分组权限为准
默认模型选择一个已添加模型例如 deepseek-v4-flash
模型能力模式自动识别只有出现 reasoning 参数兼容问题时再手动调整

完成后执行一次 测试连接 / 刷新模型，再选择 保存并退出。向导中的修改在保存前不会写入正式配置。

为什么这里要带 /v1

Reasonix 的 OpenAI-compatible Provider 会把聊天地址组合为：

text
base_url + /chat/completions

因此正确结果应为：

text
https://www.poke2api.com/v1/chat/completions

四、桌面端配置 ​

Reasonix Desktop 与 CLI 共用 Provider 和密钥存储。打开桌面端后进入：

text
设置 → 模型 → Access / 访问 → 添加 Provider

选择 OpenAI-compatible，填写与上一节完全相同的内容：

  • API 地址：https://www.poke2api.com/v1
  • 模型列表 URL：https://www.poke2api.com/v1/models
  • API Key：你的 Poke API Key
  • 模型：以当前 Key 可用列表为准

保存后，CLI 中也可以通过 /provider 或 /model 选择这个 Provider 下的模型。

五、手动配置 TOML（可选） ​

如果需要脚本化部署或手动审查配置，可以直接编辑 Reasonix 的全局配置：

系统配置文件密钥文件
Windows%APPDATA%\reasonix\config.toml%APPDATA%\reasonix\.env
macOS / Linux~/.reasonix/config.toml~/.reasonix/.env

下面示例以 DeepSeek 模型为例。模型名称必须替换为你的 Poke API Key 实际可用模型：

toml
default_model = "pokeapi/deepseek-v4-flash"

[[providers]]
name               = "pokeapi"
kind               = "openai"
base_url           = "https://www.poke2api.com/v1"
models_url         = "https://www.poke2api.com/v1/models"
models             = ["deepseek-v4-flash", "deepseek-v4-pro"]
default            = "deepseek-v4-flash"
api_key_env        = "POKEAPI_API_KEY"
reasoning_protocol = "deepseek"

在同一 Reasonix Home 下的 .env 中保存密钥：

dotenv
POKEAPI_API_KEY=你的真实APIKey

config.toml 只保存环境变量名称，不应出现真实 Key。Reasonix 保存 Provider 时也会采用同样的分离方式。

使用其他模型 ​

  • 使用 DeepSeek 推理模型时，可以保留 reasoning_protocol = "deepseek"，或先使用向导的“自动识别”。
  • 使用 OpenAI reasoning 模型时，可改为 reasoning_protocol = "openai"。
  • 如果模型或网关拒绝 reasoning_effort、thinking 等参数，可改为 reasoning_protocol = "none"，对应界面中的“普通聊天（不发送思考参数）”。
  • models 中只填写当前 API Key 分组实际允许的模型。模型可见但不在分组权限中时，请求仍会失败。

六、Claude 模型的 Anthropic-compatible 配置（可选） ​

如果只使用 Claude，也可以让 Reasonix 直接调用 Poke API 的 Anthropic Messages 入口。此时 Provider 类型与 Base URL 不同：

toml
[[providers]]
name        = "pokeapi-claude"
kind        = "anthropic"
base_url    = "https://www.poke2api.com"
models      = ["claude-sonnet-4-6"]
default     = "claude-sonnet-4-6"
api_key_env = "POKEAPI_API_KEY"

Anthropic-compatible Provider 会请求 /v1/messages，所以这里使用根地址，不要追加 /v1。默认认证方式会使用 x-api-key；无需启用面向其他网关的 Bearer 兼容开关。

如果需要同时使用 DeepSeek、OpenAI、Claude 等多类模型，优先使用上一节的 OpenAI-compatible 配置，维护成本更低。

七、启动与验证 ​

进入需要操作的项目目录，指定模型启动：

bash
reasonix --model pokeapi/deepseek-v4-flash

也可以执行一次非交互测试：

bash
reasonix -p "只回复：Poke API 接入成功" --model pokeapi/deepseek-v4-flash

模型名只是示例，应替换为当前 Key 可用的模型。进入交互界面后可使用：

  • /provider：切换 Provider；
  • /model：切换模型；
  • /status：查看当前模型与会话状态；
  • /effort：调整支持的推理强度；
  • /help：查看完整命令列表。

只有真实模型请求返回内容，才说明 Provider、API Key、分组和模型都已接通。/status 中显示 ready 只代表输入框空闲，不是上游健康检查结果。

八、常见问题 ​

请求返回 404 ​

优先检查 OpenAI-compatible Provider 的 Base URL。正确值是：

text
https://www.poke2api.com/v1

只填根域名会让 Reasonix 请求错误的 /chat/completions；手动填写完整地址时则应使用 chat_url = "https://www.poke2api.com/v1/chat/completions"，不要让 base_url 与 chat_url 同时表达两套路径。

返回 401 或提示 API Key 无效 ​

  • 重新从控制台复制完整 Key；
  • 确认没有复制前后空格；
  • 确认 Key 未撤销、未过期；
  • 检查 .env 中的变量名是否与 api_key_env 完全一致。

无法刷新模型或模型不可用 ​

  • 显式填写模型列表 URL：https://www.poke2api.com/v1/models；
  • 确认 Key 所属分组已经授权对应模型；
  • 直接在 Provider 中手动添加控制台显示的模型名称；
  • 不要把其他 Provider 的模型名称原样复制到当前分组。

普通对话成功，但工具调用失败 ​

Reasonix 是编程 Agent，会向模型发送工具定义。应选择支持工具调用、上下文长度满足项目需求的模型。模型只支持纯文本聊天时，可能能回答问题，但无法稳定执行代码读取、编辑和命令任务。

返回 reasoning 或 thinking 参数错误 ​

先在 Provider 设置中把“模型能力模式”改为 普通聊天（不发送思考参数）。如果使用 DeepSeek 模型，再尝试 DeepSeek 思考；如果使用 OpenAI reasoning 模型，再尝试 OpenAI reasoning。每次修改后重新测试连接。

CLI 和桌面端配置不一致 ​

Reasonix 1.8.1 及以上版本默认共用同一个 Reasonix Home。确认没有设置不同的 REASONIX_HOME，也不要同时编辑旧版 ~/.reasonix/config.json 与新版 config.toml。

九、安全建议 ​

  • API Key 只保存在 Reasonix 的密钥输入框或 Reasonix Home .env；
  • 不要把 .env、真实 Key、完整诊断包上传到公开仓库；
  • Windows 上 Reasonix 的 shell 命令没有 OS 级 Bash 沙箱，批准命令执行前应确认任务可信；
  • 首次在重要仓库中使用时，建议保持 Ask 模式，逐项审查写文件与命令执行请求；
  • 如果 Key 泄漏，立即在 Poke API 控制台撤销并重新创建。

PokeAPI · AI API Gateway

© 2026 PokeAPI · 保留所有权利