VibeCoding 是一个基于终端的 AI 编码助手,帮助你编写、调试、重构和理解代码。它支持多种 LLM 提供商,包括 DeepSeek(默认)、OpenAI、Anthropic 以及任何 OpenAI/Anthropic 兼容的 API。

vibecoding-gui

vibecoding-gui是一个专注于开发图形用户界面的开源项目,提供丰富的组件和工具,支持跨平台应用开发,旨在简化UI设计与实现。

MothX

MothX (原 VibeCoding) 是一个基于终端的超高 Token 缓存命中率、极致省钱的终端 AI 代码助手 AI 编码助手,帮助你编写、调试、重构和理解代码。它支持多种 LLM 提供商,包括 DeepSeek(默认)、OpenAI、Anthropic 以及任何 OpenAI/Anthropic 兼容的 API。

GoStreamingMarkdown

NimCode

NimCode is an AI coding assistant that runs in your terminal, written in pure Nim with no external dependencies.

SseNimHttpClient

纯 Nim 实现的 SSE HTTP 客户端,从零构建 TCP + TLS,零第三方依赖。

llmspeedtest

测试 OpenAI Chat 和 Anthropic 格式模型的速度,测量首次响应延迟和每秒 Token 数。

自定义精选项目

最多可选取 6 个公开仓库

还能勾选 6 个

组织介绍

[画像:VibeCoding]

VibeCoding

一个基于终端的 AI 编码助手,使用约 10,000 行 Go 代码编写,灵感来源于功能特性

多提供商支持:DeepSeek(默认)、OpenAI、Anthropic,以及任何通过 OpenAI/Anthropic 兼容 API 的自定义提供商
SSE 流式传输:实时令牌流式传输,快速响应
思考模式:扩展思考/推理支持(DeepSeek 推理)
三种模式:
- 🗒️ 计划 — 只读分析和规划。沙箱化,无文件写入
- 🔧 代理(默认)— 对项目的受控读写访问。Bash 需要批准(可配置白名单)。沙箱化,无网络
- 🚀 YOLO — 完全系统访问,无限制

bwrap 沙箱:通过快速开始

安装

选项 1:npm(推荐)

npm install -g vibecoding-installer

选项 2:一键安装

Linux/macOS:

curl -fsSL https://raw.githubusercontent.com/startvibecoding/vibecoding/main/install.sh | bash

Windows(PowerShell):

irmhttps://raw.githubusercontent.com/startvibecoding/vibecoding/main/install.ps1|iex

或自定义安装目录:

# Linux/macOS
INSTALL_DIR=~/.local/bin curl -fsSL https://raw.githubusercontent.com/startvibecoding/vibecoding/main/install.sh | bash

# Windows
$env:VIBECODING_INSTALL_DIR="C:\Tools\vibecoding"; irm https://raw.githubusercontent.com/startvibecoding/vibecoding/main/install.ps1 | iex

选项 3:Go 安装

go install github.com/startvibecoding/vibecoding/cmd/vibecoding@latest

选项 4:从源码构建

git clone https://github.com/startvibecoding/vibecoding.git
cd vibecoding
make build

交叉编译

make build-all # 为 linux/amd64、darwin/amd64、darwin/arm64、windows/amd64 构建

配置

设置 API 密钥:

# DeepSeek
export DEEPSEEK_API_KEY=sk-...

或直接在 settings.json 中配置:

{
"providers":{
"deepseek-openai":{"apiKey":"sk-..."}
}
}

运行

# 交互模式
vibecoding

# 带初始提示
vibecoding "解释这个代码库"

# 非交互模式(打印模式)
vibecoding -p "用 Go 写一个 hello world"

# 指定提供商和模型
vibecoding --provider deepseek-openai --model deepseek-v4-flash

# 更改模式
vibecoding --mode plan # 只读规划
vibecoding --mode agent # 标准模式(默认)
vibecoding --mode yolo # 完全访问

# 继续最近会话
vibecoding -c

# 禁用沙箱
vibecoding --no-sandbox

配置

配置文件

位置	平台	范围
`~/.vibecoding/settings.json`	Linux/macOS	全局(所有项目)
`%APPDATA%\vibecoding\settings.json`	Windows	全局(所有项目)
`.vibe/settings.json`	所有	项目(覆盖全局)

