Sidekick
Sidekick 是一个面向 VS Code 的 AI 编程助手,围绕真实编码流程提供三类核心能力:侧边栏多会话聊天、编辑器内联补全、基于选区的 AI 操作。
它不绑定单一模型平台,Provider、模型、Agent 工具和 MCP Server 都由你自己配置,更适合希望掌控模型接入方式的个人开发者和团队。
截图

特性
- 多会话聊天:支持创建、切换、删除会话,聊天记录持久化保存
- 会话级模型选择:每个会话独立选择 Provider 和模型
- 上下文感知:自动收集当前选区、代码位置、部分搜索结果和 Git 信息
- 选区快捷操作:一键发起
Explain Code、Refactor、Fix Bugs、Add Tests、Document
- 内联补全:支持流式补全、缓存、防抖和局部接受
- Agent 工具调用:支持读写文件、搜索项目、执行终端命令、应用补丁等
- MCP 接入:可把已启用的 MCP 工具自动并入 Agent 工作流
- 统一控制台:在一个页面中管理 Providers、MCP、Permissions 和 General 设置
- 分级权限:终端命令按读取、项目执行、项目变更、工作区外访问、网络、高风险操作分类授权
- Git 提交信息生成:根据当前 diff 和最近提交记录生成 commit message
- 调试与可观察性:支持查看原始消息、工具调用过程、导出聊天记录、打开内联日志
适合谁用
- 想在 VS Code 中统一聊天、补全和代码操作入口的人
- 想自行接入 OpenAI、Anthropic 或兼容接口模型的人
- 需要 Agent 工具调用和 MCP 扩展能力的人
- 希望基于真实工作区和 Git 上下文进行协作编码的人
快速开始
- 安装扩展。
- 执行
Sidekick: Open Control Center。
- 添加至少一个 Provider 和模型。
- 设置
sidekick.chatProfile、sidekick.completionProfile、sidekick.agentProfile。
- 如需 MCP 工具,配置
sidekick.mcpServers。
- 如需调整默认授权行为,配置
sidekick.permissions 或在控制台中修改 Permissions。
- 从活动栏打开 Sidekick 面板开始聊天。
支持的 Provider 类型
openai-chat
openai-responses
openai-compatible
anthropic-messages
单个 Provider 下还可以通过 models[].endpointType 为不同模型指定接口类型,例如:
OPENAI
OPENAI_RESPONSE
ANTHROPIC_MESSAGES
当前控制台中的模型 Endpoint Type 选项已收敛为以上 3 种。历史的 OPENAI_COMPATIBLE* 配置在保存时会自动归一化为 OPENAI 或 OPENAI_RESPONSE。
配置项
sidekick.providers:Provider 列表
sidekick.chatProfile:聊天默认模型配置
sidekick.completionProfile:内联补全模型配置
sidekick.agentProfile:Agent / 工具调用模型配置
sidekick.mcpServers:MCP Server 列表
sidekick.permissions:终端权限默认策略,支持 allow、ask、deny
sidekick.commitMessageLanguage:提交信息语言,支持 auto、zh-CN、en
配置示例
{
"sidekick.providers": [
{
"id": "openai",
"label": "OpenAI",
"apiType": "openai-chat",
"baseUrl": "https://api.openai.com/v1",
"apiKey": "YOUR_API_KEY",
"defaultModel": "gpt-4.1",
"enabled": true,
"models": [
{
"id": "gpt-4.1",
"name": "gpt-4.1",
"endpointType": "OPENAI"
}
]
}
],
"sidekick.chatProfile": {
"providerId": "openai",
"model": "gpt-4.1",
"temperature": 0.3,
"maxTokens": 4096
},
"sidekick.completionProfile": {
"providerId": "openai",
"model": "gpt-4.1",
"temperature": 0.2,
"maxTokens": 512
},
"sidekick.agentProfile": {
"providerId": "openai",
"model": "gpt-4.1",
"temperature": 0.2,
"maxTokens": 4096
},
"sidekick.permissions": {
"terminal_read": "allow",
"terminal_project_exec": "ask",
"terminal_project_mutation": "ask",
"terminal_external_access": "ask",
"terminal_network": "ask",
"terminal_destructive": "ask"
},
"sidekick.commitMessageLanguage": "auto",
"sidekick.mcpServers": [
{
"name": "acme",
"url": "https://mcp.example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
},
"enabled": true,
"timeout": 30000
}
]
}
当前仅支持基于 HTTP 的远程 MCP Server,不支持本地 stdio 方式。
常用命令
Sidekick: Open Chat
Sidekick: Open Control Center
Sidekick: Explain Code
Sidekick: Refactor
Sidekick: Fix Bugs
Sidekick: Add Tests
Sidekick: Document
Sidekick: Generate Commit Message
Sidekick: Test Provider Connection
Sidekick: Open Inline Logs
Sidekick: Inline Debug Ping
开发
npm install
npm run compile
- 在 VS Code 中启动 Extension Development Host
打包
npx vsce package
查看最终会进入 vsix 的文件清单:
可用脚本:
npm run compile
npm run watch
npm run test:gateway
说明:
npx vsce package 会先自动执行 npm run compile