返回博客

2026 年安装 KataGo：Windows、Mac 和 Linux 设置指南

发布于 2026年4月6日 作者 StoneBase Team

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

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

第 1 步：下载 KataGo

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

前往 KataGo 发布页面 下载适合你系统的版本。

Windows 上的 KataGo

  • NVIDIA GPU：下载 CUDA 或 TensorRT 版本（例如 katago-vX.X-cuda-windows.zip）。
  • AMD GPU 或仅 CPU：下载 OpenCL 版本。

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

macOS 上的 KataGo

  • Apple Silicon (M1/M2/M3/M4)：使用 Metal 后端——通过 Homebrew 安装，运行 brew install katago，或从 KataGo 页面下载 macOS 版本。
  • Intel Mac：使用 OpenCL 后端。

下载后，你可能需要使二进制文件可执行：chmod +x katago。

Linux 上的 KataGo

  • NVIDIA GPU：下载 CUDA 或 TensorRT 版本。
  • AMD GPU：下载 OpenCL 版本。
  • 仅 CPU：下载 Eigen 版本。

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

第 2 步：下载神经网络

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

  • 默认网络（推荐）：从 KataGo 网络页面 下载 kata1-b18c384nbt-s9996 或更新的版本。18 块网络在速度和棋力之间提供了很好的平衡。
  • 更大的网络（更强但更慢）：40 块和 60 块网络需要更强的 GPU。仅在你有显存充足的高端 GPU 时使用。

将网络文件保存在与 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 引擎设置，显示 KataGo 二进制路径、配置文件和引擎状态

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

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

StoneBase 分析设置，包含访问量、线程和变化参数

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

KataGo 配置完成后：

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

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

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

故障排除

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

分析非常慢：如果你在 CPU 上运行，分析会显著变慢。考虑使用更小的网络（b6 或 b10），或者投资一块 GPU。

“加载神经网络失败”错误：仔细检查网络文件路径，以及网络版本是否与你的 KataGo 版本匹配。一些非常旧的网络与较新的 KataGo 版本不兼容。

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

常见问题

KataGo 能在 Mac 上运行吗？

能。在 Apple Silicon Mac（M1/M2/M3/M4）上，KataGo 在 Metal 后端上运行且速度非常快——可用 brew install katago 安装。在 Intel Mac 上，使用 OpenCL 后端。

运行 KataGo 需要 GPU 吗？

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

如何更新 KataGo？

从 KataGo 发布页面 下载最新版本并替换现有的 katago 二进制文件。你的配置文件和神经网络通常在版本间保持兼容，但请始终查看发布说明。

KataGo 免费吗？

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

应该使用哪个 KataGo 网络？

18 块网络（kata1-b18c384nbt）是大多数用户的最佳默认选择——棋力足以用于认真研究，在中端 GPU 上速度也很快。只有当你拥有显存充足的高端 GPU 时，才迁移到 40 块或 60 块网络。

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

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

下一步？

KataGo 运行起来后，你可以：

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

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

相关文章