Windows 用户: %APPDATA% 解析为 C:\Users\<用户名>\AppData\Roaming。

示例配置

{
"defaultProvider":"deepseek-openai",
"defaultModel":"deepseek-v4-flash",
"defaultThinkingLevel":"medium",
"defaultMode":"agent",
"maxContextTokens":1000000,
"maxOutputTokens":384000,
"compaction":{
"enabled":true,
"reserveTokens":16384,
"keepRecentTokens":20000
},
"sandbox":{
"enabled":true,
"level":"standard",
"allowNetwork":false
},
"contextFiles":{
"enabled":true
},
"retry":{
"enabled":true,
"maxRetries":3,
"baseDelayMs":2000
},
"approval":{
"bashWhitelist":["go ","make ","git ","npm ","yarn "],
"bashBlacklist":["rm -rf","sudo"]
}
}

环境变量

变量	描述
`DEEPSEEK_API_KEY`	DeepSeek API 密钥
`VIBECODING_DIR`	覆盖配置目录
`VIBECODING_PROVIDER`	覆盖默认提供商
`VIBECODING_MODEL`	覆盖默认模型
`VIBECODING_MODE`	覆盖默认模式
`VIBECODING_THINKING`	覆盖默认思考级别
`VIBECODING_USER_AGENT`	自定义用户代理字符串

沙箱安全

VibeCoding 使用模式文件系统网络 bwrap 计划(严格) 项目只读 ✗ ✓ 代理(标准) 项目读写 ✗ ✓ YOLO(无) 完全访问 ✓ ✗

安装 bwrap

# Debian/Ubuntu
sudo apt install bubblewrap

# Fedora
sudo dnf install bubblewrap

# Arch
sudo pacman -S bubblewrap

CLI 参考

vibecoding [标志] [消息...]
别名:vc

标志:
 -p, --provider string 提供商 (deepseek-openai, deepseek-anthropic 或自定义提供商名称)
 -m, --model string 模型 ID
 -M, --mode string 模式 (plan, agent, yolo)
 -t, --thinking string 思考级别 (off, minimal, low, medium, high, xhigh)
 -c, --continue 继续最近会话
 -r, --resume string 通过 ID 或路径恢复会话
 --session string 使用特定会话文件或 ID
 --sandbox 启用沙箱 (bwrap) 进行安全执行
 -P, --print 打印响应并退出(非交互式)
 --verbose 详细输出
 --debug 启用调试日志
 -v, --version 显示版本
 -h, --help 显示帮助

交互式命令

命令	描述
`/mode [plan\|agent\|yolo]`	切换模式
`/model`	显示当前模型
`/think`	循环思考级别
`/skills`	列出已加载技能
`/clear`	清除对话
`/help`	显示帮助
`/quit`	退出

键盘快捷键

按键	操作
`Ctrl+C`	中止/清除输入
`Ctrl+D`	退出
`Tab`	循环思考级别
`Ctrl+T`	切换思考显示

开发

make build # 构建二进制文件
make test # 运行测试
make lint # 运行代码检查
make fmt # 格式化代码
make clean # 清理构建产物
make build-all # 为所有平台交叉编译
make dist # 构建分发包 (.deb, .tar.gz)

架构

vibecoding/
├── cmd/vibecoding/ # CLI 入口点
├── internal/
│ ├── agent/ # 核心代理循环
│ ├── config/ # 配置系统
│ ├── context/ # 上下文管理和令牌估算
│ ├── contextfiles/ # 上下文文件发现 (AGENTS.md, CLAUDE.md 等)
│ ├── platform/ # 跨平台兼容性工具
│ ├── provider/ # LLM 提供商抽象
│ │ ├── openai/ # OpenAI Chat Completions API
│ │ └── anthropic/ # Anthropic Messages API
│ ├── sandbox/ # 沙箱 (bwrap) 实现
│ ├── session/ # 会话管理 (JSONL)
│ ├── skills/ # 技能系统
│ ├── tools/ # 工具实现
│ ├── tui/ # 终端界面 (BubbleTea)
│ └── ua/ # 用户代理字符串生成
└── pkg/sdk/ # 公共 SDK 接口