前言
在 AI 与终端深度结合的今天，开发者常常需要在多个独立工具间频繁切换，导致工作流碎片化、效率低下。Wave Terminal 应运而生，它是一款开源、跨平台的 AI 集成终端，旨在将命令行操作、远程 SSH、文件编辑和 AI 对话统一到一个可自由布局的智能工作台中。通过本文，你将获得一份完整的 Wave 入门指南，从项目介绍、安装部署到基础配置与使用，帮助你快速上手，显著提升开发与运维效率。
一、Wave项目介绍
1.1 Wave项目简介
Wave是一款开源、跨平台（支持 macOS/Linux/Windows）的 AI 集成终端，允许用户通过自有 API 密钥（OpenAI/Claude/Gemini）或本地模型（Ollama/LM Studio）无缝整合 AI 能力，无需注册账户，同时提供持久化 SSH 会话与远程文件操作功能。
1.2 Wave主要特点
- 上下文感知 AI 助手：自动读取终端输出、分析界面内容并执行文件操作，提供智能交互支持。
- 持久化 SSH 会话：网络中断或终端重启后自动恢复远程连接，保障会话连续性。
- 拖放式多模块布局：自由组合终端块、编辑器、浏览器和 AI 助手，灵活定制工作区。
- 内置远程文件编辑器：支持语法高亮与现代编辑功能，直接修改远程服务器文件。
- 富媒体文件预览：内联预览远程 Markdown、图片、视频、PDF、CSV 及目录结构。
- 一键全屏切换：临时扩展任意模块（终端/编辑器/预览）至全屏，操作后即时返回多窗口布局。
- 多模型 AI 聊天小部件：兼容 OpenAI、Claude、Azure、Perplexity 及本地 Ollama 模型。
- 独立命令监控块：隔离运行并实时跟踪单个命令的执行状态与输出。
- 一键远程连接：快速建立完整终端与文件系统访问权限，简化远程操作流程。
- 系统级密钥安全存储：利用本地系统后端加密保存 API 密钥，跨 SSH 会话安全调用。
- 深度界面自定义：支持标签主题、终端样式、背景图片等个性化配置。
- wsh 命令工作流系统：通过 CLI 管理工作空间，并实现终端会话间数据共享。
- 跨主机文件同步 ：通过
wsh file无缝复制/同步本地与远程 SSH 主机间的文件。
1.3 安装要求
wsh 是 Wave 提供的强大命令行工具，让你能够从终端管理整个工作空间。以下是 Wave Terminal 与 WSH 辅助工具 的系统需求对比表：
| 平台 | Wave Terminal | WSH 辅助工具 |
|---|---|---|
| macOS | 最低版本 ：11 (Big Sur) 及以上架构：arm64 (Apple Silicon)、x64 (Intel) | 最低版本 ：11 (Big Sur) 及以上架构：arm64、x64 |
| Windows | 最低版本 ：10 1809 (2018年10月更新) 及以上架构 ：x64 (仅 64 位系统)注：不支持 ARM64 Windows | 最低版本 ：10 及以上架构：x64 (仅 64 位系统) |
| Linux | 最低要求 ：- glibc ≥ 2.28 - 内核无关 （依赖 glibc 版本）支持发行版 ： • Debian 10 (Buster) 及以上 • RHEL 8 / CentOS 8 及以上 • Ubuntu 20.04 (Focal) 及以上架构：arm64、x64 | 最低要求 ：- x64 架构 ：Linux Kernel ≥ 2.6.32- arm64 架构 ：Linux Kernel ≥ 3.1注 ：不依赖 glibc 版本 ，仅需内核达标即可架构：x64、arm64 |
二、安装Wave工具
2.1 下载Wave
- 下载地址：https://github.com/wavetermdev/waveterm/tags
当前最新版本为v0.14.5，点击最新版本即可。
由于当前安装环境为Windows10，我们选择以下
Wave-win32-x64-0.14.5.exe版本进行下载。
2.2 安装Wave工具
安装包下载完成后，双击安装包进行安装即可。
2.3 其余下载方式
三、Wave基本配置与使用
3.1 配置AI模型
在AI模型配置页面中，填写以下内容，注意将API key替换为自己的阿里云百炼平台API KEY。
bash
{
"models": [
{
"id": "qwen-3.5-bailian",
"name": "Qwen 3.5 122B (Bailian)",
"provider": "openai",
"apiBaseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "xxx",
"model": "qwen3.5-122b-a10b",
"capabilities": ["chat", "autocomplete"]
}
]
}
3.2 测试AI功能
在AI聊天对话框，进行简单提问，当AI助手能正常回答问题，则表明AI配置正常。
3.3 简单使用
根据 AI 助手提供的命令，我们可以直接将其复制并粘贴到右侧的命令行中，即可快速获得执行结果。
四、总结
Wave Terminal 通过一体化工作流、强大的 AI 集成、卓越的远程体验和高度可定制性，为开发者提供了一个高效的智能工作平台。本文详细介绍了其安装、配置与基本使用方法，帮助你快速入门。无论是日常开发还是系统运维，Wave 都能显著提升你的工作效率与操作体验。建议读者下载体验，进一步探索其高级功能，发掘全部潜力。