CodeBuddy 安装与使用指南（含账号切换）

CodeBuddy 安装与使用指南（含账号切换）

本文档适用于通过 npm 安装的 CodeBuddy CLI 工具，适配 Linux/macOS 环境，适合开发者快速上手与账号管理。

📦 安装 CodeBuddy

确保你已安装 Node.js 和 npm，推荐使用 nvm 管理 Node 版本。

BASH
1
npm install -g @tencent-ai/codebuddy-code

安装完成后，使用以下命令启动 CodeBuddy：

BASH
1
codebuddy

🚀 使用 CodeBuddy

启动后你将进入交互式界面，类似命令行聊天窗口：

TEXT
1
2
3
4
5
6
7
╭────────────────────────────────────────────────────╮
│ ✻ Welcome to CodeBuddy!                            │
│                                                    │
│   /help for help, /status for your current setup   │
│                                                    │
│   Working in /your/project/path                    │
╰────────────────────────────────────────────────────╯

常用命令：

命令 说明
/init 初始化项目，生成 CODEBUDDY.md 指南文件
/help 查看所有可用命令
/status 查看当前项目状态
/logout 登出当前账号
/login 登录或切换账号（如支持）

🔐 切换账号或登出

CodeBuddy 默认会记住你的登录状态，即使卸载后重新安装也可能自动登录。

✅ 正确的登出方式：

  1. 启动 CodeBuddy：

    BASH
    1
    codebuddy

  2. 在 CodeBuddy 的交互界面中输入：

    TEXT
    1
    /logout

  3. 如果支持账号切换，可继续输入：

    TEXT
    1
    /login

🧹 清理登录状态（彻底登出）

如果 /logout 无效或仍自动登录，可手动清理本地缓存：

BASH
1
2
3
4
5
rm -rf ~/.codebuddy
rm -rf ~/.config/codebuddy
rm -rf ~/.local/share/codebuddy
rm -rf ~/.cache/codebuddy
rm -f ~/.codebuddyrc

执行后再次运行 codebuddy，应提示重新登录或初始化。

🛠️ 一键清理脚本（可选）

你可以创建一个脚本 reset-codebuddy.sh：

BASH
1
2
3
4
5
6
7
8
#!/bin/bash
echo "正在清理 CodeBuddy 登录状态..."
rm -rf ~/.codebuddy
rm -rf ~/.config/codebuddy
rm -rf ~/.local/share/codebuddy
rm -rf ~/.cache/codebuddy
rm -f ~/.codebuddyrc
echo "清理完成，请重新运行 codebuddy 登录新账号。"

保存后赋予执行权限：

BASH
1
2
chmod +x reset-codebuddy.sh
./reset-codebuddy.sh

📁 常见问题排查

  • 自动登录无法取消：确认是否清理了 .codebuddy 文件夹。
  • 命令无效：确保是在 CodeBuddy 的交互界面中输入，而不是 Bash。
  • 无法切换账号：可能是设备绑定机制，建议联系 CodeBuddy 官方支持。

🧾 参考环境

  • Node.js v24.8.0（通过 nvm 安装）
  • npm v11.6.0
  • Linux/macOS 终端环境

如需将本指南嵌入你的博客或团队 Wiki，可直接复制粘贴此 Markdown 内容。欢迎根据实际使用情况补充命令或截图。