# hoocode 中文文档

规范地址：https://npmcn.com/package/hoocode/

版本：0\.2\.31
npm 元数据更新时间：2026-11-03T18:28:23.620Z
中文译文更新时间：2026-11-03T20:58:56.320Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/hoocode
原文对照：https://npmcn.com/package/hoocode/?lang=original
项目主页：https://kolisachint.github.io/hoocode/
源码仓库：https://github.com/kolisachint/hoocode

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：15.5 kB，5 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-08T02:36:52.120Z
- 最新版本发布：2026-11-03T18:28:23.274Z
- 已发布版本数：43（近 12 个月 43 个）

## 中文简介

Hoocode，终端编码代理

## 安装

```sh
npm install hoocode
```

也可以使用：`pnpm add hoocode`、`yarn add hoocode`、`bun add hoocode`

## README

![hoocode](https://npmcn.com/package/hoocode/docs/assets/brand/hoocode.svg)

一个终端编码代理，用Rust编写。一个静态二进制文件，任何模型提供程序，没有您的允许，什么都不应用。

[![CI](https://github.com/kolisachint/hoocode/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/kolisachint/hoocode/actions/workflows/ci.yml) [![Latest release](https://img.shields.io/github/v/release/kolisachint/hoocode?sort=semver)](https://github.com/kolisachint/hoocode/releases/latest) [![npm](https://img.shields.io/npm/v/hoocode?label=npm)](https://www.npmjs.com/package/hoocode) [![PyPI](https://img.shields.io/pypi/v/hoocode?label=PyPI)](https://pypi.org/project/hoocode/) [![MIT license](https://img.shields.io/badge/license-MIT-blue)](https://npmcn.com/package/hoocode/LICENSE)

![hoocode in a terminal: asked to make mean() return an Option, it reads src/lib.rs, shows the edit as a diff and waits for approval, runs cargo test after a second approval (1 passed), sums up, and then opens the slash-command menu](https://npmcn.com/package/hoocode/docs/assets/demo.gif)

实二进制；只有模型是脚本化的，因此可以为每个发布版本再次记录演示(`scripts/demo/record.sh`）.

* * *

Hoocode读取你的代码，运行命令，编辑文件，并与你的模型 选择，从全屏终端UI或作为一个一次性命令。它是一个单一的本地 binary：不需要Node，不需要Python，不需要安装运行时。

-   **任何供应商。** Anthropic, OpenAI， b谷歌，OpenRouter, Groq, DeepSeek, xAI, Fireworks 以及更多，通过API键或 `/login` （Anthropic, GitHub Copilot, OpenAI Codex， b谷歌）。
-   **你要控制自己。** Shell， Edit and Write先问（Yes / No / Always）； 只读命令，例如 `ls` 或 `git status` 就跑了。四种代理模式(问， 计划、构建、调试；（Shift+Tab循环）代理可以做什么，以及 `--skip-permissions` 当你需要的时候，不用问就能搞定一切。
-   **子代理。** 代理可以将工作手工传递给后台的子代理并继续运行；他们的 工具调用要经过与主代理相同的审批门。
-   **你可以回来参加会议。** `--continue`， `/resume`， `/fork`， `/tree`, 自动压缩长对话。
-   **可扩展的开放格式。** `AGENTS.md` / `CLAUDE.md` 背景文件、技能、 提示模板和斜杠命令，MCP服务器，插件，主题和键绑定。
-   **脚本。** 打印模式(`-p`)输出文本或JSON，以及JSON- rpc模式 （`--mode rpc`)用于从另一个程序中驱动hoocode。

## 安装

Hoocode运行于 **macOS和Linux，支持x64和arm64**． Linux构建是静态的 （肌肉），所以一个二进制文件可以在任何发行版上运行。目前还没有Windows版本。

**安装脚本** （无root，无Node）：

```bash
curl -fsSL https://kolisachint.github.io/hoocode/install.sh | sh
```

它为您的平台下载发布归档，并根据发布进行检查 `SHA256SUMS`、安装 `~/.hoocode/bin/hoocode` (加上一个 `hoo` 别名)和添加 `~/.hoocode/bin` 到你的 `PATH`。通过 `--help` 对于选项(`--version`， `--dir`， `--no-modify-path`）. 脚本如下 [`install/install.sh`](https://npmcn.com/package/hoocode/install/install.sh) 在这个回购。

**NPM或bun**：

```bash
npm install -g hoocode     # or: bun add -g hoocode
```

该包仅为您的平台导入本机二进制文件。它安装 `hoocode` 和 `hoo`，其安装的命令直接运行二进制文件。

**皮普** （Python 3.8或更新版本）：

```bash
pip install hoocode        # or: pipx install hoocode
```

一个瘦启动器：在第一次运行时，它会下载你的平台的发布二进制文件， 检查它的sha256 `SHA256SUMS` 把它藏在下面 `~/.cache/hoocode/`。

**预先构建的二进制文件。** 每一个 [GitHub释放](https://github.com/kolisachint/hoocode/releases) 有 `hoocode-<target>.tar.gz` 为 `x86_64-unknown-linux-musl`， `aarch64-unknown-linux-musl`， `x86_64-apple-darwin` 和 `aarch64-apple-darwin`，和 `SHA256SUMS` 文件。打开包装，放好 `hoocode` 在你的 `PATH`：

```bash
tar xzf hoocode-aarch64-apple-darwin.tar.gz
install -m 755 hoocode-aarch64-apple-darwin/hoocode ~/.local/bin/hoocode
```

**从源** (Rust 1.88或更新版本；仓库将其开发工具链固定在 [`rust-toolchain.toml`](https://npmcn.com/package/hoocode/rust-toolchain.toml)（生锈会自己捡起来）：

```bash
git clone https://github.com/kolisachint/hoocode
cd hoocode
cargo install --locked --path crates/hoocode-code-main --bin hoocode
```

或运行 `scripts/install.sh`，它构建一个发布二进制文件并将其安装为 `hoocode` 和 `hoo`． 默认情况下，它会更新 `$HOOCODE_INSTALL_DIR/bin` 当 目录已包含可执行文件 `hoocode`;如果 `HOOCODE_INSTALL_DIR` 是 取消设置，它检查 `~/.hoocode/bin` 代替。否则，它将安装到 `~/.local/bin`。通过 `--prefix DIR` 覆盖目标。

Hoocode不在板条箱上。io或Homebrew。

**更新。** `hoocode update` 打印安装方式的正确更新命令。

## 快速启动

```bash
export ANTHROPIC_API_KEY=...          # or any provider key, see `hoocode --help`
cd your-project
hoocode                               # full-screen interactive session
```

没有API密钥？开始 `hoocode` 和运行 `/login` 以订阅方式登录。

> **的批准。** Hoocode开始于 **构建** 模式：Shell，编辑和写前问他们 运行（Yes / No / Always）和只读命令，如 `ls`， `cat` 或 `git status` 只是 运行。不用问就能让它起作用，从 **`hoocode --skip-permissions`**,或 将其设置为默认值 `"skip_permissions": true` 在 `~/.hoocode/hoo-config.json`。 模式规则仍然适用（要求模式永远不编辑）。Shift+Tab循环询问、计划、构建和 调试。

在互动环节中可以尝试以下内容：

| 类型 | 它是做什么的 |
| --- | --- |
| `/model` | 选择一个模型（Ctrl+P在你最喜欢的模型中循环） |
| `/mode` | 在询问，计划，构建和调试之间切换（或Shift+Tab） |
| `/resume` | 在此文件夹中重新打开较早的会话 |
| `@path/to/file` | 在邮件中附加一个文件 |
| `/hotkeys` | 显示键盘快捷键 |
| `/settings` | 改变设置 |

一次性和脚本使用：

```bash
hoocode -p "Summarize this repo"                        # print the answer and exit
hoocode -p --mode json "List the TODOs in src/"         # JSON event stream
hoocode --model anthropic/claude-sonnet-4-5 "Review the last commit"
hoocode --continue "And now fix the first one"          # continue the last session
hoocode --tools Read,CodeSearch -p "Review src/"        # read-only run
hoocode --mode rpc                                      # JSON-RPC over stdin/stdout
hoocode --skip-permissions "Fix the failing tests"      # no approval prompts
```

插件添加技能，子代理和MCP服务器。添加一个git市场，然后安装 从它，从壳或与 `/plugin` 在会话中：

```bash
hoocode plugin marketplace add <git-url-or-owner/repo>
hoocode install <plugin>@<marketplace>     # --scope project for this repo only
hoocode list
```

`hoocode --help` 列出每个标志和提供程序环境变量； `hoocode --list-models [search]` 列出它知道的模型。

## 配置

所有hoocode保存的东西都存在 **`~/.hoocode`**． 集 `HOOCODE_CODING_AGENT_DIR` 来 移动它。

| 文件或文件夹 | 它包含什么 |
| --- | --- |
| `~/.hoocode/settings.json` | 全局设置(`/settings` 编辑) |
| `.hoocode/settings.json` | 每个项目设置，在全局设置上合并 |
| `~/.hoocode/auth.json` | 登录名和密钥由保存 `/login` |
| `~/.hoocode/models.json` | 您自己的提供程序和模型（例如本地openai兼容服务器） |
| `~/.hoocode/hoo-config.json` | 代理模式和工具审批规则 (`auto_allow`） |
| `~/.hoocode/skills/`， `.hoocode/skills/` | 技能，全球和每个项目 |
| `~/.hoocode/themes/` | 自定义主题 |
| `~/.hoocode/sessions/` | 保存的会话，每个JSONL文件，在每个项目的文件夹中(`HOOCODE_CODING_AGENT_SESSION_DIR` 或 `--session-dir` 移动它们) |
| `~/.agents/mcp.json`， `.agents/mcp.json` | 全局和每个项目的MCP服务器(`/mcp` 显示它们的状态) |
| `~/.agents/plugins/`， `.agents/plugins/` | 插件、用户和每个项目 (`hoocode install`， `hoocode list`,或 `/plugin` 在一个会话中) |
| `AGENTS.md` 或 `CLAUDE.md` | 项目说明，从工作文件夹及其父文件夹中读取 |

因为会话被保存为文件，所以您可以恢复、分叉或导出 他们 (`/export <file>.jsonl`）. `--no-session` 保持短暂的运行，并且 `--offline` 关闭启动网络调用，如版本检查。

## 文档

-   [`docs/user/`](https://npmcn.com/package/hoocode/docs/user/): 用户文档，发布于 [https://kolisachint.github.io/hoocode](https://kolisachint.github.io/hoocode) 每次发布
-   [`docs/maps/ui.md`](https://npmcn.com/package/hoocode/docs/maps/ui.md)：屏幕，选择器，斜杠命令和键， 以及它们在代码中的位置
-   [`docs/maps/packages.md`](https://npmcn.com/package/hoocode/docs/maps/packages.md): 工作区中的每个板条箱和 它是做什么的
-   [`docs/design/`](https://npmcn.com/package/hoocode/docs/design/README.md)：设计说明和路线图
-   [`docs/design/distribution.md`](https://npmcn.com/package/hoocode/docs/design/distribution.md): 发布如何到达用户
-   [`CHANGELOG.md`](https://npmcn.com/package/hoocode/CHANGELOG.md)什么改变了 `/changelog` 内部hoocode)

## 贡献

### 试一试，然后告诉我们

您可以做的最有用的事情是尝试hoocode并告诉我们它是如何进行的。

-   **Bug还是想法？** [打开一个问题](https://github.com/kolisachint/hoocode/issues/new/choose)。
-   **问题？** 询问 [讨论](https://github.com/kolisachint/hoocode/discussions)。
-   **想要发送PR？** 拉请求是受欢迎的。从……开始 [你的第一个pull请求](https://npmcn.com/package/hoocode/CONTRIBUTING.md#your-first-pull-request) 和 [好的第一个问题](https://github.com/kolisachint/hoocode/labels/good%20first%20issue)。

[CONTRIBUTING.md](https://npmcn.com/package/hoocode/CONTRIBUTING.md) 涵盖开发循环 (fmt，clippy，nextest)， 测试的去向以及发布的工作方式。请阅读 [行为准则](https://npmcn.com/package/hoocode/CODE_OF_CONDUCT.md)，并将安全问题私下报告为 描述在 [SECURITY.md](https://npmcn.com/package/hoocode/SECURITY.md)。

如果hoocode对你有用，回购上的星星可以帮助其他人找到它。

## 学分

hoocode开始作为一个叉 [`pi-mono`](https://github.com/badlogic/pi-mono) 通过 Mario Zechner，麻省理工学院授权。其版权声明保存在 [许可证](https://npmcn.com/package/hoocode/LICENSE)。 感谢Mario和上游贡献者。

## 许可证

麻省理工学院,看到 [许可证](https://npmcn.com/package/hoocode/LICENSE)。

## 常见问题

### hoocode 是什么？

Hoocode，终端编码代理

### 如何安装 hoocode？

在项目目录运行 npm install hoocode，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 hoo、hoocode，可以用 npx hoo 直接运行。

### hoocode 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/hoocode 是否存在。

### hoocode 可以商用吗？

hoocode 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### hoocode 还在维护吗？

最新版本 0\.2\.31 发布于 2026/11/04（1 天前）；至今共发布 43 个版本，其中过去 12 个月发布了 43 个；首次发布于 2026/10/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。