Install Prerequisites

This page covers the software required for Claude Code: Node.js and Git.

Already set up?

If you already have Node.js 22+ and Git installed, skip this page and go straight to an integration guide.

Claude Code

Install Node.js

We recommend the latest LTS (Long-Term Support) release. ApexOne requires Node.js 22.x or later.

Windows

1. Visit nodejs.org.
2. Download the latest LTS installer.
3. Run the downloaded .msi file and follow the installation wizard.
4. Restart your terminal before continuing.

macOS

Recommended: NVM — NVM lets you manage multiple Node.js versions and switch between them per project.

# Install NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash

# Reload your shell configuration
source ~/.zshrc

# Install the latest LTS release
nvm install --lts

# Set it as the default version
nvm alias default 'lts/*'

# Use it now
nvm use --lts

Alternative: Homebrew

brew install node

Linux

Recommended: NVM

# Install NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash

# Reload your shell configuration
source ~/.bashrc

# Install and use the latest LTS release
nvm install --lts
nvm alias default 'lts/*'
nvm use --lts

Alternative: package manager

# Ubuntu / Debian
sudo apt update && sudo apt install -y nodejs npm

# Fedora / RHEL / CentOS
sudo dnf install -y nodejs

Caution

Distribution packages are often several major versions behind. If node --version reports anything older than 22, use NVM (above) or NodeSource to get a current release.

Verify Node.js

Open a terminal and run:

node --version
npm --version

Example output:

v22.14.0
10.9.2

If both commands return version numbers, Node.js has been installed successfully.

Install Git

Git is a distributed version control system used by Claude Code and most modern development workflows.

Windows

1. Visit git-scm.com/download/win.
2. Download and run the latest installer.
3. During setup, we recommend:
   • Git from the command line and also from 3rd-party software
   • Use Windows’ default console window
4. Complete the installation using the default settings.

macOS

Option 1 — Homebrew

brew install git

Option 2 — Xcode Command Line Tools

xcode-select --install

Option 3 — Official installer: download from git-scm.com/download/mac.

Linux

# Ubuntu / Debian
sudo apt update && sudo apt install -y git

# Fedora / RHEL / CentOS
sudo dnf install -y git

Verify Git

git --version

Example output:

git version 2.43.0

If a version number is displayed, Git has been installed successfully.

Configure Git

After installation, configure your Git identity:

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

To verify your configuration:

git config --list

Note

Your Git username and email appear in commit history. Use the identity associated with your development workflow.

Troubleshooting

Node.js installation failed (Windows)

If the installer fails: run it as Administrator, temporarily disable antivirus software, and verify that sufficient disk space is available.

npm command not found

• Windows — verify that the Node.js installation directory has been added to your system PATH.

• macOS / Linux — restart your terminal or reload your shell configuration:

  source ~/.zshrc   # or ~/.bashrc

Git displays incorrect characters

If Git shows non-English filenames incorrectly:

git config --global core.quotepath false

Next steps

Once Node.js and Git are installed, continue to an integration guide:

Claude Code SetupConfigure Claude Code to use ApexOne.