如何免费下载和安装 KataGo 1.17.2（2026）——完整设置指南

KataGo 是当今最强的开源围棋 AI 之一。无论你是想理解对局中哪里下错了、探索替代着法、还是研究职业级棋谱，KataGo 都能提供每一步的分析，包括胜率、目差估计和最佳变化图。

本指南将带你完成在 Windows、macOS 或 Linux 上安装 KataGo 并连接到 StoneBase 的完整步骤，享受无缝的复盘体验。

第 1 步：下载 KataGo

你需要 KataGo 引擎本身。建议使用 GPU（NVIDIA、AMD 或 Apple Silicon）——KataGo 也可以在 CPU 上运行，但 GPU 能让分析速度大幅提升。

最新版本是 KataGo v1.17.2。请从官方 KataGo 发布页面 开始，选择适合你的平台和后端的最新提供的二进制文件。v1.17.2 发布版提供 TensorRT 可执行文件；如果需要其他后端，请选择该页面上提供的最新兼容二进制文件。直接使用提供的二进制文件即可。

Windows 上的 KataGo

• NVIDIA GPU：使用最新提供的 NVIDIA 二进制文件；如果系统已安装且能正常使用 TensorRT，请选择 v1.17.2 TensorRT 构建。
• AMD GPU：从官方发布页面选择最新提供的 OpenCL 二进制文件。
• 仅 CPU：使用最新提供的 Eigen 二进制文件；若 CPU 支持，请优先选择 AVX2 构建。

将压缩包解压到一个你能记住的文件夹，例如 C:\KataGo。

macOS 上的 KataGo

KataGo 在所有现代 Mac 上都能出色运行，但 Apple Silicon 和 Intel 之间存在性能差异。

Apple Silicon (M1/M2/M3/M4)：使用 KataGo v1.17.2 的 Metal 后端以获得最佳性能。通过 Homebrew 安装：

brew install katago

如果你不使用 Homebrew，请从官方发布页面下载最新提供的 macOS 二进制文件，然后将 katago 放置到 PATH 中的目录（Intel Mac 用 /usr/local/bin/，Apple Silicon 用 /opt/homebrew/bin/ 等）。

要验证二进制文件和 Metal 后端，请在终端中运行 katago version——它应该报告你下载的版本，并显示 Metal 为检测到的后端。

Intel Mac：从官方发布页面选择最新提供的 macOS 二进制文件，并使用 OpenCL 后端。

Homebrew 故障排除：如果 brew install katago 失败，请确保已安装 Xcode Command Line Tools（xcode-select --install）。如果出现权限错误，请运行 sudo chown -R $(whoami) /usr/local/share/man/man8 或安装到用户拥有的目录。

手动安装（不使用 Homebrew）：从 KataGo 发布页面 下载最新提供的 macOS 二进制文件，解压后将 katago 放置到 PATH 中的目录（Intel Mac 用 /usr/local/bin/，Apple Silicon 用 /opt/homebrew/bin/ 等）。然后使其可执行：

chmod +x /opt/homebrew/bin/katago   # Apple Silicon — Intel 请用 /usr/local/bin/katago

Gatekeeper 说明：首次运行手动下载的二进制文件时，macOS 可能会阻止它。前往系统设置 > 隐私与安全性，在阻止的消息旁边点击仍要打开。此操作只需进行一次。

Linux 上的 KataGo

• NVIDIA GPU：使用最新提供的 NVIDIA 二进制文件；如果系统已安装且能正常使用 TensorRT，请选择 v1.17.2 TensorRT 构建。
• AMD GPU：从官方发布页面选择最新提供的 OpenCL 二进制文件。
• 仅 CPU：使用最新提供的 Eigen 二进制文件；若 CPU 支持，请优先选择 AVX2 构建。

使二进制文件可执行：chmod +x katago，然后将其放在 ~/katago 等位置。

最新版本：KataGo 1.17.2 与 Transformer 网络

KataGo 1.17.0 为所有主要后端上的 C++ 引擎加入了 Transformer 神经网络支持。Transformer 模型在相同计算预算下通常强得多，但它们使用模型版本 17，无法在早于 KataGo 1.17 的引擎中加载。

