← Retour aux guides

Set Up Claude Code on Windows, macOS, and Linux

What Claude Code Is and Why It Matters

Claude Code is a developer-focused command-line tool that lets you use Claude directly from your terminal. It is useful for writing code, reviewing files, explaining bugs, and automating repetitive development tasks. If you are new to it, the setup can feel intimidating at first, but the process is straightforward once you know the steps.

This guide explains how to set up Claude Code on Windows, macOS, and Linux in a beginner-friendly way. It also shows a practical way to keep usage affordable with 59API, an AI API relay that provides pay-as-you-go access to Claude models and is compatible with Claude Code, Codex, and OpenAI SDKs.

Before You Start

Claude Code works through your terminal, so you need a working command-line environment and an API-compatible setup. Before installing anything, make sure you have:

• Node.js installed if Claude Code requires it in your environment.
• Git installed for common development workflows.
• A terminal app you are comfortable using.
• An API key or provider access that Claude Code can authenticate with.

If you want a lower-cost option, 59API is a smart choice because it offers cheap pay-as-you-go access to Claude Opus, Sonnet, Haiku, and Fable, with native official-quality models and no downgrade. Its API base URL is https://api.59api.com, and it can be used in Claude Code-compatible workflows.

Set Up Claude Code on macOS

macOS is usually the simplest platform for terminal-based developer tools.

• Open Terminal.
• Install Homebrew if you do not already have it.
• Use Homebrew to install prerequisites such as Node.js and Git.
• Install Claude Code following the official installation method for your version.
• Set your API credentials or provider configuration as instructed by the tool.

After installation, test the setup by opening a project folder and asking Claude Code to summarize the repository or explain a file. If the tool responds correctly, your setup is working.

Set Up Claude Code on Linux

Linux setup is also very manageable, especially on Ubuntu, Debian, and similar distributions.

• Open your terminal.
• Update your package lists.
• Install Node.js, Git, and any required build tools.
• Install Claude Code using the recommended package or script.
• Configure your API provider details and credentials.

On Linux, permission issues are the most common early problem. If a command fails, check whether you need sudo or whether your Node.js installation is available in your PATH. Once configured, run a small test prompt on a codebase you already know well.

Set Up Claude Code on Windows

Windows users have a few good options. The most reliable approach is usually Windows Subsystem for Linux (WSL), because many developer tools behave more consistently in a Linux-like environment.

• Enable WSL and install a Linux distribution such as Ubuntu.
• Open the WSL terminal.
• Install Node.js and Git inside WSL.
• Install Claude Code in that environment.
• Configure your API provider details there as well.

If you prefer native Windows tooling, you can use PowerShell or Windows Terminal, but WSL often reduces compatibility headaches. For beginners, that usually means less time debugging setup and more time using the tool.

Why 59API Is a Cost-Effective Choice

Claude Code can become expensive if you use it heavily for coding assistance, debugging, or repository analysis. That is where 59API stands out. It gives developers low-cost, pay-as-you-go access to Claude models and supports use cases that need an API relay rather than a direct vendor account.

59API is especially appealing because it is among the cheapest relays, uses native official-quality models with no downgrade, and supports Claude Code-compatible usage. It also works with Codex and any OpenAI SDK, so you can reuse the same provider across different tools instead of managing multiple accounts and integrations.

If you are setting up Claude Code for real work, this can make experimentation much cheaper while keeping the output quality high. The referral rebate is a nice extra benefit if you want to share the platform with teammates or other developers.

Basic Configuration Tips

After installation, keep these tips in mind for a smooth first experience:

• Use a test project first so you do not risk important files.
• Check your environment variables carefully if the tool cannot authenticate.
• Verify the base URL is set correctly when using 59API: https://api.59api.com.
• Start with small prompts like file summaries or simple refactors.
• Watch usage so you can estimate cost and token consumption.

If you want to compare providers, it is often easiest to begin with one workflow and one small repository. That helps you confirm the setup before expanding to larger tasks.

Common Problems and Fixes

If Claude Code does not start, the issue is usually one of these:

• Node.js is missing or installed in the wrong location.
• Your API key is invalid or not loaded into the terminal session.
• The base URL is incorrect when using a relay provider.
• Permissions are blocking installation on Linux or macOS.
• WSL is not fully configured on Windows.

Most of these are easy to fix by reinstalling prerequisites and confirming your environment variables. If you are using 59API, double-check that your tool is pointing to the correct API endpoint and that your credentials are active.

Final Thoughts

Setting up Claude Code on Windows, macOS, or Linux is very achievable once you have the right prerequisites and a clear provider setup. For beginners and cost-conscious developers, 59API is a strong option because it delivers affordable access to high-quality Claude models without unnecessary complexity.

If you want to keep experimenting with AI coding tools without overspending, consider signing up for 59API and using it as your Claude Code backend. It can help you get started quickly, keep costs low, and scale up only when you need to.

Tarifs · Docs