Repolode
OleksandrChekhovskyi

OleksandrChekhovskyi/hax

用 C 语言编写的极简终端编程智能体,支持本地 llama.cpp 模型和多家云端大模型服务。

可替代:Claude Code

Star
974
Fork
67
未关闭 Issue
21
最近提交
8天前

这是什么?

hax 是一个在终端中运行的编程智能体,核心是一个依赖很少的原生 C 二进制程序,启动快,内存占用only 几 MB。它提供交互式 REPL,也支持 `-p` 单次模式,只把最终回答输出到标准输出,并可按项目目录续接过去的会话。

它支持 OpenAI 及兼容接口、Anthropic、通过 ChatGPT 订阅使用的 Codex、OpenRouter、OpenCode Zen/Go、DeepSeek、llama.cpp、Ollama 以及自定义端点。启动 llama-server 后,hax 会自动识别已加载的模型及其能力,无需额外的 provider 配置。

输出以流式 Markdown 和工具结果呈现,并保留终端原生的滚动历史。按 Ctrl+T 可查看完整对话记录,包括发送给模型的内容和模型的回复,也可以选择收集详细的协议跟踪日志。配置和会话文件均为纯文本,扩展通过外部子进程实现,而非插件系统。

核心功能

  • 01单一原生 C 二进制文件,依赖少,内存占用低。
  • 02自动识别 llama.cpp 提供的模型,无需手动配置 provider。
  • 03流式输出 Markdown 与工具结果,同时保留终端滚动历史。
  • 04通过对话记录视图和可选的协议跟踪,查看发送给模型和收到的全部内容。
  • 05支持 OpenAI、Anthropic、OpenRouter、DeepSeek、Ollama 及自定义端点等多家服务。
  • 06配置与会话文件为纯文本,路径遵循 XDG 规范。

适用场景

  • 用本地 llama.cpp 或 Ollama 模型驱动编程助手。
  • 在 shell 脚本中通过 `-p` 单次模式调用,获得干净的标准输出。
  • 审计编程智能体与模型之间实际收发的内容。
  • 在资源有限的机器上运行,或为 Linux 发行版打包。

快速上手

  1. 1

    通过 Homebrew 安装

    brew install oleksandrchekhovskyi/hax/hax
  2. 2

    启动本地 llama.cpp 服务器并加载模型

    llama-server -m [model].gguf
  3. 3

    使用 llama.cpp 提供商运行 hax

    hax --provider llama.cpp

使用前须知

  • Windows 不支持原生运行,需在 WSL 下使用。
  • BSD 系统仅支持从源码构建。
  • 刻意不提供 MCP 市场、插件运行时、IDE 面板和逐命令权限提示等高级功能。

收录于专题

标签

常见问题

hax 是什么?
用 C 语言编写的极简终端编程智能体,支持本地 llama.cpp 模型和多家云端大模型服务。 hax 是一个在终端中运行的编程智能体,核心是一个依赖很少的原生 C 二进制程序,启动快,内存占用only 几 MB。它提供交互式 REPL,也支持 `-p` 单次模式,只把最终回答输出到标准输出,并可按项目目录续接过去的会话。
hax 可以免费使用吗?用的什么许可证?
hax 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
hax 还在维护吗?
活跃维护中。hax 最近一次提交是在 2026年10月30日。
hax 适合用来做什么?
用本地 llama.cpp 或 Ollama 模型驱动编程助手。 在 shell 脚本中通过 `-p` 单次模式调用,获得干净的标准输出。 审计编程智能体与模型之间实际收发的内容。 在资源有限的机器上运行,或为 Linux 发行版打包。
hax 怎么安装和运行?
通过 Homebrew 安装: brew install oleksandrchekhovskyi/hax/hax 启动本地 llama.cpp 服务器并加载模型: llama-server -m [model].gguf 使用 llama.cpp 提供商运行 hax: hax --provider llama.cpp
在哪里获取 hax?
源代码和安装说明在 GitHub 上:https://github.com/OleksandrChekhovskyi/hax

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目