Multica Docs

Yapay zekâ kodlama araçlarını kurma

Multica'nın makinenizde çalıştırmalar yürütebilmesi için desteklenen bir yapay zekâ kodlama aracını kurun ve giriş yapın.

Yerel bir runtime'ın iki parçası vardır: Multica daemon'ı ve onun çağırabileceği bir yapay zekâ kodlama aracı. Yalnızca kullanmayı düşündüğünüz aracı kurun — hepsine ihtiyacınız yok.

1. Bir araç seçin

Zaten kurulu ve giriş yapılmış bir araç ekstra kurulum gerektirmez. Araçlar; modeller, MCP, oturum sürdürme ve skill desteği açısından farklılık gösterir; ayrıntılar Yapay zekâ kodlama araçları karşılaştırması'nda.

Multica şu anda şu komutları algılar:

AraçAlgılanan komutResmi kurulum rehberi
Antigravity CLIagyAntigravity kurulum ve giriş
Claude CodeclaudeClaude Code hızlı başlangıcı
CodeBuddy CodecodebuddyCodeBuddy hızlı başlangıcı
CodeArtscodeartsCodeArts CLI hızlı başlangıcı
Codex CLIcodexCodex CLI
GitHub Copilot CLIcopilotCopilot CLI'ı kurma
Cursor Agentcursor-agentCursor CLI'ı kurma
DeepSeek HarnessdshDeepSeek Harness
DevEco CodedevecoDevEco Code
Grok BuildgrokGrok Build hızlı başlangıcı
Hermes AgenthermesHermes hızlı başlangıcı
Kimi CLIkimiKimi CLI
Kiro CLIkiro-cliKiro CLI'ı kurma
MiniMax CodemcodeMiniMax Code CLI'ı kurma
OpenClawopenclawOpenClaw'ı kurma
OpenCodeopencodeOpenCode hızlı başlangıcı
Pi coding agentpiPi coding agent
Oh-My-PiompOh-My-Pi kurulumu
Qoder CLIqodercliQoder CLI hızlı başlangıcı
Qoder CN CLIqoderclicnQoder CN CLI hızlı başlangıcı
Qwen CodeqwenQwen Code
QwenPawqwenpawQwenPaw
ReasonixreasonixReasonix
TRAE CLItraecliTRAE resmi sitesi
DimdimDimCode

"Desteklenir", Multica'nın o CLI'ı çağırabileceği anlamına gelir. Multica'nın aracın hesabını, aboneliğini veya model kotasını sizin için sağladığı anlamına gelmez.

2. Makinenizde giriş yapın

Kurduktan sonra, aracı bir terminalde tek başına bir kez çalıştırın ve giriş veya model sağlayıcı kurulumunu tamamlayın. Araç terminalde istekleri tamamlayamıyorsa, daemon'un çağırmaları da aynı şekilde başarısız olur.

CodeArts için, yalnızca TUI'yi değil, etkileşimsiz yolu da codearts run --model provider/model "Reply OK" ile doğrulayın. Güncel CodeArts CLI'ı özel bir sağlayıcının TUI'de çalışmasına izin verirken, run, models ve serve hâlâ CODEARTS_CLI_AK / CODEARTS_CLI_SK gerektirir. Multica özel modelleri ~/.codeartsdoer/codearts_cli.json veya .jsonc'den keşfedebilir, ama agent çalıştırmaları codearts run kullanır ve bu yüzden onun yetkilendirme gereksinimlerini izler.

Reasonix için, daemon'ı başlatmadan önce reasonix setup çalıştırın ve varsayılan bir sağlayıcı ve model yapılandırın.

QwenPaw için, sağlayıcıyı ve modeli QwenPaw'un kendi yapılandırmasında seçin. Multica bir QwenPaw modelini çalışma zamanında geçersiz kılamaz.

MiniMax Code için, desteklenen bir Node.js sürümü kurun (>=22.19 <23 veya >=24 <27) ve npm install --global @minimax-ai/code@latest çalıştırın. Küresel bir npm kurulumu mcode'u npm'in küresel ikili dosya yoluna yerleştirir; command -v mcode veya Get-Command mcode onu bulamıyorsa, o yolu PATH'e ekleyin. Sonra mcode login çalıştırın. Model seçimi MiniMax Code'a aittir; Multica bunu ACP üzerinden geçersiz kılamaz.

