CodeBuddy Code 是基于腾讯云 AI 技术的智能编程工具，深度集成腾讯云生态，提供从代码编写到项目部署的全链路 AI 辅助。本文以 Hy3 preview 模型为例演示如何将模型接入到 CodeBuddy Code 中使用。
安装 CodeBuddy Code
请先确保本地已安装 Node.js 18.0 及以上版本（推荐使用 LTS 版本，对应自带的 npm 版本即可）。再执行以下命令安装 CodeBuddy Code：
npm install -g @tencent-ai/codebuddy-code
注意：
全局安装（
npm install -g）可能需要提升权限：macOS/Linux 用户若提示权限不足，请在命令前加 sudo；Windows 用户请以管理员身份运行终端再执行安装命令。建议优先使用 nvm 管理 Node.js 版本，可避免权限问题。安装完成后，您可以执行如下命令检查，输出版本号则表示安装成功。
codebuddy --version
获取 API Key
1. 进入 API Key 管理 页面，单击创建 API Key。操作详情请参见 创建 API Key。
注意：
在设置可访问范围时，如果选择“限定范围”，则需要确保勾选 Hy3 preview。
2. 创建完成后，请您务必复制并妥善保管 API Key，在后续配置到工具的流程中将会使用该信息。
配置 CodeBuddy Code
1. 找到 CodeBuddy Code 的配置文件，配置文件路径如下，配置文件不存在时新建即可。
Windows：
C:\\Users\\<用户名>\\.codebuddy\\models.json。macOS/Linux：
~/.codebuddy/models.json。2. 复制粘贴如下配置，并保存。
说明：
请将代码中的
<USER_API_KEY> 替换为您在 API Key 管理 页面获取的 API Key 字符串。该密钥用于身份认证，请妥善保管，切勿泄露或提交至代码仓库。models.json 为 CodeBuddy Code 模型配置文件，如已存在则仅需在 models、availableModels 中追加 hy3-preview 配置即可，更多相关配置，请参见 CodeBuddy Code 模型配置。{"models": [{"id": "hy3-preview","name": "hy3-preview","vendor": "Tencent Cloud","apiKey": "<USER_API_KEY>","url": "https://tokenhub.tencentmaas.com/v1"}],"availableModels": ["hy3-preview"]}
开始使用
配置完成后执行如下命令启动 CodeBuddy Code。
codebuddy
首次使用 CodeBuddy Code 时，会先弹出信任文件选择界面，询问是否信任当前工作目录下的项目文件。请按以下建议选择：
Yes, proceed（推荐）：仅当您信任当前目录下的所有文件时选择此项。CodeBuddy Code 才能读写项目文件、执行命令辅助开发。
No, exit：当前目录包含您不信任或来源不明的代码时选择此项，工具将退出，确保安全。
完成登录认证。启动后会显示登录方式选择界面：
Select login method:› Log in via Chinese SiteLog in via International SiteLog in via Enterprise DomainLog in via iOA (Tencent only)
登录方式说明如下：
登录方式 | 适用场景 | 说明 |
Chinese Site | 中国站用户 | 通过腾讯云中国站 (copilot.tencent.com) 进行认证，支持境内主流模型。 |
International Site | 国际站用户 | 通过腾讯云国际站 (codebuddy.ai) 进行认证，支持境外主流模型。 |
Enterprise Domain | 专享版/私有化部署 | 连接企业专享版或自建的 CodeBuddy 服务，需要输入企业提供的服务地址。 |
iOA | 腾讯内部员工 | 通过腾讯 iOA 零信任系统进行认证，仅限腾讯内部员工使用。 |
使用 ↑↓ 键选择登录方式，按 Enter 确认后会自动打开浏览器完成认证。
认证成功后，返回 CodeBuddy Code 命令行交互界面，在输入框中直接输入
/model 并按回车，即可进入模型选择列表，选择本文配置的 hy3-preview 即可开始使用。
