raycast-g4f

在 Raycast 里免费调用 GPT/Claude/Llama，一步直达 AI 对话

raycast-g4f 是一个 Raycast 扩展，让你在 Raycast 中直接调用 GPT、Claude、Llama、Gemini 等大模型，完全免费。它基于 g4f（GPT4Free）库，聚合了多个免费 AI 提供商的接口，无需 API Key 即可使用主流模型。同时，它也支持自定义 API，方便接入自己的付费或私有服务。核心能力包括：快速发起对话、多模型切换、流式响应、以及将对话结果复制或插入到当前应用。解决了用户在 Raycast 中需要频繁切换应用或浏览器来使用 AI 的痛点，提升了操作效率。项目用 JavaScript 编写，安装简单，适合追求效率的开发者或重度 Raycast 用户。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1087

维护状态低维护

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队XInTheDark

所属国家

官网地址

GitHubhttps://github.com/XInTheDark/raycast-g4f

定价模式free

价格说明开源扩展，完全免费使用，支持自定义API（可能产生第三方API费用）

访问状态

是否开源是

开源协议GPL-3.0

主要语言JavaScript

技术栈/模型chatbot,chatgpt,claude,free-gpt,gemini,gpt,gpt-4,gpt-4o,gpt4free,llama3,raycast-extension

GitHub 星标★ 1087

30天Star增速

HF 下载量

上线时间2024-04-13 00:00:00

最近更新2026-09-16 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

macOS 系统（Raycast 目前仅支持 macOS，Windows 支持仍在开发中）
已安装 Raycast 应用
Node.js，最低推荐版本 v20.18.1，过低可能出错
可选：Python 3（pip3），用于网页搜索等部分功能

安装与启动步骤

1安装 Raycast

从 raycast.com 下载并安装 Raycast 应用。注意目前只有 macOS 版本，Windows 版本仍在开发中。
2安装 Node.js

从 nodejs.org 安装 Node.js，最低推荐 v20.18.1。版本过旧可能在后续构建中出现问题。
3获取源码

从最新 Release 页面下载源码压缩包，或克隆仓库，然后在终端中进入该目录。
```
git clone https://github.com/XInTheDark/raycast-g4f.git
cd raycast-g4f
```
4安装依赖

在项目目录下运行该命令安装扩展所需依赖，此步为必做项。
```
npm ci --production
```
5安装 Python 依赖

可选步骤。部分功能（例如网页搜索）需要 Python 依赖，不需要这些功能可跳过。
```
pip3 install -r requirements.txt
```
6构建并导入扩展

运行后扩展及其全部命令会自动构建并导入 Raycast，运行期间保持终端窗口开启。
```
npm run dev
```

关键配置

配置项	必填	说明	示例
`Web Search`	否	控制是否启用网页搜索，默认关闭	`Automatic`

如何确认成功

Raycast 中出现该扩展及其完整命令列表，说明导入成功；可在命令中发起对话测试。

常见问题

Q：Raycast 支持 Windows 吗？

A：目前 Raycast 仅提供 macOS 版本，Windows 支持仍在开发中，需等待官方更新。

Q：为什么在 Raycast 商店里搜不到这个扩展？

A：该扩展当前未上架 Raycast 扩展商店，只能按本文从源码安装。

Q：网页搜索不生效怎么办？

A：在扩展偏好设置中把 Web Search 从默认的 Disabled 改为 Automatic、Balanced 或 Always；Ask AI、Ask About Selected Text、Explain 等命令才支持。

Q：Node.js 版本有要求吗？

A：最低推荐 v20.18.1，版本过旧可能遇到问题，建议先升级 Node.js 再安装依赖。

Q：安装过程中出现异常怎么办？

A：README 建议到 GitHub 仓库提交 issue 反馈问题。

注意事项

该扩展未上架 Raycast 商店，只能通过源码安装。
Raycast 目前仅支持 macOS。
Python 依赖为可选项，但网页搜索等功能依赖它。
Web Search 默认关闭，需在偏好设置中手动开启。

核心亮点

完全免费使用 GPT-4、Claude 等主流模型，无需 API Key，零成本体验
深度集成 Raycast，通过快捷键快速唤起，对话结果可直接复制或插入当前应用
支持自定义 API，可灵活接入自己的服务，兼顾免费与稳定性

不足之处

依赖免费提供商的稳定性，可能出现响应慢或服务不可用
文档/社区待观察

适用场景

日常快速问答，无需打开浏览器或切换应用
在编码或写作时，快速获取 AI 建议并插入到编辑器
临时需要测试不同模型效果，但不想注册多个 API

替代项目

ChatGPT Raycast Extension、OpenAI Translator、Raycast AI

项目介绍

raycast-g4f 是对话助手领域的开源项目，由 XInTheDark 开发，2024 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（1,087）位列前 30%，在对话助手分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-16。开源扩展，完全免费使用，支持自定义API（可能产生第三方API费用）。

它主要面向的使用场景是：日常快速问答，无需打开浏览器或切换应用。同类可对比的替代方案包括 ChatGPT Raycast Extension、OpenAI Translator、Raycast AI。

上一篇：HacxGPT-CLI

下一篇：webwhiz