hands

hands 是 Hawa Code 的远程执行机制：把工具放入代码所在的沙箱中运行，将 模型推理流量 与 工具执行请求 完全解耦。模型的请求流量无需进入沙箱即可完成工具调用，因此在保留沙箱隔离的同时，能够完整保留工具能力。

工具通过 MCP 协议对外提供。你既可以直接使用 Hawa Code 内置的 MCP，也可以接入 Hawa Code 单独提供的 MCP 工具。下文介绍内置 hands MCP 的使用方式。

启动 hands 服务

在沙箱（或任意远程机器）中执行以下命令启动 hands 服务，启动成功后会输出可供客户端连接的 URL：

hcode hands

在 Hawa Code 或其他支持 MCP 的客户端的 .mcp.json 中添加：

{
  "mcpServers": {
    "hands": {
      "type": "http",
      "url": "https://<your-codespaces-host>-3000.app.github.dev/mcp"
    }
  }
}

实际 URL 以 hands 启动时输出的为准；若部署在 Codespaces 上，URL 在实例重启后可能变化，需要同步更新此处配置。

工具	说明
`Bash`	在远程机器执行 shell 命令，支持后台运行与超时控制
`Read`	读取远程文件内容，支持 offset / limit 分段读取
`Edit`	对远程文件做精确字符串替换
`Write`	在远程文件系统写入或覆盖文件
`Glob`	按 glob 模式快速匹配文件路径
`Grep`	基于 ripgrep 的正则搜索，支持文件类型与上下文过滤
`LSP`	调用远程 Language Server，做跳转、引用、悬浮、符号查询等
`NotebookEdit`	编辑远程 Jupyter Notebook 的单元格
`TaskOutput`	拉取后台任务（shell / agent）的实时输出
`TaskStop`	终止指定的后台任务