İçeriğe geç
New Kodine v2 is now available

ACP Desteği

Kodine'ı ACP uyumlu editörlerde çalıştırın.

Kodine, Agent Client Protocol (kısaca ACP) desteği sayesinde uyumlu editörlerin ve IDE’lerin içinden doğrudan kullanılabilir.

ACP; kod editörleriyle AI destekli kodlama ajanlarının birbirleriyle ortak bir dille konuşmasını sağlayan açık bir protokoldür.


Yapılandırma

Editörünüzde Kodine’ı devreye almak için editör ayarlarından kodine acp komutunu başlatıcı olarak tanımlamanız yeterlidir.

Bu komut, Kodine’ı editörünüzle stdio üzerinden JSON-RPC ile konuşan ACP uyumlu bir alt süreç olarak ayağa kaldırır.

ACP desteği bulunan yaygın editörler için hazırladığımız örnekler aşağıdadır.


Zed

Komut Paleti’ni açıp zed: acp registry komutunu çalıştırarak Kodine’ı Zed ACP Kayıt Defteri üzerinden kurabilirsiniz.

Kendi Kodine çalıştırılabilir dosyanızı kullanmayı tercih ederseniz Zed ayar dosyanıza (~/.config/zed/settings.json) şu bloğu ekleyin:

~/.config/zed/settings.json
{
"agent_servers": {
"Kodine": {
"type": "custom",
"command": "kodine",
"args": ["acp"]
}
}
}

Kodine’ı başlatmak için Komut Paleti içinden agent: new thread eylemini seçin.

Dilerseniz keymap.json dosyanıza bir kısayol tanımı ekleyerek klavyeden de erişebilirsiniz:

keymap.json
[
{
"bindings": {
"cmd-alt-o": [
"agent::NewExternalAgentThread",
{
"agent": {
"custom": {
"name": "Kodine",
"command": {
"command": "kodine",
"args": ["acp"]
}
}
}
}
]
}
}
]

JetBrains IDEs

JetBrains IDE tarafında, ilgili belgelerde anlatıldığı şekilde acp.json dosyanıza aşağıdaki tanımı ekleyin:

acp.json
{
"agent_servers": {
"Kodine": {
"command": "/absolute/path/bin/kodine",
"args": ["acp"]
}
}
}

Ardından AI Chat panelindeki ajan seçicisinden ‘Kodine’ seçeneğini işaretleyerek sohbete başlayabilirsiniz.


Avante.nvim

Avante.nvim kurulumunuzda şu yapılandırmayı kullanın:

{
acp_providers = {
["kodine"] = {
command = "kodine",
args = { "acp" }
}
}
}

Ortam değişkeni aktarmanız gerekirse:

{
acp_providers = {
["kodine"] = {
command = "kodine",
args = { "acp" },
env = {
KODINE_API_KEY = os.getenv("KODINE_API_KEY")
}
}
}
}

CodeCompanion.nvim

CodeCompanion.nvim içinde Kodine’ı ACP ajanı olarak tanımlamak için Neovim yapılandırmanıza şunları ekleyin:

require("codecompanion").setup({
interactions = {
chat = {
adapter = {
name = "kodine",
model = "kodine-code",
},
},
},
})

Bu tanımla CodeCompanion, sohbet görünümünde Kodine’ı ACP ajanı olarak çalıştırır.

KODINE_API_KEY benzeri ortam değişkenlerini nasıl geçireceğinizi öğrenmek için CodeCompanion.nvim belgelerindeki Configuring Adapters: Environment Variables bölümüne göz atın.

Destek

ACP üzerinden bağlandığınızda Kodine, terminaldekiyle aynı biçimde davranır ve tüm yetenekleri kullanılabilir durumdadır:

  • Yerleşik araçlar (dosya işlemleri, terminal komutları vb.)
  • Özel araçlar ve slash komutları
  • Yapılandırmanızda tanımlı MCP sunucuları
  • AGENTS.md ile belirlediğiniz proje kuralları
  • Özel biçimlendiriciler ve linter’lar
  • Ajanlar ve izin sistemi