Claude Code Installation and Usage Tutorial

Claude Code is a powerful AI programming assistant that lets you collaborate with AI directly in the terminal. This tutorial will guide you through the installation and configuration process.

📋 System Requirements

Node.js version ≥ 18.0

Supported operating systems: macOS, Linux, Windows (WSL)

🚀 Quick Start

1. Install Node.js

💡 Tip: If you already have Node.js 18.0 or higher installed, you can skip this step.

Ubuntu / Debian Users

macOS Users

2. Install Claude Code

Install Claude Code globally with npm:

3. Configure and Start Using

Get the Required Configuration Information

You need to prepare two important configuration items:

Configuration Item	Description	How to Obtain
ANTHROPIC_AUTH_TOKEN	API authentication token	After registering, click `Add Token` on the `API Tokens` page to obtain it (starts with `sk-`)
ANTHROPIC_BASE_URL	API service address	Use `https://sojo-ai.com` (same as the main site address)

📝 Suggested settings when creating a token:
Name: Any name
Quota: Set to unlimited quota
Group: Choose Claude Code exclusive or official Claude 3 and above
Other options: Keep default settings

Start Claude Code

Run in your project directory:

First Run Configuration

After starting, you will see the following configuration steps:

Choose a theme → Choose your preferred theme + press Enter

Security notice → Confirm the security notice + press Enter

Terminal configuration → Use the default configuration + press Enter

Working directory trust → Trust the current directory + press Enter

✨ Congratulations! Now you can start writing code with your AI programming partner!

❓ FAQ

A: This indicates that Claude Code did not detect the environment variables. Please check:

Whether ANTHROPIC_AUTH_TOKEN and ANTHROPIC_BASE_URL are set correctly

Whether the environment variable values are correct (the token starts with sk-)

If a permanent configuration is used, whether the terminal was restarted

Q: Why does it show "offline" status?

A: Claude Code determines network status by connecting to Google. Showing "offline" does not affect normal use; it only indicates that it cannot connect to Google.

Q: Why does Fetch fail when browsing web pages?

A: Before accessing a web page, Claude Code needs to call the Claude service for a security check. You need to:

Maintain a stable international internet connection

Use a global proxy if necessary

Q: Why does the request always show "fetch failed"?

A: This may be caused by the network environment. Solutions:

Try using a proxy tool

Q: How to handle API errors?

A: It may be caused by an unstable forwarding proxy. Suggestions:

Exit Claude Code (Ctrl+C)

Run the claude command again

If the problem persists, please try again later

A: Try clearing this site's cookies, then log in again.

📌 Notes

This site directly connects to the official Claude Code forwarding service

Only supports Claude Code API traffic, not other API calls

Please keep your API token safe to avoid leakage

Claude Code Official Documentation

Node.js Official Website

💡 Tip: If you encounter other problems, please check the official documentation or contact technical support.

Claude Code Installation and Usage Tutorial

📋 System Requirements#

🚀 Quick Start#

1. Install Node.js#

Ubuntu / Debian Users#

macOS Users#

2. Install Claude Code#

3. Configure and Start Using#

Get the Required Configuration Information#

Start Claude Code#

First Run Configuration#

❓ FAQ#

Q: Encountering the "Invalid API Key · Please run /login" error?#

Q: Why does it show "offline" status?#

Q: Why does Fetch fail when browsing web pages?#

Q: Why does the request always show "fetch failed"?#

Q: How to handle API errors?#

Q: Web login error?#

📌 Notes#

🔗 Related Links#