DeepSeek Harness için, Node.js 20+ kurun ve npm install -g @deepseek-ai/dsh çalıştırın, ardından ona Multica runtime profilini verin — Multica'nın kullandığı --stdio protokolünü uygulayan paket, ve yalın bir dsh'nin tek başına kullanılamamasının nedeni. Kurulacak paketi MULTICA_DSH_PROFILE_BUNDLE'a ayarlayın, daemon onu sizin için eklesin, veya dsh plugin --profile multica add <bundle> ile kendiniz ekleyin. <bundle>, dsh plugin'in kabul ettiği her şeydir — bir npm paket adı, bir dizin veya paketlenmiş bir tarball — ve Multica'nın kendi köprüsü multica-ai/dsh-multica-runtime adresinde yaşar. Henüz herkese açık bir npm kayıt defterinde değildir (multica#6936), bu yüzden bugün kendi sunucusunda barındıran bir takım onu bu depodan derler ve değişkeni derleme dizinine ya da npm pack'in ürettiği tarball'a işaret eder — daemon'ı çalıştıran makine onu derleyen makine değilse ikincisini kullanın. Köprü yayınlandığında bir paket adı en basit seçenek haline gelir. Ne seçerseniz seçin, kendi takımınızın yayınladığı veya derlediği bir şeyi tercih edin: bu değer, başka bir onay olmadan her daemon host'unun DSH ana dizinine kurulur, bu yüzden denetlenmemiş üçüncü taraf bir paket bir kolaylık değil, bir tedarik zinciri kararıdır. npm paketi yerine DeepSeek Harness Desktop'ı kurduysanız, daemon o uygulamanın ürettiği CLI shim'lerini de kendi kullanıcı başına veri dizininde arar — macOS'ta ~/Library/Application Support/DSH Desktop, Windows'ta %APPDATA%\DSH Desktop. Windows'ta bu, kurulum dizini değil, dolaşan uygulama verisidir: uygulama Program Files'a veya %LOCALAPPDATA%\Programs'a kurulur, ama çalıştırdığı CLI diğer kullanıcı başına durumunun yanında yaşar. Bu yollardaki sürüm bölümü üretilmiş bir id'dir, bu yüzden daemon onları numaralandırır ve en yenisini tercih eder. PATH'te başka hiçbir şeye gerek yoktur — üretilmiş bir shim, Desktop uygulamasının kendi runtime'ını mutlak yoldan çalıştırır. DSH Desktop varsayılan olmayan bir yere kurulduysa, MULTICA_DSH_PATH'i shim'e işaret edin. Daemon, DeepSeek Harness'ı yalnızca dsh --profile multica --probe başarılı olduktan sonra kaydeder ve başarısız olduğunda eksik profili /health'te bildirir. Daemon'ı başlatmadan önce DEEPSEEK_API_KEY'i ayarlayın (veya dsh'nin kendi ayarlarında saklayın).

Bu giriş kimlik bilgileri, aracın kendisi tarafından yerel olarak saklanır. Multica, Claude, Codex, Cursor veya başka herhangi bir CLI'dan asla giriş token'ı almaz.

Antigravity 1.1.10 veya sonrasını, Claude Code 2.0.0 veya sonrasını, Codex 0.100.0 veya sonrasını, Copilot 1.0.0 veya sonrasını, Grok 0.2.89 veya sonrasını, Qwen Code 0.20.0 veya sonrasını, MiniMax Code 0.1.2 veya sonrasını ve OpenCode 1.1.54 veya sonrasını gerektirir. Minimum sürümün altında, daemon ilgili runtime'ı kaydetmez.

3. Daemon'ın komutu bulabildiğini doğrulayın

macOS, Linux veya WSL'de çalıştırın:

command -v <command>
<command> --version

Windows PowerShell'de çalıştırın:

Get-Command <command>
<command> --version

<command>'ı tablodan bir komutla değiştirin, örneğin claude, codex veya cursor-agent. İlk komut, çalıştırılabilir dosyanın yolunu yazdırır.

Terminal aracı buluyor ama Desktop veya arka plan daemon'ı bulamıyorsa, ikisi genellikle farklı PATH değerleri kullanıyordur. Uygulamayı yeniden başlatın, veya eşleşen MULTICA_<PROVIDER>_PATH ortam değişkeni aracılığıyla mutlak bir yol ayarlayın; tam yapılandırma Ortam değişkenleri'nde.

4. Yeniden algılayın ve runtime'ın çevrimiçi olduğunu doğrulayın

Daemon'ı CLI ile başlatın:

multica daemon start

Daemon zaten çalışıyorsa, yeni bir araç kurduktan sonra yeniden başlatın:

multica daemon restart

Multica Desktop ile, uygulamadan çıkın ve yeniden açın.

Ardından Multica'nın Runtime'lar sayfasını açın. Araç, hedef bilgisayarın altında görünür ve çevrimiçi olarak gösterilir. Artık bir agent oluştururken veya düzenlerken bu runtime'ı seçebilirsiniz.

Daemon başlamadan önce yerleşik desteklenen CLI'lardan en az birini algılamalıdır. Özel runtime profilleri daemon ayağa kalktıktan sonra senkronize olur, bu yüzden boş bir makinede tek başlangıç koşulu olamazlar. Bir istisna vardır: daemon, DSH runtime profilini kendisi kurmaya yeni başladığında (MULTICA_DSH_PROFILE_BUNDLE), hiçbir runtime olmadan başlar ve o kurulum bittiğinde DeepSeek Harness'ı kaydeder. Bu olmasaydı, tek aracı profile ihtiyaç duyan bir DSH olan bir host kurulumu asla tamamlayamazdı — daemon, kurulum bitmeden çıkar ve onu da beraberinde götürürdü.

Hiçbir araç algılanmadı

Sırayla kontrol edin:

  1. Kurulumun ve girişin tamamlandığını doğrulamak için aracın kendisini bir terminalde çalıştırın.
  2. Gerçek komut adını ve yolunu command -v veya Get-Command ile kontrol edin.
  3. multica daemon logs -f çalıştırın ve sürüm, yol veya kimlik doğrulama hatalarına bakın.
  4. Daemon'ın geçerli ortamı yeniden okuması için yeniden başlatın.
  5. Runtime'lar sayfasına dönün ve bilgisayarın ve aracın çevrimiçi olduğunu doğrulayın.

Araç çevrimiçi görünüyor ama çalıştırmalar hâlâ başarısız oluyorsa, CLI'ın döndürdüğü tam hatayı görmek için işin çalıştırma kaydını açın, veya Sorun Giderme ile devam edin.

Sonraki adımlar