跳转到内容

ACP 支持

在任何兼容 ACP 的编辑器中使用 Vikasit Code。

Vikasit Code 支持 Agent Client Protocol(ACP),允许你直接在兼容的编辑器和 IDE 中使用它。

ACP 是一个开放协议,用于标准化代码编辑器与 AI 编码代理之间的通信。


配置

要通过 ACP 使用 Vikasit Code,请在编辑器中配置运行 vikasit acp 命令。

该命令会将 Vikasit Code 作为兼容 ACP 的子进程启动,通过 stdio 上的 JSON-RPC 与编辑器进行通信。

以下是支持 ACP 的常用编辑器的配置示例。


Zed

添加到你的 Zed 配置文件(~/.config/zed/settings.json)中:

~/.config/zed/settings.json
{
"agent_servers": {
"Vikasit Code": {
"command": "vikasit",
"args": ["acp"]
}
}
}

打开方式:在命令面板中执行 agent: new thread 操作。

你也可以通过编辑 keymap.json 来绑定键盘快捷键:

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

JetBrains IDEs

根据文档,将以下内容添加到你的 JetBrains IDE 的 acp.json 中:

acp.json
{
"agent_servers": {
"Vikasit Code": {
"command": "/absolute/path/bin/vikasit",
"args": ["acp"]
}
}
}

打开方式:在 AI Chat 代理选择器中选择新的 ‘Vikasit Code’ 代理。


Avante.nvim

添加到你的 Avante.nvim 配置中:

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

如果需要传递环境变量:

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

CodeCompanion.nvim

要在 CodeCompanion.nvim 中将 Vikasit Code 用作 ACP 代理,请将以下内容添加到你的 Neovim 配置中:

require("codecompanion").setup({
interactions = {
chat = {
adapter = {
name = "vikasit",
model = "claude-sonnet-4",
},
},
},
})

此配置将 CodeCompanion 设置为使用 Vikasit Code 作为聊天的 ACP 代理。

如果需要传递环境变量(如 VIKASIT_API_KEY),请参阅 CodeCompanion.nvim 文档中的配置适配器:环境变量了解详细信息。

支持

Vikasit Code 通过 ACP 使用时与在终端中使用的效果完全一致。所有功能均受支持:

  • 内置工具(文件操作、终端命令等)
  • 自定义工具和斜杠命令
  • 在 Vikasit Code 配置中配置的 MCP 服务器
  • 来自 AGENTS.md 的项目级规则
  • 自定义格式化工具和代码检查工具
  • 代理和权限系统