Install CodeFusion Studio on Windows, macOS, and Linux

CodeFusion Studio 2.2.0 is distributed as a self-contained SDK installer for Windows, macOS, and Linux. The installer bundles the core runtime, cfsutil CLI, and a local package cache bootstrap — the VS Code extension is then installed separately from the Marketplace or from the VSIX bundled with the SDK. This page walks through every step from checking prerequisites to verifying that the extension is active in VS Code, including optional driver setup for RISC-V debugging.

Software Requirements

Before downloading the installer, confirm that your system meets the following requirements.

VS Code Version

Visual Studio Code 1.100 or later is required. Earlier versions (such as 1.98 and below) are not supported due to known layout issues in the System Planner → Pin Config canvas. Download the latest VS Code from code.visualstudio.com.

Supported Operating Systems

Operating System	Architecture	Notes
Windows 11 (64-bit)	x86_64	AI Tools require the Visual C++ Redistributable for VS 2015
macOS 15	ARM64	—
macOS 26	ARM64	—
Ubuntu 22.04 (64-bit)	x86_64	See Linux package dependencies below
Ubuntu 24.04 (64-bit)	x86_64	See Linux package dependencies below

Earlier or newer OS versions may work but are not officially supported.

Linux Package Dependencies

The CodeFusion Studio installer requires the following system libraries. These are included in default Ubuntu installations but may be absent in headless or minimal environments:

sudo apt install libfontconfig1 libdbus-1-3 libxcb-icccm4 libxcb-image0 \
  libxcb-keysyms1 libxcb-render-util0 libxcb-shape0 libxcb-xinerama0 \
  libxkbcommon-x11-0 libgl1

Step 1 — Download the Installer

Download CodeFusion Studio 2.2.0 from the CodeFusion Studio Developer Resources page, or use the direct links below:

Windows (.exe)

CodeFusionStudio_2.2.0.exe

macOS (.dmg)

CodeFusionStudio_2.2.0.dmg

Linux (.run)

CodeFusionStudio_2.2.0.run

Step 2 — Run the SDK Installer

Windows
macOS
Linux

Launch the installer

Double-click CodeFusionStudio_2.2.0.exe to launch the setup wizard.

Follow on-screen instructions

Click through the welcome screen and follow the prompts to begin setup.

Choose the installation folder

Specify your installation directory when prompted. The recommended default is C:\analog\cfs\2.2.0.

The installation path must not contain spaces.

Select components

Choose the components to install. To enable debugging for SHARC-FX processors, select the ADI ICE Drivers (Requires Administrator) checkbox. When prompted, approve the Windows elevation dialog. This installs USB drivers for ICE-1000, ICE-1500, and ICE-2000 emulators. You can install these drivers manually later if you skip this step.

Accept the license agreement

Review and accept the license agreement to continue.

Choose Start Menu folder

Select the Start Menu folder for the CFS shortcut (Windows only).

Complete installation

Review your selections, start the installation, and close the wizard when it completes.

Open the disk image

Double-click CodeFusionStudio_2.2.0.dmg to mount it and launch the setup wizard.

Follow on-screen instructions

Click through the welcome screen and follow the prompts to begin setup.

Choose the installation folder

Specify your installation directory when prompted. The recommended default is /Users/<username>/analog/cfs/2.2.0.

The installation path must not contain spaces.

Select components

Choose the default or desired components to install and proceed.

Accept the license agreement

Review and accept the license agreement to continue.

Complete installation

Review your selections, start the installation, and close the wizard when it completes.

Grant execute permissions

The Linux installer downloads without execute permissions. Before running it, grant execute permissions:

chmod a+x CodeFusionStudio_2.2.0.run

The CodeFusion Studio installer does not require elevated sudo permissions to run.

Launch the installer

Double-click CodeFusionStudio_2.2.0.run, or run it from the terminal:

./CodeFusionStudio_2.2.0.run

Follow on-screen instructions

Click through the welcome screen and follow the prompts to begin setup.

Choose the installation folder

Specify your installation directory when prompted. The recommended default is /home/<username>/analog/cfs/2.2.0.

The installation path must not contain spaces.

Select components

Choose the default or desired components to install and proceed.

Accept the license agreement

Review and accept the license agreement to continue.

Complete installation

Review your selections, start the installation, and close the wizard when it completes.

Command-Line Installation

You can also run the installer non-interactively using the following switches:

Switch	Effect
`--help`	Show available options
`-t <path>`	Specify a custom installation path
`-c`	Confirm all prompts automatically
`--al`	Accept the license agreement

If using --al to accept the license, review the license texts in the Licenses directory of the installer before proceeding.

