블로그로 돌아가기

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의 분석 엔진(analysis engine) 모드를 사용하며, GTP 모드를 사용하지 않습니다. 분석 설정 파일(예: analysis_example.cfg)을 사용해야 하며, GTP 설정(예: default_gtp.cfg)을 사용하면 안 됩니다. 잘못된 설정 형식을 사용하면 KataGo가 올바르게 시작되지 않습니다.

어떤 설정을 사용해야 할지 확실하지 않다면, StoneBase가 제공할 수 있습니다. 엔진 설정 페이지에서 KataGo 분석 설정 예제 다운로드를 클릭하여 바로 사용 가능한 템플릿을 받으세요.

검토해야 할 주요 설정:

  • numSearchThreads: KataGo가 검색에 사용하는 스레드 수. 대부분의 GPU에서 1-2로 시작하세요.
  • maxVisits: 수당 평가할 최대 위치 수. 500-1000이 좋은 시작점입니다.

대부분의 사용자에게 기본 분석 설정은 별다른 조정 없이 잘 작동합니다.

4단계: StoneBase 설치

StoneBase는 KataGo를 구동하고 전체 복기 UI를 제공하는 무료 데스크톱 앱입니다. 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를 열고 설정(Settings) 으로 이동하세요. KataGo 섹션에서 다음을 설정합니다:

  1. KataGo 바이너리 경로: 1단계의 katago 실행 파일을 가리키도록 설정하세요.
  2. 신경망 경로: 2단계의 .bin.gz 네트워크 파일을 가리키도록 설정하세요.
  3. 설정 파일 경로: 3단계의 .cfg 분석 설정 파일을 가리키도록 설정하세요. 아직 없다면 설정 페이지에서 KataGo 분석 설정 예제 다운로드를 클릭하여 바로 사용 가능한 템플릿을 받으세요.

KataGo 바이너리 경로, 설정 파일, 엔진 상태를 보여주는 StoneBase 엔진 설정

저장(Save) 을 클릭하면 StoneBase가 연결을 확인합니다. 모든 것이 올바르게 설정되었다면 확인 메시지가 표시됩니다.

분석(Analysis) 탭에서 분석 파라미터(최대 방문 수, 스레드, 변화 수)를 세부 조정할 수도 있습니다:

방문 수, 스레드, 변화 파라미터가 있는 StoneBase 분석 설정

6단계: 첫 번째 기보 분석

KataGo가 설정되었습니다:

  1. SGF 파일을 가져오거나 라이브러리에서 기보를 선택하세요.
  2. 도구 모음의 분석(Analyze) 버튼을 클릭하세요.
  3. KataGo가 각 수를 평가하여 다음을 보여줍니다:
    • 승률: 각 플레이어의 승리 확률
    • 점수 예상치: 예상되는 점수 차이
    • 추천 수: AI의 최상위 수 제안과 그 평가
    • 주요 변화(principal variation): 예상되는 착수 순서

기보를 탐색하며 각 수에서 평가가 어떻게 변화하는지 확인하세요. 승률의 큰 하락은 가장 큰 실수를 강조합니다 — 가장 주의 깊게 연구할 가치가 있는 국면입니다.

AI 분석이 처음이라면, 숫자에서 결론을 내리기 전에 KataGo 승률 및 점수 예상치 해석에 관한 짧은 가이드를 먼저 읽어보세요 — 5%의 변동을 “실수”로 오독하는 것은 초보자가 자주 하는 함정입니다.

문제 해결

KataGo가 시작되지 않음: 바이너리 경로가 실제 katago 실행 파일(폴더가 아닌)을 가리키는지 확인하세요. macOS/Linux에서는 chmod +x katago가 필요할 수 있습니다.

분석이 매우 느림: CPU에서 실행 중이라면 분석이 상당히 느려집니다. 더 작은 네트워크(b6 또는 b10)를 고려하거나 GPU에 투자하세요.

“Failed to load neural net” 오류: 네트워크 파일 경로를 다시 확인하고 네트워크 버전이 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와 충분한 VRAM이 있는 경우에만 40블록 또는 60블록 네트워크로 이동하세요.

KataGo vs Leela Zero: 기보 복기에 어떤 것이 더 좋나요?

KataGo는 활발히 유지 관리되고, 점수 예상(승률뿐만 아니라)을 지원하며, 다양한 규칙(일본/중국/한국)을 처리하고, 현재 Leela Zero보다 더 강력한 것으로 간주됩니다. 현대 바둑 기보 복기에는 KataGo가 권장되는 선택입니다.

다음 단계는?

KataGo가 실행되면 다음을 할 수 있습니다:

  • 개별 기보 복기하여 실수와 놓친 기회를 찾으세요
  • 전체 라이브러리 일괄 분석(Pro 기능)하여 모든 기보에 대한 AI 평가를 한 번에 받으세요
  • 변화 탐색하며 돌을 놓고 KataGo가 다양한 후속 수를 어떻게 평가하는지 확인하세요

당신의 읽기 능력과 KataGo의 초인적인 평가의 조합은 게임의 약점을 식별하고 실력을 향상시키는 가장 빠른 방법입니다.

관련 글