OPEN SOURCE · LOCAL FIRST

把你选择的模型,
带进终端。

SuperCode 是面向真实项目的终端 AI 编码助手。本地模型、云端 API、工具调用与 Docker 沙箱统一在一个简洁工作流里。

需要 Windows 10/11 与 Node.js 20+ · 下载包不包含任何 API key

supercode — C:\projects\my-app

检查测试失败的原因并给出修复方案

▸ grep {"pattern":"TODO|FIXME"}

▸ bash {"command":"pnpm test"}

✓ 发现 2 个类型错误,已生成修复计划

3模型协议
12+内置工具
149+自动化测试
0遥测与账号依赖

BUILT FOR REAL WORK

从对话到落地执行

不绑定模型,不托管代码。你决定数据发往哪里,以及工具可以做什么。

本地模型优先

支持 LM Studio、Ollama、vLLM 与 llama.cpp,也支持任何 OpenAI-compatible API。

多模型协议

原生适配 OpenAI-compatible、Anthropic Messages 和 Google Gemini,可在会话中切换。

Docker 沙箱

命令可在一次性容器内运行,默认断网并限制 CPU 与内存;工具权限仍需审批。

MCP 与插件

连接 stdio MCP 服务器,或用一个本地 .mjs 文件扩展专属工具。

子代理与后台任务

把独立工作交给子代理;长任务在后台运行,随时读取输出或停止。

项目上下文

自动读取 AGENTS.md,保存本地会话,支持图片输入、计划模式和上下文压缩。

GET STARTED

三步开始使用

Windows 安装包是标准 npm 离线包封装;首次安装依赖需要联网。
01

安装 Node.js 20+

从 Node.js 官网安装 LTS 版本,并确认终端可以运行 node --version

02

下载并安装

解压 Windows 包,双击 install-supercode.cmd;或在终端执行:

npm install -g .\supercode-0.2.0.tgz
03

进入项目启动

复制配置模板到项目根目录,然后运行:

supercode

CONFIGURATION

密钥只留在你的电脑

配置文件只记录环境变量名称,不包含真实 key。下面的示例可连接任意 OpenAI-compatible 服务。
supercode.config.toml
default_model = "my-model"

[models.my-model]
provider = "openai-compat"
baseURL = "https://your-api.example.com/v1"
model = "your-model-name"
apiKeyEnv = "SUPERCODE_API_KEY"
contextWindow = 32768

[sandbox]
backend = "docker"
image = "node:22-alpine"
network = "none"
memory = "512m"
cpus = 1
Windows 设置环境变量setx SUPERCODE_API_KEY "YOUR_API_KEY"

设置后请重新打开终端。请勿把真实密钥提交到 Git、上传到网页或分享给他人。

SECURITY BY DEFAULT

代码和会话保存在本地

SuperCode 不要求注册账号、不包含遥测。除你配置的模型 API 与主动调用的联网工具外,项目文件和会话不会上传到 SuperCode 服务。

READY TO BUILD?

用你的模型,开始下一次提交。