常见问题

聚焦模式

字号

最后更新时间： 2026-03-02 15:47:14

如何查看本地日志？
MAC：打开 CodeBuddy IDE，单击顶部帮助 > 打开日志文件夹，找到对应的日志（.zip）包。
﻿
Windows：
打开 CodeBuddy IDE，单击顶部帮助 > 打开日志文件夹，找到对应的日志（.zip）包。
手动查询路径：C:\\Users\\<您的用户名>\\AppData\\Roaming\\CodeBuddy\\logs（将<您的用户名>替换为 Windows 系统用户名）。
账户相关问题
购买旗舰版后登录提示 Credits 余额不足
1. 检查账户是否已购买旗舰版
2. 检查账户是否还有余额，单击跳转企业后台查询。
3. 检查是否登录到正确的账号
退出当前账号，通过手机号重新登录到旗舰版账号
﻿
﻿
远程开发
无法连接-远程 SSH 插件请求/登录报错
需测试下本地 IDE 是否正常登录, 如果是远程服务器上的请求问题,要确认远程服务器的外网是否可访问, 如使用ping+网址来判断。
﻿
如果无法登录，排查如下：
1. 打开 CodeBuddy IDE 设置 Ctrl/Cmd+,
2. 搜索 codebuddy.remote.SSH.enableDynamicForwarding
3. 取消勾选这个选项(设置为 false)
4. 重新连接 SSH
﻿
无法连接-打开容器报错
原因是 Codebuddy 上使用的 Vscode 的 Remotessh 和 dev-container 插件, 报错是 Vscode 的插件报错。
使用 Codebuddy IDE 不需要额外安装 Vscode 官方的 Remotessh 和 dev-container 插件, IDE 内置了这两个插件，需要卸载掉 Vscode 的插件使用内置插件连接即可。
﻿
网络检查
3002、3003错误码
检查网络连接/TCP 连接
 curl -v https://copilot.tencent.com
检查是否超时
timeout 30s curl -v https://copilot.tencent.com
检查防火墙/代理（CodeBuddy CN IDE不需要通过代理使用）
curl -v --trace-time https://copilot.tencent.com
3005错误码
1. 单击新建对话/重试即可，网络波动问题可能性较大
2. 判断输入是否太长了，是否带了很多文件/上下文导致上下文窗口溢出，窗口支持 200K，如果文本内容比较大容易超限，可以只读部分数据来减缓。
10001错误码
若开发环境需使用代理，检查代理服务是否为 HTTP 协议，如果不是建议调整使用 HTTP 协议的代理服务。对于 SOCKS 协议规划支持中
Figma 使用
Figma 无法添加到对话中？
需要申请 Figma 编辑和开发权限，因为 Figma 查看权限默认不开放 Api
开发侧可只开通开发权限，需要先切普通模式再切换到开发模式（ Figma 网页若切换不成功，需手动切换一次）
插件相关
安装问题
一般是因为本地之前装过错误版本的插件或者有插件迁移导致，以下两个方案选一个执行：
方案一：
1.1 卸载插件；
1.2 清空 cache vsix：help > open Logs Folder > 回退到上一级目录 > cachedVSIXs 的文件夹；
（~/Library/Application\\ Support/CodeBuddy\\ CN/CachedExtensionVSIXs）
   清空本地插件，删除 .codebuddycn/extensions/${插件id}
1.3 重新去插件商店安装；
方案二：
卸载插件，查询一下 Vscode 1.100.0 对应的插件版本，安装指定版本插件
﻿
﻿
Python 没有语法高亮, 无法跳转定义
Plance 校验了微软自己的签名，第三方会有运行不起来的问题"
1. 卸载 Pylance
2. 安装 BasedPyright
3. BasedPyright 默认的检查比较严格，觉得多余可以在设置的这个位置改成 standard：basedpyright.analysis.typeCheckingMode
﻿
﻿
﻿
C/C++ 无法跳转/高亮
1. C/C++  微软官方的插件在 CodeBuddy IDE 上会有限制, Codebuddy IDE 建议安装 clangd 作为 c/c++的 lsp (语法高亮和跳转) , 建议安装 clangd 插件进行代码跳转和高亮
注意：
同时要卸载掉  C/C++  插件, 否则会有冲突。
2. 如果个别还有问题,确认下项目跟目录是否存在 compile_commands.json文件,
使用如下命令生成：
 cmake -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
终端
无法打开终端
操作方法如下：单击顶部 CodeBuddy IDE ，查看首选项，选择设置。
﻿
在设置中所搜Shell，开启Terminal › Integrated › Shell Integration: Decorations为Enabled
﻿
终端无法复用
MAC
zsh 安装了有慢速组件或者主题会导致获取 Terminal 状态失败
对 zsh 没有诉求的用户，可以考虑更换 bash 主题
﻿
﻿
对 zsh 有诉求的用户，可以排查下 ~/.zshrc 有没有配置类似的主题
﻿
MCP
MCP 使用
需要在 Craft 模式下使用,Ask 模式不能修改文件，所以禁用了 Mcp，因为 Mcp 可能会修改文件。
MCP 连接不上
将配置文件内名称有空格的位置删除。
﻿
﻿