Installing Claude Code on Linux Mint | apt and the Official Installer

Prerequisites before using Claude Code on Linux Mint

Claude Code is an AI-assisted coding CLI that runs in the terminal. For an overview of Claude Code's features and how to use it, see What is Claude Code.

The Linux distributions officially supported by Claude Code are Ubuntu 20.04 and later and Debian 10 and later (with hardware requirements of 4 GB or more RAM and x64 / ARM64, and Bash or Zsh as the shell). Since Linux Mint is based on one of these, all current editions meet the requirements.

• Linux Mint 22.x (Cinnamon / MATE / Xfce) = based on Ubuntu 24.04 LTS
• Linux Mint 21.x = based on Ubuntu 22.04 LTS
• Linux Mint 20.x = based on Ubuntu 20.04 LTS
• LMDE 6 (Linux Mint Debian Edition) = based on Debian 12

Note that the official Anthropic Claude desktop app is only available for macOS and Windows — there is no official GUI for Linux. On Mint, your main options are the CLI running in a terminal or the browser-based web version. For information about unofficial packages if you need a GUI, also see How to use Claude on Linux. Source: Claude Code Advanced setup.

Method 1: Official native installer (fastest, recommended)

The simplest approach is Anthropic's official native installer. It requires no Node.js, places the binary at ~/.local/bin/claude, and handles automatic background updates. Open a terminal in Mint (in Cinnamon, this is "Terminal") and run:

curl -fsSL https://claude.ai/install.sh | bash

Once installation is complete, open a terminal in your project folder and launch it by typing claude. No sudo is required. It works fine with Bash, Mint's default shell.

Method 2: Installing via the apt signed repository

If you want to integrate with your system's update management (apt upgrade), use the signed apt repository that Anthropic publishes. Since Mint is based on Ubuntu / Debian, the Ubuntu instructions apply directly.

1. Create the directory for the keyring (where signing keys are stored)

   sudo install -d -m 0755 /etc/apt/keyrings
   

2. Download the signing key

   sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
     -o /etc/apt/keyrings/claude-code.asc
   

3. Register the repository

   echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
     | sudo tee /etc/apt/sources.list.d/claude-code.list
   

4. Update the package list and install

   sudo apt update
   sudo apt install claude-code
   

Before trusting the key, it is a good idea to verify that its fingerprint matches 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE by running gpg --show-keys /etc/apt/keyrings/claude-code.asc. Future updates are applied with sudo apt update && sudo apt upgrade claude-code (note that the apt version does not auto-update).

Method 3: Installing via npm and the Node.js pitfall

If you already have a Node.js development environment and prefer to manage Claude Code as a global package, you can install via npm.

npm install -g @anthropic-ai/claude-code

There is an important Mint-specific caveat here. The Claude Code npm package requires Node.js 18 or later, but on Mint 21.x (based on Ubuntu 22.04) and older, the default repositories ship an older version of Node.js, meaning the version installed by apt install nodejs may be insufficient. If node -v shows a version below 18, reinstall Node.js 18 or later using the official NodeSource repository or nvm (Node Version Manager, a tool for switching between Node.js versions). On Mint 22.x (based on Ubuntu 24.04), the default repository's Node.js is already version 18, so you can use it as-is.

Note that sudo npm install -g is officially discouraged due to permission and security issues. If managing versions feels cumbersome, switching to the native installer in Method 1 — which uses no Node.js at all — is ultimately the quickest path. Sources: Install with npm, Node.js downloads.

Verifying the installation and logging in

Regardless of which method you used, start by verifying that everything works.

1. Check the version

   claude --version
   

2. Run a diagnostics check (checks PATH, update status, and more)

   claude doctor
   

If you see command not found here, it is a PATH issue (see below). If everything is fine, running claude will open a browser and prompt you to log in. Using Claude Code requires a Claude Pro, Max, Team, Enterprise, or Console account — it cannot be used with a free Claude.ai plan. You can also connect via external API providers such as Amazon Bedrock or Google Vertex AI.

Updating and uninstalling

The native installer version updates automatically in the background, but if you want to update immediately, run claude update. For the apt version, follow your system's update workflow with sudo apt update && sudo apt upgrade claude-code. For the npm version, use npm install -g @anthropic-ai/claude-code@latest — be aware that npm update -g can get pinned to an older semver range and may not pull the latest version.

To remove the native version, delete the binary and associated files:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

For the apt version, run sudo apt remove claude-code, then delete /etc/apt/sources.list.d/claude-code.list and the keyring. If you also want to remove configuration, delete ~/.claude and ~/.claude.json (note that this removes all settings, permitted tools, and history).

Common pitfalls on Mint

Here are the issues most likely to trip you up right after installation.

• claude: command not found: The native / npm versions require ~/.local/bin to be on your PATH. Reopen your terminal, or add export PATH="$HOME/.local/bin:$PATH" to your ~/.bashrc and run source ~/.bashrc.
• Node.js is too old (npm path): If node -v shows a version below 18, the npm path will fail. Reinstall using NodeSource or nvm, or switch to Method 1.
• Search (ripgrep) not working: ripgrep is normally bundled, but if it's missing for some reason, install it with sudo apt install ripgrep.
• Older Mint (20.x): While it meets the requirements, older libraries may cause unstable behavior. If possible, consider upgrading to 22.x.

For a full comparison of installation paths across operating systems, see How to install the Claude CLI.

Summary: Which method should you choose on Mint?

For installing Claude Code on Linux Mint, here is the fastest choice by use case:

1. Just want to get started quickly → Method 1: official native installer (no Node.js required, auto-updates)
2. Want to unify with system update management → Method 2: apt signed repository
3. Want to align with an existing Node.js development environment → Method 3: npm (requires Node.js 18 or later)

If you're unsure, go with the native installer — it gets you up and running in the shortest time regardless of your Mint edition or Node.js version. After installation, running claude doctor to check your environment will make troubleshooting much easier if anything goes wrong. Source: Claude Code Advanced setup.