hdiutil mount CodeFusionStudio_2.2.0.dmg -mountpoint cfs
cfs/CodeFusionStudio_2.2.0.app/Contents/MacOS/CodeFusionStudio_2.2.0 install --am --al -c
hdiutil unmount cfs

Step 3 — Install the VS Code Extension

You can install the CodeFusion Studio VS Code extension using one of the following methods. Once installed, VS Code automatically upgrades the extension when new versions become available (unless auto-updates are disabled).

From VS Code (Recommended)
From the Marketplace
Manual VSIX Install

Open the Extensions panel

In VS Code, go to Extensions or press Ctrl+Shift+X (Windows/Linux) / Cmd+Shift+X (macOS).

Search for CodeFusion Studio

Type CodeFusion Studio in the search box.

Install the extension

Select the CodeFusion Studio extension published by Analog Devices and click Install.

Verify installation

The extension should appear in your Installed list. VS Code may prompt you to reload the window — do so to activate the extension.

Use this method if you cannot reach the Marketplace due to firewall restrictions or an offline environment.

Open the Extensions panel

In VS Code, select the Extensions icon from the activity bar.

Open the More Actions menu

Click Views and More Actions (...) and select Install from VSIX.

Navigate to the VSCode directory

Browse to the VSCode directory within your CFS SDK installation. Default paths are:

Linux: /home/<username>/analog/cfs/2.2.0/VSCode
macOS: /Users/<username>/analog/cfs/2.2.0/VSCode
Windows: C:\analog\cfs\2.2.0\VSCode

Select the VSIX file

Select the cfs-ide-*.vsix file to install it.

Restart VS Code

Restart VS Code for the changes to take effect.

Managing Automatic Extension Updates

Each CFS extension version is specifically paired with a matching SDK version. If the extension auto-updates but the SDK does not, you may encounter unexpected behavior. To prevent this, disable auto-updates for the CFS extension: open the Extensions panel, select CodeFusion Studio, and clear the Auto Update checkbox. To revert to a previous version, click the gear icon next to the extension and choose Install Specific Version….

Dependent Extensions

The CodeFusion Studio extension depends on Microsoft C/C++, Cortex-Debug, and Zephelin Trace Viewer. These are installed automatically on first install. To view the full list, open the Dependencies tab on the CodeFusion Studio extension details page. If you upgrade CFS, dependent extensions are not automatically updated — update them manually from the Extensions panel if issues arise.

Step 4 — (Optional) Install Olimex JTAG Drivers for RISC-V

The Olimex ARM-USB-OCD-H debugger is required to debug the RISC-V core on supported MAX parts. Olimex drivers are not bundled with CFS and must be installed manually if RISC-V debugging is required. Download and installation instructions are in Chapter 3 of the Olimex ARM-USB-OCD-H User Manual.

Next Steps

With the SDK installed and the extension active, configure your SDK path in VS Code so CFS can locate your installation:

Set Up CodeFusion Studio

Configure cfs.sdk.path, access the CFS Terminal, and verify your environment is ready.

Get Started

Workspace & System Planner

Build, Flash & Debug

Embedded AI

Developer Tools

Install CodeFusion Studio on Windows, macOS, and Linux

Software Requirements

VS Code Version

Supported Operating Systems

Linux Package Dependencies

Step 1 — Download the Installer

Windows (.exe)

macOS (.dmg)

Linux (.run)

Step 2 — Run the SDK Installer

Command-Line Installation

Step 3 — Install the VS Code Extension

Managing Automatic Extension Updates

Dependent Extensions

Step 4 — (Optional) Install Olimex JTAG Drivers for RISC-V

Next Steps

Set Up CodeFusion Studio

Build docs developers (and LLMs) love

Get Started

Workspace & System Planner

Build, Flash & Debug

Embedded AI

Developer Tools

Documentation Index

​Software Requirements

​VS Code Version

​Supported Operating Systems

​Linux Package Dependencies

​Step 1 — Download the Installer

Windows (.exe)

macOS (.dmg)

Linux (.run)

​Step 2 — Run the SDK Installer

​Command-Line Installation

​Step 3 — Install the VS Code Extension

​Managing Automatic Extension Updates

​Dependent Extensions

​Step 4 — (Optional) Install Olimex JTAG Drivers for RISC-V

​Next Steps

Set Up CodeFusion Studio

Build docs developers (and LLMs) love

Software Requirements

VS Code Version

Supported Operating Systems

Linux Package Dependencies

Step 1 — Download the Installer

Step 2 — Run the SDK Installer

Command-Line Installation

Step 3 — Install the VS Code Extension

Managing Automatic Extension Updates

Dependent Extensions

Step 4 — (Optional) Install Olimex JTAG Drivers for RISC-V

Next Steps