
## 一、WorkBuddy 积分获取途径

WorkBuddy 的积分（Credits）是驱动 AI 执行任务的“燃料”，获取方式多样且通常免费。

| 途径 | 积分奖励 | 操作说明 |
| :--- | :--- | :--- |
| **新用户注册** | +5000 积分 | 注册后需在个人中心（Profile/Usage）手动领取  |
| **每日签到** | +100 积分/天 | 客户端左下角头像处点击“今日礼包”，连续签到有倍数奖励  |
| **邀请好友** | 双方各 +500 积分 | 使用专属邀请链接或码，好友注册成功即得  |
| **社区贡献** | +500 至 +3000 积分 | 在腾讯云开发者社区发布使用心得或教程，审核通过后发放  |
| **每月额度** | 不定量 | 部分版本每月 1 号自动刷新免费额度  |

**注意**：积分通常有有效期（如注册赠送 90 天），建议定期在客户端查看余额。

---

## 二、VSCode 安装与基础配置

### 步骤 1：安装插件
1.  打开 VSCode，使用快捷键 `Ctrl+Shift+X` (Win) 或 `Cmd+Shift+X` (Mac) 打开扩展面板。
2.  在搜索框输入 **`Tencent Cloud CodeBuddy`**（确保发布者为 Tencent Cloud）。
3.  点击 **Install** 按钮进行安装，安装完成后重启 VSCode 。

### 步骤 2：登录与授权
1.  点击 VSCode 左侧活动栏的 **CodeBuddy 图标**（通常为螃蟹或虾形图标）。
2.  在侧边栏或底部状态栏点击“登录”，使用微信或腾讯云账号扫码授权 。
3.  **权限配置**：首次使用时，系统可能会请求访问工作区权限。你需要在系统设置（如 macOS 的“安全性与隐私”）中授权 VSCode 访问你的项目文件夹，否则插件无法读取或生成代码 。

### 步骤 3：工作区绑定
-   直接在 VSCode 中打开你的项目根目录，CodeBuddy 会自动建立索引。
-   验证绑定：在侧边栏输入“帮我看看当前项目结构”，若能返回文件树说明绑定成功 。

---

## 三、核心模式详解：Chat vs Craft

CodeBuddy 在 VSCode 中主要通过两种模式协作，对应不同的积分消耗逻辑。

### 1. Chat 模式（问答与审查）
- **功能定位**：**低消耗/免费**。主要用于代码解释、技术问答、单文件代码审查。
- **积分消耗**：通常使用免费额度，仅在调用深度分析时消耗少量积分 。
- **使用场景**：
    - 输入：“解释这段 Python 代码的逻辑”
    - 输入：“为这个函数生成单元测试”
- **配置要点**：在侧边栏顶部选择 `Chat` 模式，可在左下角切换模型（如混元、DeepSeek）。

### 2. Craft 模式（智能体执行）
- **功能定位**：**高消耗**。这是 CodeBuddy 的 Agent 模式，能自主分析需求、跨文件生成代码、重构项目。
- **积分消耗**：根据任务复杂度（如生成整个项目骨架 vs 修改单个文件）动态消耗积分 。
- **使用流程**：
    1.  **切换模式**：在侧边栏顶部将模式切换到 **Craft**。
    2.  **输入指令**：使用自然语言描述复杂需求。
        > 示例：`/craft 在 src/api 目录下创建一个用户登录接口 auth.py，使用 Flask 框架和 JWT 鉴权。` 
    3.  **执行确认**：AI 会先分析需求并生成执行计划（Plan），你确认无误后点击“执行”才会修改文件 。
- **配置要点**：确保项目已绑定工作区（存在 `.codebuddy/` 目录），否则 Craft 无法获取上下文 。

---

## 四、高级配置：自定义 Agent（子代理）

CodeBuddy 支持创建**自定义子代理（Custom Agent）**，用于特定场景的专属工作流。

### 步骤 1：进入代理管理界面
1.  在 VSCode 中打开命令面板（`Ctrl+Shift+P` 或 `Cmd+Shift+P`）。
2.  输入命令：`CodeBuddy: Open Agents Management` 或直接输入 `/agents` 。

