快速开始

本指南将帮助你在几分钟内完成 AI-Launcher 的安装和配置。

下载安装

1

购买 AI-Launcher

访问 咸鱼商店 购买 AI-Launcher。购买后,您将获得下载链接和激活码。

2

下载安装包

根据您的操作系统下载对应的安装包:

  • Windows — AI-Launcher-Setup-x.x.x.exe
  • macOS — AI-Launcher-x.x.x.dmg
  • Linux — AI-Launcher-x.x.x.AppImage
3

运行安装程序

双击安装包,按照提示完成安装。安装过程中可能需要管理员权限。

注意: Windows 用户可能需要在 SmartScreen 弹窗中选择"仍要运行"。

首次启动

安装完成后,双击桌面图标启动 AI-Launcher。首次启动时,程序会自动检测系统环境并完成初始化。

# 首次启动日志
检测系统环境...
初始化配置文件...
加载工具列表...
准备就绪

安装 Claude Code

Claude Code 是 Anthropic 官方的 AI 编程助手 CLI,以下是安装步骤:

1

在左侧工具列表中选择 "Claude Code"

程序会自动检测 Claude Code 的安装状态

2

点击 "开始安装" 按钮

AI-Launcher 会自动处理所有依赖和配置

3

等待安装完成(通常需要 2-5 分钟)

可以在终端面板查看实时安装日志

# 安装日志示例
$ 正在检测 Node.js...
Node.js 已安装: v20.18.0
$ 正在配置 npm...
npm 全局安装路径已配置
$ 正在安装 Claude Code...
Claude Code 安装成功
$ 正在初始化配置...
配置文件已创建

安装 CCSwitch

CCSwitch 是一个统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 供应商配置的工具,安装步骤与 Claude Code 类似:

  1. 在左侧工具列表中选择 "CCSwitch"
  2. 点击 "开始安装" 按钮
  3. 等待安装完成

提示: CCSwitch 依赖 Claude Code,请确保先安装 Claude Code。

验证安装

安装完成后,打开终端并运行以下命令验证安装是否成功:

# 验证 Claude Code
$ claude --version
Claude Code v2.1.161
# 验证 CCSwitch
$ ccswitch --version
CCSwitch v3.15.0

环境配置

AI-Launcher 会自动配置大部分环境,但您可能需要了解以下内容:

npm 镜像配置

AI-Launcher 默认使用 npmmirror 国内镜像,确保下载速度。如果您需要切换镜像源:

$ npm config set registry https://registry.npmmirror.com

环境变量

AI-Launcher 会自动将 npm 全局安装路径添加到 PATH 环境变量。如果手动安装后找不到命令,请检查:

  • Windows:%USERPROFILE%\.npm-global
  • macOS/Linux:~/.npm-global/bin

常见问题

Q: 安装失败怎么办?

请检查网络连接,或尝试使用管理员权限运行 AI-Launcher。如果问题仍然存在,请通过微信联系我们。

Q: 安装后找不到 claude 命令?

请重新打开终端,或手动将 npm 全局安装路径添加到 PATH 环境变量。

Q: 支持哪些操作系统?

AI-Launcher 支持 Windows 10/11、macOS 10.15+ 和主流 Linux 发行版。

Q: 如何更新已安装的工具?

AI-Launcher 会自动检测工具更新,您也可以在工具详情页面手动触发更新。

更新日志

v1.0.0 — 2026-06-01

  • • 首次发布
  • • 支持 Claude Code 一键安装
  • • 支持 CCSwitch 一键安装
  • • 国内镜像加速
  • • 自动环境检测和配置