Back to Blog
TRAETraeIDE GuidesOctober 3, 2026

Trae IDE / TraeCode Download: Official Installation Guide for Windows, macOS, and Linux

Listen to this article

Uses your device’s available voices. Voice and speed changes apply at the next passage.

Trae IDE / TraeCode Download: Official Installation Guide for Windows, macOS, and Linux
AI-generated editorial illustration; not a product screenshot.
On This Page8 sections

Key Takeaways

  • Trae IDE is now commonly presented as TraeCode, so searches for Trae IDE download and TraeCode download generally refer to TRAE's dedicated AI coding environment.
  • TraeCode is available for Windows, macOS, and Linux, with different packages depending on the operating system and processor architecture.
  • Mac users should check whether they use Apple Silicon or Intel before downloading.
  • Linux users should choose the correct .deb or .rpm package and CPU architecture.
  • TraeCode, TraeWork, TraeCode Plugin, and TraeCode CLI are different products. Developers looking for the full desktop AI IDE should choose TraeCode.
  • Download the installer from TRAE's official distribution channel rather than third-party software mirrors.
  • After installation, verify Git, development runtimes, repository indexing, and project configuration before delegating large coding tasks to the AI.

Searching for a Trae IDE download can be confusing because the TRAE product family now includes several tools. The dedicated coding environment is increasingly presented under the TraeCode name, while TRAE also offers broader AI work tools, IDE integrations, and command-line coding agents.

For developers who want the complete desktop AI coding environment, TraeCode is the product to download.

This guide explains how to choose the correct TraeCode installer, install it on Windows, macOS, or Linux, configure a first project, avoid common download mistakes, and decide whether the standalone IDE, plugin, or CLI is the better fit.

Is Trae IDE Now Called TraeCode?

Current TRAE branding uses TraeCode for its dedicated AI coding environment, while older tutorials, discussions, and search results may still use Trae IDE or TRAE IDE.

That means users may encounter searches such as:

Trae IDE download
TraeCode download
Trae AI IDE download
TRAE download for Windows
TRAE download for Mac
TraeCode Linux download

For practical purposes, developers searching for the complete coding editor should look for TraeCode.

Do not confuse it with TraeWork, which targets broader AI-assisted work rather than functioning purely as a software-development IDE.

TraeCode vs TraeWork vs TraeCode Plugin vs CLI

Before downloading anything, identify which TRAE product matches the intended workflow.

ProductBest ForSeparate IDE Required?
TraeCodeFull AI-native coding environmentNo
TraeWorkBroader AI-assisted professional workNo
TraeCode PluginAdding TRAE capabilities to an existing supported IDEYes
TraeCode CLITerminal-based coding and agent workflowsNo graphical IDE required

If the goal is to use a dedicated AI code editor, choose TraeCode.

If the goal is to keep an existing IDE and add TRAE features, the plugin may be more appropriate.

If development is primarily terminal-based, TraeCode CLI can be the better fit.

Where to Download TraeCode Safely

Use TRAE's official download channel whenever possible.

Avoid downloading TraeCode from random software directories, file-sharing services, repackaging websites, or unofficial mirrors.

Third-party installers can introduce risks such as:

  • outdated versions
  • modified executables
  • bundled software
  • broken automatic updates
  • wrong CPU architecture
  • missing signatures
  • malicious modifications

This matters especially for an AI coding environment because the application may interact with source code, Git repositories, local terminals, credentials, and deployment tooling.

TraeCode System Requirements

TraeCode supports the major desktop operating systems, but the correct package depends on both the OS and architecture.

Typical supported environments include:

PlatformTypical RequirementArchitecture
macOSModern supported macOS releaseApple Silicon or Intel
WindowsWindows 10 or Windows 11x64
Debian-based LinuxUbuntu, Debian, and compatible distributionsx64 or ARM64 where supported
RPM-based LinuxFedora, RHEL, and compatible distributionsx64 or ARM64 where supported