### 步骤 2：创建自定义 Agent
1.  点击“创建新代理”（Create New Agent）。
2.  **选择级别**：
    - **用户级（User）**：所有项目通用。
    - **项目级（Project）**：仅当前项目可用，配置保存在 `.codebuddy/agents/` 目录下 。
3.  **定义 Agent 属性**：
    - **名称（Name）**：如 `@frontend-specialist`
    - **描述（Description）**：定义其职责，如“专精于 React + TypeScript 代码生成与重构”。
    - **系统提示（System Prompt）**：可 AI 生成后手动编辑，定义其行为规则。
    - **工具权限**：选择授予访问的文件系统、终端等工具，或留空继承所有 。

### 步骤 3：使用自定义 Agent
- 在 Craft 或 Chat 模式中，通过 `@` 提及你的自定义 Agent。
- 示例指令：`@frontend-specialist 帮我重构这个组件，提取公共逻辑` 。

### 步骤 4：接入外部 Agent（企业/高级）
对于需要接入私有模型或外部服务的企业用户，可通过 JSON 配置自定义服务。
1.  在项目根目录创建 `.codebuddy/agents/custom-agent.json`。
2.  配置基础信息（参考结构如下）：
    ```json
    {
      "name": "my-company-agent",
      "type": "proxy",
      "description": "接入公司内部模型",
      "service": {
        "endpoint": "http://your-internal-server:18080"
      },
      "modelConfiguration": {
        "modelName": "custom-model"
      }
    }
    ```


---

## 五、避坑指南与小结

### 1. 积分与权限常见问题
- **积分不扣减**：CodeBuddy 插件中的 Chat 模式通常使用免费额度，仅 Craft 模式和执行复杂 Agent 任务时会消耗 WorkBuddy 积分 。
- **权限错误**：若 Craft 模式报错“无法访问文件”，请检查系统隐私设置中是否授权了 VSCode 访问“文件和文件夹” 。
- **工作区未绑定**：确保用 VSCode 打开的是文件夹（Folder）而非单个文件，否则 Craft 无法生成多文件代码 。

### 2. 配置流程总结
1.  **获取燃料**：通过签到、邀请积累 WorkBuddy 积分。
2.  **安装登录**：在 VSCode 安装 CodeBuddy 插件并扫码登录。
3.  **模式选择**：
    - 日常问答用 **Chat**（省积分）。
    - 复杂工程任务用 **Craft**（耗积分，需确认计划）。
4.  **高级定制**：通过 `/agents` 创建专属子代理，提升特定场景效率。

### 3. 最佳实践建议
- **安全第一**：在 Craft 模式执行前，务必审核 AI 生成的 Plan（计划），避免直接覆盖重要文件。
- **善用自定义**：为重复性任务（如“生成 API 层”、“优化 SQL”）创建专用 Agent，减少重复提示词输入 。

WorkBuddy 的积分（Credits）是驱动 AI 执行任务的“燃料”，获取方式多样且通常免费。

WorkBuddy 积分获取与 CodeBuddy 深度配置教程

本教程详述 VSCode 配置腾讯云 CodeBuddy 全流程。首先介绍通过签到、邀请等途径获取 WorkBuddy 积分的方法。核心部分分步演示插件安装、扫码登录及文件权限配置。重点解析 Chat（低耗问答）与 Craft（高耗自动化执行）双模式的应用场景与操作差异，并进阶说明自定义 Agent的创建方法。最后提供权限避坑指南及“日常用 Chat，复杂任务用 Craft”的最佳实践，助你高效使

开发工具

职业发展

WorkBuddy积分可通过注册、签到、邀请好友和社区贡献获取，用于驱动AI任务执行。VSCode插件安装简单，支持Chat和Craft两种模式，分别用于低消耗问答和高消耗智能代码生成。高级功能包括自定义Agent创建，提升特定场景效率。注意积分有效期，合理使用免费额度，确保工作区绑定和系统权限配置。

单元测试

文件系统

TypeScript

智能体

Python

Agent

JSON

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

WorkBuddy 积分获取与 CodeBuddy 深度配置教程-腾讯云开发者社区-腾讯云

WorkBuddy 积分获取与 CodeBuddy 深度配置教程

WorkBuddy 积分获取与 CodeBuddy 深度配置教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