跳到主要内容

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
提示

如果配置了默认使用 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 使用量和费用