Skip to main content

CodeBuddy Code 配置文档

概述

本文将说明如何使用 CloudBase AI CLI 配置 CodeBuddy Code 。

Cloudbase AI CLI 介绍文档

CloudBase AI CLI 支持以两种方式配置 CodeBuddy Code:

  • CodeBuddy 账号登录:使用 CodeBuddy 账号登录,支持 OAuth 身份验证
  • API key配置:使用 CodeBuddy API key 登录

CodeBuddy 配置

运行:

tcb ai --setup

命令运行后,将会进入配置向导。

  1. 选择当前要配置的 AI 编程助手,选择 CodeBuddy Code
  2. 选择配置方式,选择 使用 CodeBuddy 账号登录
  3. 根据提示登录您的 CodeBuddy 账号
  4. 最后可选择默认要使用的 AI 编程助手,后续运行 tcb ai 时即可默认打开

启动 CodeBuddy Code

tcb ai -a codebuddy
tip

如果配置了默认使用 CodeBuddy Code,可以直接执行 tcb ai

详细配置指引

自定义配置

配置 CodeBuddy API Key

  • API Key 填入您的 CodeBuddy API Key

环境变量配置

CodeBuddy Code 支持通过环境变量进行配置:

export CODEBUDDY_API_KEY="your-api-key-here"

MCP 服务器配置

CodeBuddy Code 支持通过参数透传实现 MCP 命令管理:

# 通过 CloudBase AI CLI 透传参数
tcb ai -a codebuddy -- --mcp-server "your-mcp-server-config"

配置验证

CodeBuddy Code 的配置会自动进行验证,包括:

  • API Key 格式验证
  • 网络连通性测试
  • MCP 服务器配置检查

故障排除

常见问题

  1. API Key 无效

    • 检查 API Key 是否正确
    • 确认 API Key 是否有足够的使用权限
    • 查看 CodeBuddy 账户状态
  2. 网络连接问题

    • 检查防火墙设置
    • 确认网络能够访问 CodeBuddy 服务
    • 尝试更换网络环境
  3. MCP 服务器配置错误

    • 验证 MCP 服务器配置格式
    • 检查服务器地址是否可访问
    • 确认服务器认证信息

日志查看

启用详细日志来排查问题:

tcb ai -a codebuddy -- --verbose

最佳实践

  1. API Key 安全管理

    • 使用环境变量而不是硬编码 API Key
    • 定期轮换 API Key
    • 限制 API Key 的权限范围
  2. MCP 服务器管理

    • 使用配置文件管理多个 MCP 服务器
    • 定期检查服务器状态
    • 备份重要的服务器配置
  3. 性能优化

    • 根据项目规模选择合适的模型
    • 合理配置并发请求数
    • 监控 API 使用量和费用