KataGo v1.17.2 是当前版本。请从官方发布页面选择适合你的平台和后端的最新提供的二进制文件。v1.17.2 发布版提供 TensorRT 可执行文件；对于其他后端，请选择该页面上提供的最新兼容二进制文件。使用提供的二进制文件即可，无需其他步骤。请将完整压缩包解压到新文件夹，不要把新可执行文件和旧 DLL 混用。

所有主要后端都可以运行 Transformer 网络。OpenCL 具有广泛兼容性，但运行 Transformer 时明显较慢。在 NVIDIA 硬件上，使用 cuDNN 9.8.0 或更新版本的 CUDA+cuDNN，或 TensorRT，通常性能更好；TensorRT 以更长的首次启动时间换取速度。Homebrew 软件包可能落后于官方发布版，因此加载 Transformer 模型前请用 katago version 确认版本为你的后端提供的最新版本。

第 2 步：下载神经网络

KataGo 需要一个 .bin.gz 神经网络文件（评估局面的“大脑”）：

• 下载正确的文件：在官方 KataGo 网络页面 点击 Network File。不要下载 Raw Checkpoint，它用于训练，不适用于 StoneBase。
• 使用 Transformer 网络：请从官方 KataGo 网络页面 选择 Transformer 网络，并确保 KataGo 二进制文件为你的后端提供的最新版本。
• 按硬件选择网络：在 CPU 或性能一般的 GPU 上，请从较小的网络开始。更大的网络需要更多 RAM/VRAM，且可能降低每秒访问数，因此选择更大模型前先用一个局面测试速度。

将网络文件保存在与 KataGo 二进制文件相同的文件夹中。

第 3 步：设置配置文件

KataGo 使用配置文件来控制其行为。KataGo 下载包中包含了示例配置。

重要： StoneBase 使用 KataGo 的分析引擎模式，而非 GTP 模式。请确保使用分析配置文件（例如 analysis_example.cfg），而不是 GTP 配置文件（例如 default_gtp.cfg）。使用错误的配置格式将导致 KataGo 无法正确启动。

如果你不确定使用哪个配置，StoneBase 可以提供一个。在引擎设置页面，点击下载示例 KataGo 分析配置即可获得一个可直接使用的模板。

关键设置项：

• numSearchThreads：KataGo 用于搜索的线程数。对大多数 GPU，从 1-2 开始。
• maxVisits：每步评估的最大位置数。500-1000 是一个不错的起点。

对大多数用户而言，默认的分析配置开箱即用。

第 4 步：安装 StoneBase

StoneBase 是免费的桌面应用，驱动 KataGo 并提供完整的复盘界面。从 GitHub 发布页面 下载最新版本，选择适合你平台的安装包：

• Windows：下载 StoneBase-X.Y.Z.msi，双击，按向导完成安装。
• macOS：下载 StoneBase-X.Y.Z.dmg，将 StoneBase 拖入 Applications 文件夹。首次启动时，macOS 可能会阻止该应用——前往系统设置 > 隐私与安全性，然后点击仍要打开。
• Linux：下载 stonebase_X.Y.Z_amd64.deb，使用 sudo dpkg -i stonebase_X.Y.Z_amd64.deb 安装。

第 5 步：在 StoneBase 中配置 KataGo

打开 StoneBase 并进入设置。在 KataGo 部分，配置：

1. KataGo 二进制路径：指向第 1 步中的 katago 可执行文件。
2. 神经网络路径：指向第 2 步中的 .bin.gz 网络文件。
3. 配置文件路径：指向第 3 步中的 .cfg 分析配置。如果你还没有，在设置页面点击下载示例 KataGo 分析配置获取一个可直接使用的模板。

点击保存，StoneBase 将验证连接。如果一切设置正确，你会看到确认消息。

你还可以在分析选项卡下微调分析参数（最大访问量、线程、变化图）：

第 6 步：分析你的第一盘棋

KataGo 配置完成后：

1. 导入一个 SGF 文件或从你的对局库中选择一盘棋。
2. 点击工具栏中的分析按钮。
3. KataGo 将评估每一步，显示：
   • 胜率：每位玩家获胜的概率
   • 目差估计：预测的目数差距
   • 候选落子：AI 的最佳落子建议及评估
   • 主要变化：预期的行棋次序

浏览整盘棋，查看每一步评估如何变化。胜率大幅下降标示了你最大的错误——这些局面最值得仔细研究。

