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 ​

Q: What should I do if Proxy Detection shows Failed/Warning (for example, connect ECONNREFUSED)? ​

  • Possible causes

    • Proxy mode is enabled, but the proxy service is not running, the port is unreachable, or the address is incorrect.
    • Proxy protocol mismatch (use HTTP proxy whenever possible).
    • Local security software or corporate network policy is blocking the proxy port.

  • Troubleshooting steps

    1. Open IDE settings and verify proxy configs (http.proxy, codingcopilot.httpProxySettings, codingcopilot.httpProxyURL).
    2. Validate proxy availability in terminal:
      • CN edition: curl -x http://127.0.0.1:8004 -v https://copilot.tencent.com
      • International edition: curl -x http://127.0.0.1:8004 -v https://www.codebuddy.ai.
    3. If it fails, fix the proxy service first (process/port/protocol). If proxy is not required, disable it temporarily and retry.

Q: How do I troubleshoot Hosts Resolution when it shows Warning/Error? ​

  • Possible causes

    • Legacy hosts mapping points the domain to an incorrect IP.
    • DNS service is unstable or cannot resolve the target domain.
    • VPN/system proxy affects the local resolution path.

  • Troubleshooting steps

    1. Check whether hosts contains mapping for the target domain:
      • macOS/Linux: /etc/hosts
      • Windows: C:\Windows\System32\drivers\etc\hosts
    2. Compare resolver results:
      • CN edition: nslookup copilot.tencent.com or dig copilot.tencent.com
      • International edition: nslookup www.codebuddy.ai or dig www.codebuddy.ai.
    3. Remove incorrect mapping, flush DNS cache, then run network diagnostics again.

Q: What should I do if Service Connectivity shows Failed (HTTP Failed)? ​

  • Possible causes

    • Endpoint is resolvable, but HTTP request is blocked, timed out, or TLS handshake fails.
    • Certificate chain, corporate gateway, or proxy auth causes request failure.
    • Temporary network jitter causes intermittent failures.

  • Troubleshooting steps

    1. Check service reachability:
      • CN edition: curl -v https://copilot.tencent.com
      • International edition: curl -v https://www.codebuddy.ai.
    2. Check timeout behavior:
      • CN edition: timeout 30s curl -v https://copilot.tencent.com
      • International edition: timeout 30s curl -v https://www.codebuddy.ai.
    3. If failed, focus on error keywords (timeout, certificate, proxy, connection refused) and continue troubleshooting accordingly.

Q: How should I handle TCP Connection Latency showing Failed/Warning? ​

  • Possible causes

    • Direct connection to target host 443 is blocked by firewall or enterprise policy.
    • Network quality issues cause connection timeout.
    • In proxy mode, direct connection may fail while proxy path is still available.

  • Troubleshooting steps

    1. Test TCP connectivity (macOS/Linux):
      • CN edition: nc -vz copilot.tencent.com 443
      • International edition: nc -vz www.codebuddy.ai 443.
    2. If unreachable, verify outbound 443 rules on local/corporate firewall.
    3. If proxy is enabled and product works, combine this result with Proxy Detection for overall judgment.

Q: What should I do when Packet Loss is high or reaches 100%? ​

  • Possible causes

    • Real packet loss on the network path.
    • ICMP (Ping) is blocked by target or intermediate network devices.
    • Local environment does not support ping or output cannot be parsed.

  • Troubleshooting steps

    1. Check whether Sent/Received stays abnormal across multiple runs.
    2. Validate with terminal:
      • CN edition: ping -c 18 copilot.tencent.com (Windows: ping -n 18 copilot.tencent.com)
      • International edition: ping -c 18 www.codebuddy.ai (Windows: ping -n 18 www.codebuddy.ai).
    3. If business traffic is normal but ICMP loss is 100%, treat it as ICMP-restricted and rely on Service Connectivity + TCP for final judgment.

Q: How do common error codes map to network checks? ​

  • Possible causes

    • 3002/3003 are usually related to path connectivity.
    • 3005 is often temporary jitter or timeout.
    • 10001 is usually proxy configuration related.

  • Troubleshooting steps

    1. For 3002/3003, prioritize the TCP Connection Latency and Service Connectivity checks.
    2. For 3005, retry first; if it happens repeatedly, focus on Packet Loss and Service Connectivity, and verify that prompt/context size is within the window (~200K).
    3. For 10001, verify proxy protocol and address, and prefer an HTTP proxy.

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