System requirements should be treated as minimum compatibility guidelines rather than ideal performance specifications.

AI IDE workloads may involve:

  • repository indexing
  • multiple language servers
  • Git operations
  • local development servers
  • browser previews
  • extensions
  • terminals
  • several AI tasks at once

Larger repositories benefit from additional memory and CPU capacity.

How to Download TraeCode for macOS

Mac users should identify whether the computer uses Apple Silicon or Intel before choosing an installer.

Check Whether a Mac Uses Apple Silicon or Intel

Open:

Apple menu → About This Mac

Look for a chip such as:

Apple M1
Apple M2
Apple M3
Apple M4

These are Apple Silicon processors.

Older Macs may display an Intel processor instead.

The architecture can also be checked in Terminal:

bash
uname -m

Typical output:

arm64

means Apple Silicon.

Output such as:

x86_64

usually indicates an Intel Mac.

Which macOS Version Should You Download?

For Apple Silicon Macs, choose the native ARM64 / Apple Silicon build when available.

For Intel Macs, choose the Intel / x86_64 package.

Using the native architecture generally provides better compatibility, startup performance, and memory efficiency than relying on translation layers.

How to Install TraeCode on macOS

After downloading the installer:

  1. Open the downloaded package.
  2. Move TraeCode to the Applications folder if prompted.
  3. Launch TraeCode from Applications.
  4. Complete the first-run setup.
  5. Sign in when required.
  6. Open or clone a development repository.

If macOS displays a security warning, confirm that the application came from the official TRAE distribution channel before overriding any protection.

Do not disable macOS security mechanisms globally just to install one application.

TraeCode on Older macOS Versions

Older versions of TraeCode may sometimes be available for older operating systems, but legacy builds should be treated as a fallback rather than the preferred installation path.

Older builds may lack:

  • newer AI features
  • model integrations
  • agent improvements
  • performance fixes
  • bug fixes
  • security updates
  • newer extension compatibility

If the Mac supports a newer operating-system release, upgrading the OS is generally preferable to remaining permanently on an outdated IDE version.

How to Download TraeCode for Windows

For a typical Windows 10 or Windows 11 PC, select the Windows x64 installer.

To verify the system architecture, open:

Settings → System → About → System type

A typical modern PC will show:

64-bit operating system, x64-based processor

Then choose the corresponding Windows TraeCode installer.

How to Install TraeCode on Windows

After downloading the installer:

  1. Run the installer.
  2. Review Windows security prompts.
  3. Complete installation.
  4. Launch TraeCode.
  5. Sign in when required.
  6. Open an existing repository or clone one.

After installation, verify that the development tools required by the project are available in TraeCode's terminal.

For example:

bash
git --version
node --version
python --version

Only run commands for tools actually used by the project.

TraeCode does not replace every language runtime, package manager, SDK, compiler, database, or cloud CLI a project may require.

How to Download TraeCode for Linux

Linux users usually need to choose both a package format and processor architecture.

Common package types include:

  • .deb
  • .rpm

Use .deb For

Typical examples include:

  • Ubuntu
  • Debian
  • closely related Debian-based distributions

Use .rpm For

Typical examples include:

  • Fedora
  • RHEL
  • compatible RPM-based distributions

Do not select a package only because its filename looks familiar. Verify the distribution and CPU architecture first.

Check Linux Architecture Before Downloading

Run:

bash
uname -m

A result such as:

x86_64

means a standard 64-bit Intel or AMD environment.

A result such as:

aarch64

usually indicates an ARM64 system.

Download the package matching the actual machine architecture.

Install a .deb Package

On Debian and Ubuntu systems, a local package can commonly be installed using:

bash
sudo apt install ./traecode-package.deb

Replace traecode-package.deb with the actual downloaded filename.

Using apt is useful because it can resolve dependencies automatically.

Install an .rpm Package

On Fedora-family systems, a local RPM can commonly be installed with:

bash
sudo dnf install ./traecode-package.rpm

