---

# 全局安装
npm install -g @tencent-ai/codebuddy-code

在任意项目目录下运行：

codebuddy

首次使用需要进行身份认证，按照提示完成登录即可。

• 自然语言交互：用中文或英文描述需求，AI 自动理解并执行
• 代码生成与优化：根据描述生成高质量代码，自动优化现有代码
• 智能调试：快速定位和修复代码问题

• 深度代码分析：理解项目结构、依赖关系和业务逻辑
• 上下文感知：基于项目历史和当前状态提供精准建议
• 多语言支持：支持 JavaScript、TypeScript、Python、Java、Go 等主流语言

• 终端集成：直接在命令行中使用，无需切换工具
• IDE 支持：支持 VS Code、WebStorm 等主流编辑器
• Git 工作流：智能处理版本控制、分支管理、代码审查

• 代码重构：自动重构代码结构，提升代码质量
• 测试生成：自动生成单元测试和集成测试
• 文档生成：自动生成 API 文档和代码注释

codebuddy "帮我优化这个函数的性能"
codebuddy "为这个组件添加错误处理"
codebuddy "生成这个 API 的单元测试"

codebuddy "检查这次提交的代码质量"
codebuddy "分析潜在的安全问题"
codebuddy "建议代码改进方案"

codebuddy "解释这个算法的实现原理"
codebuddy "这个设计模式在项目中如何使用"
codebuddy "推荐适合的第三方库"

codebuddy [选项] [命令] [提示词]

选项	描述	示例
codebuddy	启动交互式会话（默认）	codebuddy
codebuddy [提示词]	执行单次任务	codebuddy "修复这个 bug"
-p, --print	打印响应并退出（非交互式）	codebuddy -p "解释这个函数"
-c, --continue	继续最近的对话	codebuddy -c
-r, --resume [会话ID]	恢复指定对话	codebuddy -r
--model <模型>	指定使用的模型	codebuddy --model sonnet
--ide	启动时自动连接 IDE	codebuddy --ide
-d, --debug	启用调试模式	codebuddy -d
-h, --help	显示帮助信息	codebuddy -h
-V, --version	显示版本信息	codebuddy -V

命令	描述	示例
config	管理配置	codebuddy config set -g theme dark
mcp	配置和管理 MCP 服务器	codebuddy mcp
doctor	检查系统健康状态	codebuddy doctor
update	检查并安装更新	codebuddy update
install	安装原生构建版本	codebuddy install stable

注意：部分子命令可能尚未支持。

我们仅收集以下数据用于改进产品：

• 使用统计（命令使用频率、功能使用情况）
• 错误日志（用于问题诊断和修复）

• 本地优先：代码分析和处理优先在本地进行
• 数据加密：所有网络传输数据均经过加密

• 在 Issues 页面 中提交详细问题报告
• 通过官方渠道联系技术支持（codebuddy@tencent.com）

查看 CHANGELOG.md 了解详细的版本更新记录。

---