不熟悉 AI 分析？在从这些数字得出结论之前，先阅读我们关于解读 KataGo 胜率和目差估计的简短指南——将 5% 的波动误读为“恶手”是新手常见的陷阱。

故障排除

KataGo 无法启动：确保二进制路径指向实际的 katago 可执行文件（而不是文件夹）。在 macOS/Linux 上，你可能需要 chmod +x katago。

分析非常慢：如果你在 CPU 上运行，分析会显著变慢。请从官方网络页面选择更小的网络，或使用 GPU。

“加载神经网络失败”错误：仔细检查网络文件路径，以及网络版本是否与你安装的 KataGo 二进制文件匹配。Transformer 网络需要 KataGo 1.17 或更新版本，因此请使用你的后端提供的最新二进制文件。

目差估计不正确：如果胜率和目数看起来不对，检查对局的规则设置是否与实际下棋时的规则一致。日本规则和中国规则对同一局面的评估可能不同。你可以在 StoneBase 的对局设置中为每盘棋配置规则。

常见问题

KataGo 能在 Mac 上运行吗？

能。在 Apple Silicon Mac（M1/M2/M3/M4）上，最新提供的 macOS 二进制文件使用 Metal 后端，速度非常快——可用 brew install katago 安装。在 Intel Mac 上，使用最新提供的 macOS 二进制文件及 OpenCL 后端。

运行 KataGo 需要 GPU 吗？

不需要，KataGo 可以使用 Eigen 后端在 CPU 上运行，但分析速度会显著变慢。任何现代 NVIDIA、AMD 或 Apple Silicon GPU 都会带来大幅速度提升——对于认真复盘，强烈建议使用 GPU。

如何更新 KataGo？

从 KataGo 发布页面 下载适合后端的最新提供二进制文件，并替换完整的解压包，而不只是 katago 二进制文件。现有配置和常规网络通常仍可使用，但 Transformer 网络需要 KataGo 1.17 或更新版本。删除正常工作的安装前，请查看发布说明并测试设置。

KataGo 免费吗？

是的，KataGo 完全开源且免费使用。StoneBase 也是免费下载的——Pro 版本解锁批量分析和其他高级功能，但使用 KataGo 进行单盘棋复盘永久免费。

应该使用哪个 KataGo 网络？

请从官方 KataGo 网络页面 选择 .bin.gz Network File 开始。想利用 Transformer 模型的棋力，请使用该页面上的 Transformer 网络和你的后端提供的最新 KataGo 二进制文件。在 CPU 或性能一般的 GPU 上请选择较小网络，并在升级到更大模型前测试速度。

KataGo vs Leela Zero：哪个更适合复盘？

KataGo 持续维护、支持目差估计（不仅仅是胜率）、处理不同规则（日本/中国/韩国），并且目前被认为比 Leela Zero 更强。对于现代围棋复盘，KataGo 是推荐选择。

我可以不安装软件，在线使用 KataGo 吗？

StoneBase 被设计为桌面应用——你的棋谱和分析数据将在你的机器上保持私密。我们正在探索未来提供云端托管 KataGo 分析的可能性，但目前尚不可用。

与此同时，桌面端的设置比大多数人想象的要简单：本指南将逐步引导你完成每个步骤，配置完成后，你将获得无限次免费 AI 分析，并享有完全的隐私保护。如果你已有 GPU，桌面应用通常比任何基于网页的选项更快，因为没有网络延迟。

有一些第三方网页服务（如 Online KataGo 或 AI Sensei）提供无需安装的浏览器内 KataGo 分析——但它们缺少 StoneBase 的棋谱管理、局面搜索和本地隐私保障功能。

下一步？

KataGo 运行起来后，你可以：

• 复盘单盘棋，发现你的错误和错失的机会
• 批量分析整个对局库（Pro 功能），一次性获得所有对局的 AI 评估
• 探索变化，摆子并查看 KataGo 如何评估不同后续着法

你自己的计算能力与 KataGo 的超人类评估相结合，是识别弱点并提高水平的最快途径。

相关文章

• 如何用 AI 复盘围棋：新手入门指南 — 学习如何在复盘中充分利用 AI 分析。
• KataGo 胜率与目差详解 — 这些数字的实际含义及如何解读。
• 新手常犯的5个围棋错误：AI如何帮你发现它们 — KataGo 在玩家对局中最常揭示的模式。
• 从电脑到平板：StoneBase 最近更新了什么