Replace the placeholder filename with the actual package.

Distribution-specific behavior may vary, so use the package-management workflow recommended by the Linux distribution when necessary.

What to Do After Installing TraeCode

The best first step is not to immediately ask the AI to rewrite a large project.

Start by establishing a clean development environment.

1. Open the Repository Root

Open the actual project root instead of a deeply nested source folder.

For example:

my-project/
├── src/
├── tests/
├── package.json
├── README.md
└── .git/

Opening the root gives TraeCode better access to configuration, tests, documentation, and architectural context.

2. Verify Git State

Before allowing broad AI edits:

bash
git status
git branch --show-current

A clean working tree makes AI-generated changes easier to inspect and revert.

3. Let Project Indexing Finish

Repository-wide AI features work best after the editor understands the codebase.

Avoid immediately starting a major cross-project refactor while indexing is incomplete.

4. Configure Project Rules

If the project has stable development conventions, define them early.

Useful rules can cover:

  • framework conventions
  • directories that should not be edited
  • test expectations
  • TypeScript requirements
  • dependency restrictions
  • API patterns
  • formatting rules

5. Start with a Read-Only Task

A useful first prompt is:

Analyze this repository and explain its major modules. Do not modify any files.

This provides a quick test of whether TraeCode understands the repository before larger tasks are delegated.

How to Import an Existing VS Code Workflow

Developers moving from VS Code do not need to reproduce every part of the previous environment immediately.

A better migration strategy is incremental.

Start with:

  • keyboard shortcuts
  • theme preferences
  • essential language support
  • formatter configuration
  • Git workflow
  • terminal environment

Then add extensions only when they are required.

Blindly recreating a large extension collection can introduce:

  • duplicated features
  • conflicting formatters
  • multiple AI assistants competing for context
  • slower startup
  • increased memory usage
  • extension compatibility problems

The objective should be to preserve useful development capabilities, not to duplicate the previous editor exactly.

TraeCode Download vs TraeCode Plugin

Downloading the full IDE is not always necessary.

A plugin-based workflow can make sense when:

  • a team is standardized on another IDE
  • a project depends heavily on IDE-specific tooling
  • existing debugging integrations are difficult to reproduce
  • company policy restricts editor choices
  • developers want TRAE features without migrating their complete environment

The standalone TraeCode application is a better fit when AI-assisted coding is intended to become the primary workflow.

TraeCode Download vs TraeCode CLI

TraeCode CLI targets terminal-oriented development rather than replacing the graphical IDE.

A CLI workflow can be useful for:

  • terminal-first development
  • repository analysis
  • code review
  • automated fixes
  • scripting
  • batch refactoring
  • remote development environments

If a graphical editor, project explorer, integrated terminal, code navigation, and IDE-style workflow are required, choose TraeCode instead.

TraeCode vs TraeWork

TraeCode and TraeWork should not be treated as interchangeable downloads.

TraeCode focuses on software engineering tasks such as:

  • source-code editing
  • AI coding agents
  • repository context
  • code completion
  • debugging
  • terminal workflows
  • project management

TraeWork targets broader AI-assisted professional workflows beyond programming.

If a search for TRAE download produces multiple products, developers looking specifically for an AI IDE should choose TraeCode.

Should You Download TraeCode from GitHub?

Do not assume that a GitHub repository with TRAE or TraeCode in its name is the canonical desktop installer.

Search results may contain:

  • community projects
  • unofficial wrappers
  • unrelated repositories
  • plugins with similar names
  • installer archives
  • old versions

For routine installation, prefer the official distribution channel.

How to Check the Installed TraeCode Version

The installed version can typically be checked through the application's About or update interface.

Knowing the exact version is useful when troubleshooting:

  • missing features
  • UI differences
  • login issues
  • extension problems
  • crashes
  • model availability
  • unexpected agent behavior

Avoid treating a version number from an old tutorial as the current release. AI development tools are updated frequently.

