安装配置

本页面将指导你完成CodeBuddy的安装和基本配置。

系统要求

在开始安装之前，请确保你的系统满足以下要求：

• 操作系统: Windows 10/11, macOS 10.15+, Linux (Ubuntu 18.04+)
• 内存: 至少4GB RAM（推荐8GB+）
• 存储空间: 至少2GB可用空间
• 网络: 稳定的互联网连接

安装方式

CodeBuddy提供多种安装方式，你可以根据自己的需求选择：

方式一：独立IDE安装

1. 下载安装包

   • 访问CodeBuddy官网
   • 点击"下载CodeBuddy IDE"
   • 选择适合你操作系统的版本

2. 安装步骤

   # Windows
   # 双击下载的.exe文件，按照向导完成安装
   
   # macOS
   # 双击下载的.dmg文件，拖拽到Applications文件夹
   
   # Linux
   # 解压下载的tar.gz文件到指定目录
   tar -xzf codebuddy-linux.tar.gz
   cd codebuddy
   ./codebuddy

方式二：VSCode扩展安装

1. 打开VSCode

2. 安装扩展

   • 按Ctrl+Shift+X打开扩展面板
   • 搜索"CodeBuddy"
   • 点击"安装"

3. 配置扩展

   • 安装完成后重启VSCode
   • 按Ctrl+Shift+P打开命令面板
   • 输入"CodeBuddy: Login"进行登录

初始配置

1. 账号登录

首次启动CodeBuddy时，需要登录你的账号：

1. 点击"登录"按钮
2. 选择登录方式：
   • 腾讯企业微信
   • GitHub账号
   • 邮箱注册

2. 基本设置

登录成功后，进行基本设置：

主题配置

// 设置 -> 主题
{
  "colorTheme": "GitHub Dark",
  "fileIconTheme": "vs-seti",
  "productIconTheme": "fluent-icons"
}

编辑器配置

// 设置 -> 编辑器
{
  "editor.fontSize": 14,
  "editor.fontFamily": "Fira Code, Consolas, monospace",
  "editor.tabSize": 2,
  "editor.insertSpaces": true
}

3. AI模型选择

CodeBuddy支持多种AI模型，你可以根据需要选择：

• Claude-3.7-Sonnet: 平衡性能和速度
• Claude-4.0-Sonnet: 最强性能，适合复杂任务
• GPT-4o-mini: 快速响应，适合简单任务
• Gemini-2.5-Flash: 超快速度
• Gemini-2.5-Pro: 高质量输出

在设置中选择你偏好的模型：

设置 -> AI模型 -> 选择默认模型

常见安装问题

问题1：版本不兼容

错误信息: "version incompatible"

解决方案:

1. 在IDE设置中搜索"gallery"
2. 配置为https://marketplace.visualstudio.com
3. 重启IDE

问题2：远程SSH连接失败

错误信息: "Could not establish connection to"

解决方案:

• 确保远程主机的glibc版本>=2.28
• 参考VSCode官方文档

问题3：终端无法执行命令

解决方案:

1. 在设置中搜索"shell"
2. 启用"Terminal Integrated Shell Integration"
3. 重启终端

问题4：C/C++扩展安装失败

解决方案:

• 安装特定的较低版本
• 或者安装clangd替代

验证安装

安装完成后，可以通过以下方式验证：

1. 检查版本

   # 在终端中执行
   codebuddy --version

2. 测试AI功能

   • 创建一个新文件
   • 输入注释描述功能
   • 按Tab键查看AI补全

3. 测试聊天功能

   • 按Ctrl+Shift+P
   • 输入"CodeBuddy: Open Chat"
   • 发送测试消息

下一步

安装配置完成后，你可以：

1. 创建第一个项目
2. 了解IDE功能
3. 查看最佳实践

如果遇到其他问题，请查看常见问题或联系技术支持。