全部教程 /
在 fx（Vercel Labs）中使用 XHuoAPI
fx 是 Vercel Labs 开源的命令行编程 agent，单个原生程序，支持接入任何 OpenAI Chat Completions 兼容的接口。XHuoAPI 提供这个接口，所以在设置文件里加一个连接就能用。我们用 fx 0.0.13 实际让它新建并运行了一个文件，下面的配置就是测试时用的那份。
开始之前
先验证一下
curl https://api.xhuoapi.ai/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'
配置步骤
1
安装 fx（macOS 15 及以上或 Linux；0.0.14 起 macOS 版要求 15+），程序会装到 ~/.local/bin。
curl -fsSL https://fx.sh/setup.sh | bash
2
编辑 ~/.fx/settings.json（没有就新建），写入下面的连接。base_url 写到 /v1 为止，fx 会自己补上 /chat/completions；模型 ID 用定价页上的写法。
{
"provider": "xhuoapi",
"providers": {
"xhuoapi": {
"protocol": "openai-chat-completions",
"base_url": "https://api.xhuoapi.ai/v1",
"auth": { "type": "bearer", "env": "XHUOAPI_API_KEY" },
"model_metadata": {
"glm-5.3": { "supports_tool_use": true },
"kimi-k3": { "supports_tool_use": true },
"deepseek-v4-flash": { "supports_tool_use": true }
}
}
},
"models": { "xhuoapi": "glm-5.3" }
}
3
把 API Key 放进 auth.env 指定的环境变量，然后用 fx status --json 确认 provider_endpoint 和 model 是对的。
export XHUOAPI_API_KEY=YOUR_XHUOAPI_KEY fx status --json
4
在项目目录里运行 fx 进入交互模式，或者用 fx ask 跑一次性任务。临时换模型用 FX_MODEL 环境变量。
fx ask "Create hello.py that prints hello, then run it" FX_MODEL=kimi-k3 fx ask "Explain what this repository does"
注意事项
实测结果（2026-10-14，fx 0.0.13，让 fx 新建并运行一个文件）：glm-5.3 两次都通过（33~79 秒），kimi-k3 两次都通过（27~31 秒），deepseek-v4-flash 6 次里 5 次通过。qwen3.8-max 4 次都报 InconsistentFinishReason。2026-10-18 用 0.0.14 复测：glm-5.3、kimi-k3 通过；deepseek-v4-flash 多次报 InvalidFinishReason（0.0.13 同样），原因是这个模型目前部分响应把 finish_reason 写成空字符串，fx 会拒收。在 fx 里先用 glm-5.3 或 kimi-k3。
fx 默认的 auto 权限模式会让模型先审一遍有风险的操作，审查用 reviewer_model，没设就用当前模型，这些请求同样按 token 计费。想省一点，在连接里加 "reviewer_model": "deepseek-v4-flash" 这类便宜的模型。
model_metadata 里还可以写 context_window（模型的上下文长度）和 max_output_tokens。不写 context_window 也能用，只是 fx 算不出自动压缩会话的时机；要写就按模型厂商公布的长度填。
fx 提示缺少凭据时，检查 auth.env 里写的变量名是否已经 export；HTTP 报错就看接口返回的内容，常见是模型 ID 拼错。base_url 必须是 HTTPS。
模型名必须与定价页里的 ID 完全一致（例如 deepseek-v4-pro，不是 DeepSeek V4 Pro）。大小写、连字符都算。