The essential guide to installing Amazon Q Developer CLI on Windows
Having Amazon Q Developer CLI at your finger tips is only a short step away for Windows users
Ricardo Sueiras
Amazon Employee
Published Mar 31, 2025
Following on from my previous post on how to install Amazon Q Developer CLI on Linux environments, I thought I would share a similar guide for those of you using Windows.
Whilst there is no native Windows installation yet, you can install and run Amazon Q Developer CLI on your Windows machines using the Windows Subsystem for Linux, or wsl for short. In this post I will walk you through what you need to do.
You might already have wsl installed on your machine, in which case you can skip this step. If you do not, then Microsoft have put together a blog post that walks you through this process.
Once you have wsl up and running we can begin.
The steps below are covered in the official Amazon Q Developer CLI installation documentation
From a Windows command shell enter the following command:
wsl -d UbuntuThis is going to download and install a virtual Ubuntu instance in your wsl environment. If you have already done this in the past, it will just log you into your Ubuntu wsl environment.
After installing Ubuntu, you will be asked to create a default user account (it will typically copy the name of the Windows user you are logged in as as a suggested user name). After deciding on the user name, you will be asked to enter a password. After you have completed that you are all ready to go.
You will notice that the default directory when you are in your wsl account maps to your Windows home directory. For the installation we will change this and enter the home directory of the wsl environment, which we can do by simply typing:
cdYou will notice that the directory path has changed.
Now that we are in the correct directory, the first thing we need to do is install some missing packages that the installation will need. We will use the native package manager of Ubuntu to do this.
sudo apt install unzipYou will be asked to enter the password for the Ubuntu user you created (not the Windows password, unless of course you used the same one!). This will install the unzip utility and should not take long.
The next step is to download the zip file that contains the installer. From the wsl command line, we use the following command:
curl --proto '=https' --tlsv1.2 -sSf https://desktop-release.codewhisperer.us-east-1.amazonaws.com/latest/q-x86_64-linux-musl.zip -o q.zipThis should download the installer into your current directory, which should be the home directory.
Make sure you check! that you are running in the wsl home directory and not the windows home directory. If you use the "pwd" command, it will tell you. It should say "/home/{youruser}" - if it does not, then make sure you enter the "cd" command again.
Now we will unzip this by using the following command:
unzip q.zipWhich creates a subdirectory called "q" with all the files we need. We are nearly ready to run the installer, but first we need to enable it by running the following commands:
cd qchmod +x install.shThe chmod command changes permissions of files in Linux, and we are enable the install.sh to be executable so we can run the installer. Which we do using the following command:
./install.shYou will be asked if you want it to modify your shell config. Answer "Yes" as what this is doing is adding a new path to point to the Amazon Q Developer CLI executables. Once that has completed, you will now need to activate your new shell. You can either exit and re-launch your wsl environment, or just type:
bashAmazon Q Developer is now installed, the next stage us to create our Builder ID and then use it to login.
From the command enter the following command:
q loginYou will see two options for Login method which you can select using the up and down arrow keys. You want to select the first option, "Use for Free with Builder ID"
When you select this option, it will ask you to open a URL in a web browser. Copy the URL, and then open it up in a web browser. You will now need to either create a new Builder ID, or login using an existing Builder ID you might already have.
I have created a short video that shows you these steps.
Once you have completed that, you will be logged into Amazon Q Developer and can access it from wsl by invoking:
q chatCongratulations, you are now ready to go!
In the video you will also see me running "q doctor" which is a way to check to see that everything is running ok with Amazon Q Developer.
Now that we have Amazon Q Developer installed, we can start using it by starting a new wsl session, and then invoking it using the "q chat" or "q ai" commands.
We start our wsl session:
wsl -d UbuntuIf you notice that in my session, the default directory is the Windows home directory. If I invoke Amazon Q Developer cli here, then this is going to be its working directory.
I can now invoke Amazon Q Developer CLI using the following command:
q chatAnd I now have access to all the features and capabilities of Amazon Q Developer. In this example video, I show how I can use it to create a simple Windows batch file that I run from a native Windows command shell.
After I have completed my activities, I can exit from Amazon Q Developer by typing "/q", and then leave my wsl session any time entering "exit"
In this post I shared how you can install Amazon Q Developer CLI on your Windows machine using the Windows Subsystem for Linux, and showed you how you can get started.
You can try Amazon Q Developer CLI for free today, by signing up for a Builder ID and then downloading the app from here.
Until next time folks!
Made with 🧡 by DevRel!
Any opinions in this post are those of the individual author and may not reflect the opinions of AWS.