安装和使用 IaC Code 桌面版

IaC Code 桌面版将云资源规划、IaC 生成和校验、费用评估、资源栈管理、项目与会话等能力封装为原生应用。本文介绍桌面版的下载、安装、首次配置和基本使用方法，适合希望直接通过图形界面管理云资源、不希望单独配置 Python 环境的用户。

前提条件

• 使用桌面版支持的操作系统和处理器架构。

• 可以访问 IaC Code 官方下载地址和所使用的模型服务。

• 已准备模型服务的 API Key。查询或管理阿里云资源时，还需准备具有相应 RAM 权限的阿里云身份。

• 项目目录允许当前操作系统用户读写。IaC Code 会在该目录中读取 IaC 文件并保存任务产物。

桌面版已经包含运行 IaC Code 所需的环境，无需另外安装 Python 或通过 pip 安装 iac-code。

下载桌面版

通过以下固定地址下载对应平台的最新稳定版：

固定地址始终指向对应平台的最新稳定版，不需要在每次发布后修改下载链接。需要历史版本、校验和或软件物料清单（SBOM）时，请访问 GitHub Releases。

安装桌面版

macOS

1. 打开下载的 DMG 文件。

2. 将 IaC Code 拖入“应用程序”目录。

3. 从“应用程序”中启动 IaC Code。

正式发布的安装包使用 Apple Developer ID 签名并经过 Apple 公证。如果系统仍然提示无法验证开发者，请先确认文件来自官方地址，并核对 GitHub Releases 提供的校验和。

Windows

1. 运行下载的 EXE 安装程序。

2. 按照安装向导完成当前用户安装，然后通过开始菜单或桌面快捷方式启动 IaC Code。

3. 首次启动时等待环境检查完成。如果 Windows 尚未安装 Git Bash，启动页会提供快捷安装入口；完成安装后重新启动 IaC Code。

正式发布的 Windows 安装包带有 Authenticode 发布者签名。如果 Microsoft Defender SmartScreen 仍然显示警告，请先核对发布者和校验和，再决定是否继续。

Linux AppImage

为安装包添加执行权限并启动：

chmod +x iac-code-linux-x64.AppImage
./iac-code-linux-x64.AppImage

AppImage 可以直接运行，不需要安装到系统目录。桌面环境是否创建应用启动器取决于当前发行版和桌面设置。

Debian 或 Ubuntu

使用 APT 安装 deb 包，以便系统处理所需依赖：

sudo apt install ./iac-code-linux-x64.deb

安装完成后，从应用菜单启动 IaC Code。

完成首次配置

1. 启动 IaC Code，选择一个项目目录。该目录将作为文件读取、IaC 生成、工具执行和会话的工作区。

2. 打开“设置 > 模型”，选择模型提供商和模型，填写 API Key；使用兼容接口时，按需填写 API Base URL。

3. 保存配置并将模型设为当前模型。需要时可以继续配置推理强度、最大输出 Token 等参数。

4. 查询或管理阿里云资源时，打开“设置 > 云凭证”，设置默认地域并选择认证方式：

5. 保存云凭证，确认模型和阿里云条目均显示为可用状态。

桌面版与 REPL、Headless 和 Web 版默认复用 ~/.iac-code/ 中的配置和会话。通过 IAC_CODE_CONFIG_DIR 使用其他配置目录时，需要从相同环境启动桌面版，才能读取对应配置。

创建第一个会话

1. 单击“新对话”，确认当前项目目录和模型。

2. 选择普通模式或适用的 Pipeline，并根据任务设置权限模式。

3. 输入以下只读请求：

   查询 cn-hangzhou 当前账号下的 ROS 资源栈，按状态分组并说明异常原因。只查询，不要执行写操作。

4. 查看 IaC Code 展示的执行进度和工具调用。出现权限请求时，核对工具、参数、地域和目标资源，再批准或拒绝。

预期结果：IaC Code 查询资源栈并返回分组结果和异常说明，工具调用与审批记录保留在当前会话中。之后可以继续要求 IaC Code 规划新环境、选择云资源、生成和校验 ROS 或 Terraform 配置、估算费用，并在确认后完成部署或变更。

使用桌面工作台

桌面版支持 English、简体中文、日本語、Français、Deutsch、Español 和 Português。可以在“设置 > 常规”中修改界面语言和配色主题。

更新和卸载

macOS、Windows 和 AppImage 版本支持应用内检查和安装稳定版更新。更新包会在安装前验证签名。deb 版本不使用应用内更新，请重新下载并安装新版 deb 包。

卸载桌面版不会自动删除 ~/.iac-code/ 中的模型配置、云凭证、会话和日志：

• macOS：退出应用后，从“应用程序”中移除 IaC Code。

• Windows：打开“设置 > 应用 > 已安装的应用”，卸载 IaC Code。

• AppImage：退出应用并删除 AppImage 文件及自行创建的启动器。

• Debian、Ubuntu：通过系统软件包管理器卸载 IaC Code。

只有在确认不再需要已有配置和会话时，才手工清理配置目录。

常见问题

应用一直停留在启动页

使用启动页提供的恢复操作重试，并打开诊断目录查看日志。常见原因包括应用文件不完整、端口被占用或运行组件启动失败。重新安装前先保留诊断日志，以便定位问题。

Windows 提示找不到 Git Bash

Windows 上的 Shell 工具依赖 Git Bash。使用启动页提供的快捷入口完成安装，然后退出并重新启动 IaC Code。如果仍然无法发现，请确认 Git for Windows 已正确安装，且当前用户可以启动 Git Bash。

模型或云凭证显示不可用

打开“设置”，检查模型名、API Base URL、API Key、阿里云认证方式和默认地域。临时凭证过期后需要刷新或重新登录；RAM 身份还需具有目标操作需要的最小权限。

桌面版看不到 REPL 或 Web 中的会话

确认各运行方式由同一操作系统用户启动，并使用相同的 IAC_CODE_CONFIG_DIR。会话还与项目目录关联，请同时确认桌面版选择了正确的项目。

Linux 无法启动 AppImage

确认文件具有执行权限，并从终端运行以查看错误。发行版还可能需要安装 AppImage 所需的 FUSE 兼容组件；也可以在 Debian 或 Ubuntu 上改用 deb 包。

相关文档

• 安装和使用 IaC Code

• IaC Code 桌面应用完整参考

• 模型服务配置

• 阿里云身份凭据

• 会话管理