fastctx

让 AI 代理按需读代码，省 token 又找得准

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开发框架 🍴 复刻 63 🐛 待处理 27 👀 关注 3

GitHub ↗

GitHub 星标 ★ 1533

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，无官网定价信息

项目预览

项目数据

分类开发框架

开发团队yc-duan

GitHubhttps://github.com/yc-duan/fastctx

定价模式🏷️完全免费

价格说明开源免费，无官网定价信息

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Rust

GitHub 星标★ 1533

上线时间2026-07-17 00:00:00

代码更新2026-11-04

仓库体积44.1 MB

本站数据更新2026-11-06

维护状态活跃

收录时间2026-09-22

浏览次数5

项目介绍

fastctx 是一个用 Rust 编写的 MCP（Model Context Protocol）服务器，为 AI 编码代理提供高效、上下文友好的代码仓库工具。它解决的核心问题是：AI 代理在操作大型代码库时，往往需要把大量文件内容塞进上下文窗口，既浪费 token 又降低推理质量。fastctx 通过提供结构化的仓库检索与读取能力，让代理按需获取精准的代码片段，而不是一次性吞下整个目录。核心能力包括快速文件搜索、按符号或路径定位代码、受控的上下文输出，以及基于 MCP 标准与 Claude、Cursor 等客户端无缝集成。Rust 实现带来低延迟和低内存占用，适合在本地或 CI 中常驻运行。项目定位是 AI 代理的“仓库感知层”，让代理在真实工程里更省 token、更准地找到目标代码。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 1533

使用教程

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

环境要求

Node.js 18 或更高版本
npm（随 Node.js 一起安装）
Windows 上执行 Bash 命令依赖 Git Bash，macOS / Linux 使用系统 Bash

安装与启动步骤

1检查 Node.js 版本

FastCtx 要求 Node.js 18 或更高版本，版本过低请先升级 Node.js，否则安装会失败。
```
node -v
```
2全局安装 FastCtx

通过 npm 全局安装 fastctx 包，安装完成后终端即可使用 fastctx 命令。
```
npm install --global fastctx
```
3启动控制终端

首次启动会打开全屏控制终端，可调整输出档位、并发、Bash 终端、后台任务与宿主配置等。
```
fastctx
```
4免安装临时运行

不想全局安装时可先用 npx 打开同样的控制终端；但 fastctx 命令本身仍需要全局安装。
```
npx fastctx
```
5安装报 404 换官方源

刚发布时镜像源同步延迟会导致 404，改用官方源安装；该参数只对本次命令生效。
```
npm install --global fastctx --registry=https://registry.npmjs.org/
```
6连接宿主客户端

在连接界面确认宿主配置变更并重启 ChatGPT / Codex 会话，连接会把二进制复制到 ~/.fastctx/bin/。

关键配置

配置项	必填	说明	示例
`FASTCTX_DISABLE_UPDATE_CHECK`	否	设为 1 可关闭控制终端启动时的自动更新检查。	`1`
`registry`	否	npm 源地址，改成官方源可规避镜像同步延迟导致的 404。	`https://registry.npmjs.org/`

如何确认成功

终端出现 FastCtx 全屏控制终端主菜单，且 fastctx 命令可正常调用，即表示安装启动成功。

常见问题

Q：安装后提示 404 Not Found 怎么办？

A：多为镜像源同步延迟，平台包被静默跳过导致无法启动。改用官方源重装：npm install --global fastctx --registry=https://registry.npmjs.org/。

Q：npx fastctx 和全局安装有什么区别？

A：npx 无需全局安装即可打开同一控制终端，且连接后二进制同样复制到 ~/.fastctx/bin/；但只有全局安装后才有 fastctx 命令。

Q：更新之后需要做什么？

A：更新完成后需要重启 Codex，让已有会话及其构建隔离的控制中心被新构建替换，否则仍在使用旧版本。

Q：如何关闭启动时的更新检查？

A：设置环境变量 FASTCTX_DISABLE_UPDATE_CHECK=1，即可禁用控制终端启动阶段的自动检查。

注意事项

连接宿主时会把当前二进制复制到 ~/.fastctx/bin/，之后清理 npm 缓存或升级都不影响已连接的配置。
cargo install 构建出的版本和内部 ~/.fastctx/bin/ 运行时不会自动更新，只能通过 npm 或 GitHub Release 方式更新。
命令在非交互环境中执行，安装、确认、编辑器类命令需要显式加 -y、--no-edit 等参数，否则会卡住。
后台任务的输出与退出状态存放在 ~/.fastctx/jobs/ 下，可在其它 FastCtx 会话中按 job id 继续查看。