CloudCareEE IT服务管理
更新日志
产品简介
基础概念
账号体系
注册登录
密码重置
用户名找回
工作空间
基础信息
功能模块
首页看板
系统管理
账号管理
角色管理
配置管理
多云账号管理
公有云账号
观测云工作空间
观测云云巡检
CloudLinker账号
资产管理
资产组
资产同步
资产分类
资产成员
项目管理
项目计划
项目列表
项目成员
情报管理
情报概览
情报团队
情报策略（已废弃）
调度规则
情报汇总
情报设置
报告管理
报告列表
报告版本
定期报告
报告成员
流程审批
流程列表
流程模板
流程成员
云上甄选
账户概览
账单详情
发票管理
知识库
知识库列表
知识库成员
回收站
OKR管理
目标概览
目标管理
目标对齐
周期管理
OKR成员
AI Hub
快速上手
概览
模型列表
API 密钥
调用记录
账户流水
账单管理
AI Hub成员
CloudCare助手
常见问题
H5微应用
钉钉群添加H5酷应用
飞书群H5卡片鉴权
钉钉消息卡片
钉钉消息卡片显示异常
报告说明
DMS运维报告
报告附加内容
阿里云资产全览报告（word）
配置文档
SSO单点登录配置
模型 API Key 配置
Workbuddy（腾讯）
CodeBuddy（腾讯）
TRAE Work（字节跳动）
TRAE SOLO（字节跳动）
LobsterAI（网易有道）
Dify 配置
-
+
首页
CodeBuddy（腾讯）
# CloudCare Enterprise AI Hub 接入 CodeBuddy 使用指南 ## 一、产品介绍 ### 1.1 CodeBuddy IDE 简介 **CodeBuddy IDE** 是面向软件开发场景的 AI 代码编辑器，可在编码、代码理解、测试建议等任务中调用 AI 模型。本指南通过其 `models.json` 自定义模型机制接入 CloudCare Enterprise AI Hub 的 OpenAI 兼容接口；配置可保存在用户级或项目级目录，其中项目级配置不应提交包含实际 API Key 的文件。 ### 1.2 AI Hub 接入能力 CloudCare Enterprise 的 **AI Hub** 为本地 AI 工具提供统一的 OpenAI 兼容接入。用户在 AI Hub 中创建 API Key，复制请求地址与 Key，并从模型列表取得调用用的 `model_name` 后，即可配置到支持 OpenAI 兼容协议的客户端。 接入前请准备以下三项信息： 1. 请求地址（base URL） 2. API Key 3. 模型名称（`model_name`） > 请求地址应从 AI Hub 的“API 调用信息”直接复制。不要把某个环境的地址写死到团队模板中。 | AI Hub 模块 | 本指南中的用途 | | --- | --- | | 概览 | 查看个人或空间维度的请求次数、Token、费用与趋势。 | | 模型列表 | 选择可用模型；接入工具时填写列表返回的 `model_name`，而非仅使用展示名称。 | | API 密钥 | 创建、查看脱敏 Key、打开 API 调用信息并复制接入参数。 | | 调用记录 | 配置后核验请求是否进入 AI Hub；记录数据按产品设置周期刷新。 | | 成员 / 账户管理 | 空间管理员可设置成员月度 Token 或费用额度，并维护空间治理策略。 |  #### 接入安全要点 - 密钥列表与详情只展示脱敏值；完整 API Key 不会出现在列表或详情接口中。 - 完整 Key 仅该 Key 的创建者可从“API 调用信息”复制；请由创建者完成工具配置。 - AI Hub 的管理员、读写、只读角色拥有不同操作范围；完整 Key 的复制始终额外校验“是否为该 Key 创建者”。 ### 1.3 使用前权限与账号要求 接入 CodeBuddy 前，请确认当前账号已加入目标工作空间，并获授 AI Hub 角色。权限以 AI Hub 角色为主，同时受工作空间范围、成员状态和 Key 创建者限制。 | 角色 | 可完成的 AI Hub 操作 | 接入 CodeBuddy 时的含义 | | --- | --- | --- | | 系统超级管理员 / 系统管理员 | 作为 AI Hub 管理员的上层角色，在已授权工作空间内管理成员、空间配置和 Key。 | 可为成员授予 AI Hub 角色，并协助治理。完整 Key 仍只能由创建者复制。 | | 管理员（AI Hub） | 管理 AI Hub 成员、查看所有空间内 Key、创建 Key、启停 / 删除 Key、查看模型、统计、调用记录和钱包流水。 | 适合空间治理与成员开通；为降低密钥扩散风险，建议由实际使用人自行创建 Key。 | | 读写（AI Hub） | 创建 Key、修改自己创建 Key 的名称 / 备注 / 到期时间、启停自己创建 Key；查看模型、概览、调用记录和余额。 | 适合需要接入本地工具的普通使用成员；可复制自己创建的完整 Key。 | | 只读（AI Hub） | 查看 Key 的脱敏信息、模型、概览、调用记录、余额和日账单。 | 可核验模型与调用情况，但不能创建、修改、复制或删除 API Key。 | > **Key 复制的双重限制**：权限矩阵允许管理员和读写成员使用“复制 API Key”，但后端会继续校验创建者身份。仅该 Key 的创建者可以取得完整 Key；管理员查看其他成员的 Key 时只能看到脱敏值，不能代为复制。 #### 成员与范围限制 - AI Hub 管理员添加成员前，目标用户必须已是同一工作空间成员；AI Hub 角色还必须与工作空间角色兼容，否则系统会拒绝保存。 - 成员处于禁用状态时，不能创建或操作 API Key；系统会同时禁用该成员在该空间的 API Key。 - 空间级看板、成员管理、钱包流水和空间配置仅对 AI Hub 管理员开放；读写与只读成员可查看自己的使用情况及其有权访问的记录。 - 所有接入参数均以当前选择的工作空间为边界。跨空间切换时，请重新检查模型、Key、余额与成员权限。 --- ## 二、安装部署 ### 2.1 系统要求 | 客户端 | 操作系统 | 最低版本 | 说明 | | --- | --- | --- | --- | | CodeBuddy IDE（macOS） | macOS | 11 及以上 | 从官方页面选择与芯片匹配的安装包。 | | CodeBuddy IDE（Windows） | Windows | Windows 10 及以上 | 下载并运行 Windows 安装包。 | | CodeBuddy IDE（Linux） | Linux | 以官方下载页为准 | 下载对应发行版的安装包。 | ### 2.2 获取方式 CodeBuddy IDE 是面向开发场景的 AI 代码编辑器。它支持通过 `models.json` 添加 OpenAI API 格式的自定义模型，适合将 AI Hub 作为模型接入层。 | 项目 | 说明 | 下载 / 文档地址 | | --- | --- | --- | | 官方下载 | CodeBuddy IDE 最新安装包（macOS / Windows / Linux） | [codebuddy.cn/ide](https://www.codebuddy.cn/ide/) | | 安装说明 | macOS 11 及以上；Windows 10 及以上 | [CodeBuddy IDE 安装说明](https://www.codebuddy.cn/docs/ide/Getting-Started/Installation) | | 模型配置 | 官方 `models.json` 配置字段与优先级 | [CodeBuddy 模型配置说明](https://www.codebuddy.cn/docs/ide/Features/models) | ### 2.3 各平台安装步骤 1. 从官方下载页选择与系统、芯片匹配的 CodeBuddy IDE 安装包。 2. macOS：打开 `.dmg` 并将应用拖入 Applications。Windows：双击安装包，按向导完成安装。 3. 首次启动后登录，再通过右上角账户菜单进入“IDE 设置”。   ### 2.4 首次启动配置 1. 首次启动 CodeBuddy IDE 后完成登录。 2. 通过右上角账户菜单进入“IDE 设置”。 3. 按下文创建用户级或项目级 `models.json`，重启 IDE 或重新打开工作区后选择 AI Hub 模型。 --- ## 三、模型配置 ### 3.1 获取 AI Hub 接入信息 以下步骤在 CloudCare Enterprise 的 AI Hub 模块中完成。请在安装 CodeBuddy IDE 前先准备好接入参数。 #### 3.1.1 创建 API Key 1. 进入 **AI Hub > API 密钥**，点击右上角“创建密钥”。 2. 填写易识别的备注，例如“CodeBuddy-项目 A”。可按需设置过期时间；未设置则不过期。 3. 点击“确认”创建。创建完成后，列表中仅显示脱敏 Key，请通过操作栏打开 API 调用信息。   #### 3.1.2 复制请求地址与 Key 1. 在该密钥所在行打开“API 调用信息”（操作栏的调用信息 / 复制入口）。 2. 确认协议类型为 **OpenAI**；复制“请求地址”和“API Key”，也可以使用“一键复制全部”。 3. 将 Key 直接粘贴进 CodeBuddy 的 `models.json`。不要通过聊天、邮件、工单或截图传递完整 Key。  > 上图 API Key 已脱敏。若 Key 有泄露迹象，请立即在 AI Hub 禁用或删除旧 Key，再创建新 Key 并更新 CodeBuddy 配置。 #### 3.1.3 选择模型 1. 进入 **AI Hub > 模型列表**，按需要选择模型。 2. 记录“模型名称 / `model_name`”。这是 API 调用参数；展示名称仅用于阅读，不应替代模型名称。 3. 若希望使用工具调用、图片输入或推理等能力，先确认所选模型及客户端均支持，再按后文的可选推荐配置开启。 ### 3.2 添加 AI Hub 自定义模型 #### 3.2.1 配置范围 CodeBuddy IDE 当前的自定义模型仅支持 OpenAI 接口格式。配置文件可放在用户级或项目级目录；项目级优先级高于用户级，同一 `id` 的项目配置会覆盖用户配置。 | 配置级别 | 文件位置 | 适用场景 | | --- | --- | --- | | 用户级 | `~/.codebuddy/models.json` | 个人所有项目共用的 AI Hub 模型。 | | 项目级 | `<项目根目录>/.codebuddy/models.json` | 某项目需要使用独立模型、独立 Key 或不同能力开关。 | > 不要将包含实际 API Key 的项目级 `models.json` 提交到 Git；建议将其写入 `.gitignore`，或使用用户级文件保存个人凭据。 #### 3.2.2 编辑 `models.json` 1. 在用户目录或项目根目录创建 `.codebuddy` 目录，并新建 `models.json`。 2. 从 AI Hub API 调用信息复制请求地址与完整 API Key；从模型列表复制 `model_name`。 3. 在 `url` 中使用完整的 chat completions 路径：将 AI Hub 请求地址后追加 `/chat/completions` **一次**。 4. 保存文件后重启 CodeBuddy IDE，或重新打开当前工作区并在模型选择器中选择该模型。 ```json { "models": [ { "id": "<AI_HUB_MODEL_NAME>", "name": "CloudCare AI Hub - <AI_HUB_MODEL_NAME>", "vendor": "CloudCare Enterprise AI Hub", "apiKey": "<AI_HUB_API_KEY>", "url": "<AI_HUB_BASE_URL>/chat/completions", "supportsToolCall": false, "supportsImages": false, "supportsReasoning": false } ], "availableModels": ["<AI_HUB_MODEL_NAME>"] } ``` > **占位符替换**：`<AI_HUB_BASE_URL>`、`<AI_HUB_API_KEY>` 与 `<AI_HUB_MODEL_NAME>` 必须全部替换为本次从 AI Hub 复制的实际值。不要在 `url` 末尾重复追加 `/chat/completions`。 | `models.json` 字段 | AI Hub 对应值 | 说明 | | --- | --- | --- | | `id` | `model_name` | 唯一模型标识；用于 `availableModels`。 | | `apiKey` | 完整 API Key | 不能填脱敏 Key，也不要填写环境变量名。 | | `url` | base URL + `/chat/completions` | CodeBuddy 要求完整接口路径。 | | `vendor` / `name` | 自定义显示文字 | 仅用于识别，可按团队命名规范填写。 | --- ## 四、核心功能与推荐配置 ### 4.1 发起首次任务 重启 CodeBuddy IDE，打开任意非敏感测试项目，在模型下拉列表选择“CloudCare AI Hub - …”，再发起一个简短任务，例如解释一个小型函数或生成测试建议。连接验证成功后，即可用于日常编码、代码理解与测试辅助。 ### 4.2 推荐配置（可选） | 设置项 | 建议 | 原因 | | --- | --- | --- | | `supportsToolCall` | 先设为 `false` | 只有确认 AI Hub 目标模型支持工具调用时才设为 `true`。 | | `supportsImages` | 先设为 `false` | 只在多模态模型和图片任务都已验证时开启。 | | `supportsReasoning` | 先设为 `false` | 需要推理模型时再开启，避免误导客户端能力判断。 | | `availableModels` | 显式列出模型 `id` | 让模型在 IDE 下拉列表中稳定可见，减少误选。 | ### 4.3 验证与调用观测 1. 重启 CodeBuddy IDE，打开任意非敏感测试项目，在模型下拉列表选择“CloudCare AI Hub - …”。 2. 发起一个简短任务，例如解释一个小型函数或生成测试建议。 3. 回到 **AI Hub > 概览** 查看请求与 Token；需要定位时到调用记录按模型、成员或时间筛选。 4. 验证通过后，按团队规范将模型配置文件放置在用户级或项目级位置。 > **地址规则差异**：WorkBuddy 默认可补全标准路径；CodeBuddy `models.json` 的 `url` 必须是完整接口路径。因此 CodeBuddy 需要在 AI Hub base URL 后追加 `/chat/completions`。 ### 4.4 常见问题 | 现象 | 优先检查 | | --- | --- | | IDE 未显示模型 | 确认 `availableModels` 包含 `id`；检查 JSON 格式、文件路径与重启后的工作区。 | | 401 / 鉴权错误 | 确认 `apiKey` 为 AI Hub API 调用信息中的完整值，Key 处于启用状态且未过期。 | | 404 / 端点错误 | `url` 必须是完整路径，通常为 `<AI_HUB_BASE_URL>/chat/completions`，且只追加一次。 | | 功能不符合预期 | 将能力开关恢复为 `false`；以 AI Hub 模型实际能力和 CodeBuddy 官方字段说明为准。 | --- ## 附录：官方链接与依据 - [CodeBuddy IDE 官方下载](https://www.codebuddy.cn/ide/) - [CodeBuddy IDE 安装说明](https://www.codebuddy.cn/docs/ide/Getting-Started/Installation) - [CodeBuddy `models.json` 配置说明](https://www.codebuddy.cn/docs/ide/Features/models)
吴晓俊
2026年7月28日 10:48
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码