# Claude Code Integration Guide

> You can now use the Claude series models through the [UModelverse platform](https://console.scloudsg.com/modelverse/model-center).

## System Requirements

| Platform | Requirements                                    |
| -------- | ------------------------------------------------ |
| Windows  | Windows 10 or Windows 11                         |
| macOS    | macOS 10.15 (Catalina) or later                  |
| Linux    | Ubuntu 18.04+, CentOS 7+, Debian 9+              |

All platforms require:
- Node.js 18+
- Network connection

## 1. Install Node.js

Ensure you have Node.js 18+ installed. Refer to the [Node.js official website](https://nodejs.org/en/download).

Verify installation:
```bash
node --version
npm --version
```

> **Tip:** It is recommended to use the LTS (Long Term Support) version for optimal stability.

## 2. Install Claude Code CLI

Open Terminal/Command Prompt and execute the following command:

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

Verify installation:
```bash
claude --version
```

> **Note:** If Windows users encounter permission issues, ensure you run the Command Prompt as administrator.

## 3. Configure UModelverse API

### 3.1 Obtain API Key

Visit the [UModelverse Console](https://console.scloudsg.com/modelverse/api) to obtain your API key.

### 3.2 Configure Environment Variables

> **Important Note:** Replace `ANTHROPIC_AUTH_TOKEN` below with your actual API Key obtained from the UModelverse platform!

> **⚠️ Note:** Due to compatibility issues with certain experimental features, it is advised to disable these features using the `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` parameter to ensure stable operation.

<!-- tabs:start -->
#### **Windows**

Configuration location: `%USERPROFILE%\.claude\settings.json`

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-umodelverse-api-key",
    "ANTHROPIC_BASE_URL": "https://api.umodelverse.ai",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

#### **macOS**

Configuration location: `~/.claude/settings.json`

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-umodelverse-api-key",
    "ANTHROPIC_BASE_URL": "https://api.umodelverse.ai",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

#### **Linux**

Configuration location: `~/.claude/settings.json`

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-umodelverse-api-key",
    "ANTHROPIC_BASE_URL": "https://api.umodelverse.ai",
    "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```
<!-- tabs:end -->

**Configuration Parameter Explanation:**

| Parameter                               | Description                                     |
| --------------------------------------- | ----------------------------------------------- |
| `ANTHROPIC_MODEL`                       | Specifies the default model to be used          |
| `ANTHROPIC_DEFAULT_*_MODEL`             | Directs Haiku, Sonnet models to platform models |
| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`| Disables experimental features to avoid issues  |

> **Note:** Configuration files are safer and easier to manage, and require restarting Claude Code to take effect.

## 4. Start Claude Code

After configuration, navigate to the project directory:

```bash
cd your-project-folder
```

Then, run the command to start:

```bash
claude
```

Upon first launch, you need to perform some initial setup:

1. Choose your preferred theme (enter)
2. Acknowledge the safety notice (enter)
3. Use default Terminal configuration (enter)
4. Trust the workspace (enter)
5. Start coding! 🚀