twinny

VS Code 里免费用 AI 补全和对话，本地模型也能跑

twinny 是一款 Visual Studio Code 的 AI 代码补全与对话插件，定位是 GitHub Copilot 的免费替代方案。它支持本地模型和 API 托管模型两种运行方式，用户既可以通过 Ollama、llama.cpp 等工具在本地跑 CodeLlama、Llama2 等开源模型，也可以接入远程 API，兼顾隐私与灵活性。核心能力包括行内代码补全、侧边栏代码对话、基于嵌入的上下文检索，以及多模型切换。插件用 TypeScript 编写，安装后直接在编辑器内提供补全建议和问答，无需额外订阅费用。对于不想把代码上传到云端、又希望获得类似 Copilot 体验的开发者，twinny 提供了可自托管、可配置的解决方案，尤其适合对数据隐私敏感或想控制成本的个人与团队。

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3646

维护状态活跃

是否开源是

定价模式 free

项目数据

分类编程开发

开发团队twinnydotdev

所属国家

官网地址https://twinny.dev

GitHubhttps://github.com/twinnydotdev/twinny

定价模式free

价格说明完全免费，支持本地或API托管模型

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型artificial-intelligence,code-chat,code-completion,code-generation,codellama,copilot,embeddings,free,llama2,llamacpp,ollama,ollama-api,ollama-chat,private,private-ai,vscode-extension

GitHub 星标★ 3646

30天Star增速

HF 下载量

上线时间2023-08-21 00:00:00

最近更新2026-09-17 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-15

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：浏览器扩展 6 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Visual Studio Code 编辑器（需自行安装）
本地运行模型时需准备 OpenAI/Ollama 兼容的 localhost API 服务
使用在线模型时需准备对应服务商的 API 密钥
可访问 VS Code 扩展市场（离线环境需另行准备 vsix）

安装与启动步骤

1安装 twinny 插件

打开 VS Code 扩展面板，搜索 twinny 并安装；README 明确说明可通过 VS Code 扩展市场便捷安装。
2启动本地模型服务

默认使用 localhost 的 OpenAI/Ollama 兼容 API；若走本地模型，先自行把兼容服务跑起来并保持运行。
3选择 API 提供商

在插件设置中选择 provider：默认 localhost 兼容接口，也可选 OpenAI、Anthropic、OpenRouter、Deepseek、Cohere、Mistral、Perplexity、Groq。
4填写端点、模型与密钥

按所选提供商配置 API 地址、模型名、端口与路径；使用远程服务时填入对应 API Key。
5使用行内补全

正常编辑代码，插件会给出单行或多行 fill-in-the-middle 补全建议，可直接接受代码方案。
6侧边栏对话与嵌入

在侧边栏与 AI 讨论代码，可获取解释、测试与重构建议；启用 workspace embeddings 获得上下文感知辅助。

关键配置

配置项	必填	说明	示例
`API provider`	是	选择模型服务来源，默认是 localhost 兼容 API	`localhost`
`model`	是	指定用于补全和对话的模型名称	`codellama`
`port`	否	本地或自建 API 服务的监听端口	`11434`
`path`	否	自定义 API 端点路径	`/v1`
`API Key`	否	使用远程托管服务时需要填写的密钥	`sk-xxxxxxxx`
`prompt templates`	否	自定义补全与对话的提示词模板	`/your/path`

如何确认成功

VS Code 中出现 twinny 侧边栏面板，编辑代码时能看到行内补全建议，即表示插件已正常工作。

常见问题

Q：twinny 是免费的吗？

A：插件本身免费，可替代 GitHub Copilot；但如果接入 OpenAI、Anthropic 等远程付费服务，会产生相应的 API 调用费用。

Q：不想把代码上传到云端怎么办？

A：使用默认的 localhost OpenAI/Ollama 兼容 API，在本地通过 Ollama、llama.cpp 等运行 CodeLlama、Llama2 等模型即可离线工作。

Q：支持哪些模型服务商？

A：README 列出 localhost 兼容 API、OpenAI、Anthropic、OpenRouter、Deepseek、Cohere、Mistral AI、Perplexity、Groq。

Q：补全一直没有出现怎么排查？

A：先确认本地模型服务已启动，再检查插件中的 API provider、模型名、端口和路径是否与实际服务一致。

注意事项

README 未给出具体安装命令，仅说明可从 VS Code 扩展市场安装，详细步骤请参考官方文档 https://twinnydotdev.github.io/twinny-docs/
本教程未编造任何命令行安装方式，请以官方文档为准
远程服务的 API Key 请勿提交到代码仓库或公开分享
插件支持在线与离线两种运行模式，可随时切换提供商与模型

核心亮点

完全免费且开源，无订阅费用，可替代 Copilot 的付费模式
支持本地模型（Ollama、llama.cpp）和 API 托管两种方式，隐私与灵活兼顾
提供代码补全与对话双功能，并支持嵌入检索增强上下文

不足之处

本地模型补全质量和速度依赖硬件，体验可能不如云端商业模型
配置本地模型和 API 有一定门槛，新手需要花时间调试

适用场景

个人开发者在 VS Code 中免费获得 AI 代码补全
对代码隐私敏感的公司内部使用本地模型做补全
想用开源模型替代 Copilot 并自定义模型配置的开发者

替代项目

Continue、Codeium

项目介绍

twinny 是一个编程开发领域的开源项目，官方简介：The most no-nonsense, locally or API-hosted AI code completion plugin for Visual Studio Code - like GitHub Copilot but 100% free.。项目使用 TypeScript 开发，在 GitHub 上获得 3639 星标。

上一篇：LSP-copilot

下一篇：cockpit-tools