# Claude Code 接入指南

现在你可以通过 UModelverse 平台使用 Claude 系列模型。

## **系统要求**

| 平台 | 要求 |
| --- | --- |
| Windows | Windows 10 或 Windows 11 |
| macOS | macOS 10.15 (Catalina) 或更高版本 |
| Linux | Ubuntu 18.04+、CentOS 7+、Debian 9+ |

所有平台均需要：

-   Node.js 18+
    
-   网络连接
    

## **1. 安装 Claude Code**

### macOS

1.  安装或更新 [Node.js](https://nodejs.org/en/download/)（v18.0 或更高版本）。
    
2.  在终端中执行以下命令安装 Claude Code。
    
    ```
    npm install -g @anthropic-ai/claude-code
    ```
    
3.  验证安装结果。输出版本号即表示安装成功。
    
    ```
    claude --version
    ```
    

### Windows

1.  在 Windows 上使用 Claude Code，需先安装 WSL 或 [Git for Windows](https://git-scm.com/install/windows)。
    
2.  在 WSL 或 Git Bash 中执行以下命令安装 Claude Code。
    
    ```
    npm install -g @anthropic-ai/claude-code
    ```
    
3.  验证安装结果。输出版本号即表示安装成功。
    
    ```
    claude --version
    ```
    

> 详情参见 Claude Code 官方文档的 [Windows 安装教程](https://docs.anthropic.com/en/docs/claude-code/setup#windows-setup) 。

### Linux

1.  安装或更新 [Node.js](https://nodejs.org/en/download/)（v18.0 或更高版本）。
    
2.  在终端中执行以下命令安装 Claude Code。
    
    ```
    npm install -g @anthropic-ai/claude-code
    ```
    
3.  验证安装结果。输出版本号即表示安装成功。
    
    ```
    claude --version
    ```
    

## **2. 配置 UModelverse API**

### 2.1 获取 API Key

访问 [UModelverse 控制台](https://console.ucloud.cn/modelverse/api) 获取您的 API 密钥。

### 2.2 配置环境变量

> **重要提示：** 请将下方的 `ANTHROPIC_AUTH_TOKEN` 替换为您在 UModelverse 平台获取的实际 API Key！

> ⚠️ **注意：** 由于部分实验性功能存在 API 兼容性问题，建议通过 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` 参数禁用这些功能以确保稳定运行。

新建 `settings.json` 并写入以下配置（各平台文件路径不同）。

#### macOS

文件路径：`~/.claude/settings.json`

```
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-umodelverse-api-key",
    "ANTHROPIC_BASE_URL": "https://api.modelverse.cn",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

#### Windows

文件路径：`C:\Users\<用户名>\.claude\settings.json`

```
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-umodelverse-api-key",
    "ANTHROPIC_BASE_URL": "https://api.modelverse.cn",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

#### Linux

文件路径：`~/.claude/settings.json`

```
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-umodelverse-api-key",
    "ANTHROPIC_BASE_URL": "https://api.modelverse.cn",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

配置保存后，新开一个终端窗口执行 `claude "你好"`。若模型正常返回响应，配置成功。如需进一步确认，在 Claude Code 中执行 `/status`，检查 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN` 是否正确指向 UModelverse 地址。

**配置参数说明：**

| 参数 | 说明 |
| --- | --- |
| `ANTHROPIC_MODEL` | 指定默认使用的模型 |
| `ANTHROPIC_DEFAULT_*_MODEL` | 将 Haiku、Sonnet 等模型统一指向平台支持的模型 |
| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | 禁用实验性功能，避免 API 兼容性问题 |

## **3. 启动 Claude Code**

配置完成后，先进入到工程目录：

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

然后，运行以下命令启动：

```
claude
```

首次启动后需要先进行主题选择等操作：

1.  选择喜欢的主题（回车）
    
2.  确认安全须知（回车）
    
3.  使用默认 Terminal 配置（回车）
    
4.  信任工作目录（回车）
    

完成后即可开始编程！🚀

## **Claude Code IDE 插件**

完成上述 CLI 配置后，在 IDE 中安装 Claude Code 插件，可直接复用 `settings.json` 中的配置。

### VS Code

1.  在扩展市场搜索 `Claude Code for VS Code` 并安装。

    ![Claude Code VS Code 插件](https://cdnv2-cache.udelivrs.com/2026/06/603a340e6f8a23ef14aac0660a7a9440_1781261163287.png)
    
2.  重启 VS Code，点击右上角图标进入 Claude Code。
    
3.  在对话框中输入 `/`，选择 General config，在 Selected Model 中设置模型。
    

### JetBrains

1.  在扩展市场搜索 `Claude Code` 并安装。
    
2.  重启 IDE，点击右上角图标即可使用。
    

## **接入 Claude Code 桌面版**

1.  从 [Claude 下载页](https://claude.ai/download)安装 Claude Code 桌面版。
    
2.  顶部菜单 **Help** → **Troubleshooting** → **Enable Developer Mode**，重启后顶部出现 **Developer** 菜单。
    
3.  **Developer** → **Configure Third-Party Inference**，**Connection** 选 **Gateway**，按下表填写后点击 **Apply locally**：
    
    | **字段** | **填写** |
    | --- | --- |
    | Gateway base URL | `https://api.modelverse.cn` |
    | Gateway API key | UModelverse API Key |
    | Gateway auth scheme | bearer |
    | Model list | Model ID 须为 Anthropic 风格，如 `claude-opus-4-8`；留空则使用默认模型。Display name 仅影响下拉显示。 |
    
4.  在桌面版模型下拉中选择已配置的模型即可使用。
    

## **常见问题**

### 启动 Claude Code 后，界面显示"Unable to connect to Anthropic services. Failed to connect to api.anthropic.com: ERR\_BAD\_REQUEST"

此错误表示 Claude Code 正在尝试连接 Anthropic 官方服务而非 UModelverse。通常是环境变量未正确配置或未生效。按以下步骤排查：

1.  **检查配置。**启动 Claude Code 后执行 `/status` 命令，确认 `ANTHROPIC_BASE_URL` 和 `ANTHROPIC_AUTH_TOKEN` 是否正确指向 UModelverse 地址。输出为空或指向非 UModelverse 地址时，检查 `settings.json` 配置是否正确。
    
2.  **重新打开终端。**修改配置文件后，需要新开一个终端窗口再执行 `claude`，配置才会生效。