Help Center/ CodeArts Agent/ User Guide (IDE)/ Remote Development/ WSL Distributions
Updated on 2026-07-29 GMT+08:00
View PDF
Share

WSL Distributions

CodeArts Agent IDE supports remote connections to the Windows Subsystem for Linux (WSL). This function uses the local WSL environment as a remote development backend, enabling users on Windows to write, debug, and run code end-to-end within the local WSL environment, just like connecting to a remote server.

Figure 1 Remotely connecting to WSL

Constraints

Table 1 Constraints

Category

Description

WSL

WSL has been installed on the local Windows system.

OS version
  • glibc: 2.18 or later 
    # Check the glibc version.
ldd --version
  • glibcxx: 3.4.22 or later 
    # Check the glibcxx version.
  # Ubuntu
  strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX
  # openEuler
  strings /lib64/libstdc++.so.6 | grep GLIBCXX

Webpage preview

Direct opening of the browser for preview via the file:/// protocol is currently not supported.

Connecting to WSL

  1. Log in to CodeArts Agent IDE as instructed in Quick Start.
  2. Click in the left menu bar of the IDE to open the remote development page.
  3. Under WSL distributions, CodeArts Agent IDE automatically detects and identifies WSL environments existing in the current system.
  4. Hover the cursor over the WSL environment to be connected, click , and wait until the connection is complete.

    Wait until the connection is complete. If no error message is displayed and the connection information is displayed in the status bar in the lower left corner, the connection is successful.

  5. After the connection is successful, click Open Folder in the explorer, browse and select the target folder on the WSL environment, and click OK to open it.

Managing WSL Connections

Table 2 Managing WSL connections

Operation

Instruction

Disabling a remote connection

In the remote development of CodeArts Agent IDE, hover the cursor over the connected WSL environment and click to disable it. After the connection is disabled, you can click to reconnect.

Opening a folder in WSL

In the remote development of CodeArts Agent IDE, hover the cursor over the connected WSL environment, click , and select the corresponding folder to open it.

Displaying the remote host process

In the remote development of CodeArts Agent IDE, hover the cursor over the connected WSL environment and click to view the process information of the remote host.

Other Operations

Table 3 Other operations

Operation

Description

Reloads the current WSL distribution list or status.

Expands all hierarchical levels under WSL distributions and unfolds all subnodes, allowing users to quickly browse and manage a large number of connection items.

Collapses all expanded WSL distributions, reducing the number of displayed levels and improving the readability and operation efficiency of the interface.

Displaying or hiding detected CodeArts projects

Controls whether to display remote projects and connection information automatically detected by the IDE and related to CodeArts.

Synchronizing information with local extensions

Triggers a synchronization of the current WSL environment configuration to a local extension. This is typically used to ensure that extensions can properly recognize and use the latest WSL distribution information, preventing connection issues caused by inconsistent configurations and improving stability and consistency.

Showing connection logs

Views detailed logs of WSL distribution connections. When a connection fails or behaves abnormally, you can use these logs to troubleshoot issues and locate root causes.

Setting log levels

Adjusts the verbosity level of WSL distribution connection logs, such as Trace, Debug, and Info (default: Info).

Opening help documentation

Opens the official help documentation to access detailed guides on WSL distribution configuration and basic operations.
Parent Topic: Remote Development