FAQ ​

Get logs ​

MAC: Open CodeBuddy IDE, click Help in the top menu ---> Open Log Folder, and find the corresponding log (.zip) package.

View Logs

Windows:

  • Open CodeBuddy IDE, click Help in the top menu ---> Open Log Folder, and find the corresponding log (.zip) package.

  • Manual path: C:\Users\<your-username>\AppData\Roaming\CodeBuddy\logs (replace <your-username> with your Windows system username)

Remote Development ​

Unable to Connect ​

Q: Remote SSH Plugin Request/Login Error

First, test whether the local IDE can log in normally. If there's a request issue on the remote server, confirm whether the remote server has external network access, using commands like ping + URL to check.

If login fails, troubleshoot as follows:

  1. Open CodeBuddy IDE settings Ctrl/Cmd+,

  2. Search for codebuddy.remote.SSH.enableDynamicForwarding

  3. Uncheck this option (set to false)

  4. Reconnect to SSH

alt text

Q: Error Opening Container ​

This is because CodeBuddy uses VSCode's RemoteSSH and dev-container plugins, and the error comes from VSCode plugins. When using CodeBuddy IDE, you don't need to install VSCode's official RemoteSSH and dev-container plugins. The IDE has these plugins built-in. You need to uninstall the VSCode plugins and use the built-in plugins to connect.

Network Check ​

If your development environment requires a proxy, check whether the proxy service uses the HTTP protocol. If not, it's recommended to switch to a proxy service using the HTTP protocol. Support for SOCKS protocol is planned.

  1. Check if the network connection is stable

  2. Check if the proxy service uses the HTTP protocol. It's recommended to select Singapore as the proxy node

  3. Try disabling the proxy service and attempt the conversation again

alt text

Figma ​

Q: Cannot Add Figma to Conversation? ​

You need to apply for Figma editing and development permissions, because Figma view-only permissions don't open the API by default.

For developers, you can just enable development permissions. You need to switch to normal mode first, then switch to development mode (if switching fails on the Figma webpage, you need to switch manually once).

Plugin ​

Q: Installation Issues ​

This is usually caused by previously installed incorrect plugin versions or plugin migrations. Choose one of the following solutions:

Solution 1:

  1. Uninstall the plugin;

  2. Clear cache vsix: Help > Open Logs Folder > go back to parent directory > CachedVSIXs folder;

(~/Library/Application\ Support/CodeBuddy\ CN/CachedExtensionVSIXs)

Clear local plugins, delete .codebuddycn/extensions/${plugin-id}

  1. Reinstall from the plugin marketplace;

Solution 2:

Uninstall the plugin, check the plugin version corresponding to VSCode 1.100.0, and install the specified version.

alt text

alt text

Q: Python Has No Syntax Highlighting, Cannot Jump to Definition ​

Pylance validates Microsoft's own signature, which causes issues running on third-party platforms.

  1. Uninstall Pylance
  2. Install BasedPyrightBasedPyright has stricter checks by default. If you find them excessive, you can change to standard in this setting:

basedpyright.analysis.typeCheckingMode

alt text

Q: C/C++ Cannot Jump/Highlight ​

  1. Microsoft's official C/C++ plugin has limitations on CodeBuddy IDE. CodeBuddy IDE recommends installing clangd as the LSP (syntax highlighting and jump) for C/C++. It's recommended to install the clangd plugin for code navigation and highlighting.

Note: You also need to uninstall the C/C++ plugin, otherwise there will be conflicts.

  1. If there are still individual issues, check whether the compile_commands.json file exists in the project root directory. Use the following command to generate it:

    cmake -B build -DCMAKE_EXPORT_COMPILE_COMMANDS=ON

Terminal ​

Q: Unable to Open Terminal ​

Follow these steps: Click CodeBuddy IDE at the top, view Preferences, and select Settings.

alt text

In Settings, search for Shell, and set Terminal β€Ί Integrated β€Ί Shell Integration: Decorations to Enabled.

alt text

Q: Terminal Cannot Be Reused ​

MAC

zsh with slow components or themes installed may cause Terminal status retrieval to fail.

  • For users who don't need zsh, consider switching to the bash theme.

alt text

alt text

  • For users who need zsh, check if ~/.zshrc has similar theme configurations.

alt text

MCP ​

Q: MCP Usage ​

MCP must be used in Craft mode. Ask mode cannot modify files, so MCP is disabled because MCP may modify files.

Q: MCP Connection Failed ​

Remove spaces in names within the configuration file.

alt text

Language ​

Q: How do I constrain the Agent's conversation language？ ​

Switch the language by configuring Rules, as illustrated below:：

alt text