How to Update TraeCode

Use TraeCode's normal update mechanism or install the latest official build when necessary.

Before major upgrades:

  • commit important project changes
  • verify repository status
  • preserve critical local configuration
  • check organization policies
  • stop sensitive development processes if needed

Project source code should remain protected by Git or another version-control system rather than depending on the IDE installation itself.

Should You Reinstall TraeCode to Fix Problems?

Not immediately.

Many apparent IDE problems actually originate from:

  • extensions
  • repository configuration
  • Git credentials
  • network restrictions
  • proxies
  • language servers
  • environment variables
  • package managers
  • model connectivity

Before reinstalling, determine whether the problem affects:

One file
One project
One extension
One model
One account
One network
or the entire IDE

If only one repository fails, reinstalling the application may not address the actual cause.

Common Problem: TraeCode Will Not Open on macOS

Check:

  • the macOS version
  • whether the correct Apple Silicon or Intel build was installed
  • whether the installer came from the official distribution channel
  • whether the application is installed correctly
  • whether macOS security settings blocked the application

Do not permanently disable system protections as a shortcut.

Common Problem: Windows Blocks the Installer

If Windows displays a warning:

  1. Verify that the installer came from TRAE's official distribution channel.
  2. Inspect publisher information when available.
  3. Check that the downloaded file has not been unexpectedly modified or renamed.
  4. Avoid bypassing warnings for installers from unknown mirrors.

This is particularly important for development software because an IDE may access repositories, credentials, local terminals, and deployment tools.

Common Problem: Wrong Mac Architecture

Installing an Intel build on an Apple Silicon Mac may introduce unnecessary translation overhead.

Check the architecture with:

bash
uname -m

For Apple Silicon, prefer the ARM64 build.

For Intel hardware, choose the x86_64-compatible version.

Common Problem: Wrong Linux Package

A .deb installer is not interchangeable with an .rpm installer.

Identify the Linux distribution using:

bash
cat /etc/os-release

Then check architecture:

bash
uname -m

Choose the package matching both.

Common Problem: TraeCode Installs but Project Tools Do Not Work

Installing an IDE does not automatically install all project runtimes.

A JavaScript project may still require Node.js and a package manager.

A Python project may require Python, virtual environments, and project dependencies.

A Rust project may require the Rust toolchain.

Other projects may depend on Docker, databases, cloud CLIs, Java, Go, native compilers, or platform SDKs.

Verify the environment from TraeCode's terminal.

For example:

bash
which git
which node
which python

On Windows PowerShell:

powershell
Get-Command git
Get-Command node
Get-Command python

Common Problem: Download Is Slow or Fails

Before switching to an unofficial mirror, try:

  • retrying the official download
  • changing networks
  • checking firewall rules
  • verifying available disk space
  • checking proxy configuration
  • using another supported browser

Corporate networks may block software-distribution endpoints even when the main TRAE website loads correctly.

Common Problem: AI Features Do Not Work After Installation

A successful desktop installation does not guarantee that cloud-backed AI functionality can connect.

Check:

  • account login status
  • internet connectivity
  • proxy configuration
  • firewall restrictions
  • model availability
  • organization permissions
  • current service status

If the editor works normally but AI requests fail consistently, treat the problem as a connectivity, configuration, or account issue before reinstalling the IDE.

Security Checklist Before Using TraeCode on a Real Repository

AI coding environments can interact deeply with a project, so perform a short security review before using them with sensitive repositories.

Keep Secrets Out of Prompts

Avoid exposing:

  • API keys
  • access tokens
  • private keys
  • passwords
  • production database credentials
  • customer secrets

Use environment variables and secret-management systems instead.

Review Indexing and Ignore Settings

Generated files, secrets, datasets, and irrelevant directories should not become AI context unnecessarily.

Review AI-Generated Changes

Before committing:

bash
git diff

Also check repository status:

bash
git status

Then run relevant tests and linters.

Create a Branch Before Large Tasks

