CodeBuddy Web 是云原生开发环境提供的浏览器入口，无需安装本地客户端， 即可在浏览器中使用 CodeBuddy Code 的智能编码能力。

使用场景：想在浏览器中借助 AI 编码、又不想装本地客户端时使用—— 镜像里装好 codebuddy 命令即可，见下方版本要求。

使用方式

在仓库分支页面点击右上角「云原生开发」按钮创建或打开开发环境后， 在入口选择页或「我的云原生开发」列表页点击 CodeBuddy Web， 即可进入浏览器端的 CodeBuddy 界面开始编码。

与 WebIDE 的差异

CodeBuddy Web 与 WebIDE 都是云原生开发的浏览器入口，各有侧重：

维度	WebIDE (code-server)	CodeBuddy Web
定位	完整 VS Code 编辑器	CodeBuddy Code 的浏览器界面
交互形态	直接编辑代码	AI 对话驱动编码
客户端	浏览器，无需安装	浏览器，无需安装
启动条件	默认内置	镜像装有 codebuddy（>= 2.137.0）

• WebIDE：完整的 VS Code 体验，适合手动编辑代码、调试。
• CodeBuddy Web：CodeBuddy Code 的浏览器端界面，适合借助 AI 完成编码。

版本要求

CodeBuddy Web 仅在开发环境镜像满足以下条件时可用：

• 已安装 codebuddy 命令
• codebuddy 版本不低于 2.137.0

使用自定义开发环境时，需确保环境内已安装 @tencent-ai/codebuddy-code（提供 codebuddy 命令）。 镜像未安装 codebuddy 或版本过低时，上述入口不会展示。 如需使用，请参考 自定义开发环境 安装满足版本要求的 codebuddy。

CodeBuddy Web 无需额外配置，只要镜像中装好 codebuddy 命令即可。 使用自定义镜像时，可在 .ide/Dockerfile 中安装：

# .ide/Dockerfile
FROM node:22

# 安装 CodeBuddy Code，提供 codebuddy 命令，版本需 >= 2.137.0
RUN npm install -g @tencent-ai/codebuddy-code

并在 .cnb.yml 中让云原生开发使用该 Dockerfile：

.cnb.yml

$: # 兜底匹配所有分支，不被 glob 匹配的分支
  vscode:
    - docker:
        build: .ide/Dockerfile
      services:
        - vscode

环境创建后，镜像满足版本要求时即会出现 CodeBuddy Web 入口。

上一页业务端口预览

下一页云原生开发工作区回收机制