前言

在 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工具

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 其余下载方式

• 官网下载：https://www.waveterm.dev/download

三、Wave基本配置与使用

3.1 配置AI模型

在AI模型配置页面中，填写以下内容，注意将API key替换为自己的阿里云百炼平台API KEY。

{
  "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 都能显著提升你的工作效率与操作体验。建议读者下载体验，进一步探索其高级功能，发掘全部潜力。