For example:

bash
git switch -c feature/trae-test

This creates a clean rollback boundary for experimentation.

A practical setup sequence is:

  1. Download TraeCode from the official distribution channel.
  2. Install the native package for the operating system and processor.
  3. Sign in and configure essential editor settings.
  4. Open a small existing repository.
  5. Confirm Git and required runtimes work in the terminal.
  6. Let repository indexing complete.
  7. Review project rules and ignored files.
  8. Ask TraeCode to explain the repository without modifying it.
  9. Create a feature branch.
  10. Delegate one small, reviewable coding task.
  11. Inspect the generated diff manually.
  12. Run tests before committing.

This gives a much more useful evaluation than immediately asking an unfamiliar coding agent to implement a large feature.

Is TraeCode Free to Download?

The desktop application can be downloaded from TRAE's distribution channels, while access to particular AI models, quotas, premium features, or organization capabilities can depend on the current TRAE pricing structure.

AI product plans can change frequently, so always verify current pricing before assuming every model or usage level is included.

The important distinction is:

Downloading the IDE and receiving unlimited access to every AI capability are not the same thing.

Is TraeCode Available on Mobile?

The complete TraeCode development environment is designed around desktop software-development workflows.

Mobile TRAE experiences should not be confused with installing the full desktop IDE on a phone.

For repository editing, local terminals, language servers, builds, debugging, and larger coding tasks, the desktop environment remains the relevant option.

Which TraeCode Download Should You Choose?

DeviceRecommended Package
Apple Silicon MacmacOS ARM64 / Apple Silicon
Intel MacmacOS Intel / x86_64
Windows 10/11 PCWindows x64
Ubuntu or Debian x64.deb x64
Ubuntu or Debian ARM64.deb ARM64 when supported
Fedora or RHEL x64.rpm x64
Fedora or RHEL ARM64.rpm ARM64 when supported
Existing supported IDE workflowConsider TraeCode Plugin
Terminal-first workflowConsider TraeCode CLI

When uncertain, identify the operating system and CPU architecture before downloading rather than experimenting with multiple installers.

TraeCode Download FAQ

Is TraeCode the Same as Trae IDE?

TraeCode is the current name commonly used for TRAE's dedicated AI coding environment. Older references may still call it Trae IDE or TRAE IDE.

Can TraeCode Run on Windows 10?

Yes, supported modern TraeCode builds are designed for current 64-bit Windows environments including Windows 10 and Windows 11.

Can TraeCode Run on an Intel Mac?

Intel Mac support depends on the currently available installer, so Intel users should choose the x86_64 build when provided rather than installing the Apple Silicon package.

Is There a TraeCode Linux Version?

Yes. Linux packages are available for supported Debian-based and RPM-based environments.

Should Apple Silicon Users Download the Intel Version?

Normally no. Use the native ARM64 build when available.

Is TraeWork the Same as TraeCode?

No. TraeCode is focused on software development, while TraeWork targets broader AI-assisted work.

Does Installing TraeCode Install Node.js or Python?

Do not assume so. Project-specific runtimes and dependencies should be installed separately.

Should You Install an Old TraeCode Version?

Only when compatibility requires it. Current builds are generally preferable because they contain newer features, bug fixes, and security improvements.

Conclusion

For developers searching for Trae IDE download, the product to look for is TraeCode, TRAE's dedicated AI coding environment.

Choose the installer according to both the operating system and CPU architecture: Apple Silicon versus Intel on macOS, x64 on standard Windows PCs, and the appropriate .deb or .rpm architecture on Linux.

Use the official TRAE distribution channel rather than third-party installer mirrors. After installation, verify Git and development runtimes, let repository indexing finish, configure project rules, and begin with a small read-only analysis task before delegating major code changes.

The decision is straightforward: choose TraeCode for the complete AI IDE, TraeCode Plugin when keeping an existing supported editor, and TraeCode CLI for terminal-first coding workflows.

Share this article