Claude Code 接入指南

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

系统要求

所有平台均需要：

• Node.js 18+

• 网络连接

1. 安装 Claude Code

macOS

1. 安装或更新 Node.js（v18.0 或更高版本）。

2. 在终端中执行以下命令安装 Claude Code。

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

3. 验证安装结果。输出版本号即表示安装成功。

   claude --version

Windows

1. 在 Windows 上使用 Claude Code，需先安装 WSL 或 Git for Windows。

2. 在 WSL 或 Git Bash 中执行以下命令安装 Claude Code。

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

3. 验证安装结果。输出版本号即表示安装成功。

   claude --version

详情参见 Claude Code 官方文档的 Windows 安装教程 。

Linux

1. 安装或更新 Node.js（v18.0 或更高版本）。

2. 在终端中执行以下命令安装 Claude Code。

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

3. 验证安装结果。输出版本号即表示安装成功。

   claude --version

2. 配置 模型服务平台 API

2.1 获取 API Key

访问 模型服务平台控制台 获取您的 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 地址。

配置参数说明：

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 并安装。

   

2. 重启 VS Code，点击右上角图标进入 Claude Code。

3. 在对话框中输入 /，选择 General config，在 Selected Model 中设置模型。

JetBrains

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

2. 重启 IDE，点击右上角图标即可使用。

接入 Claude Code 桌面版

1. 从 Claude 下载页安装 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，配置才会生效。