---
title: 工具接入概览
sidebarTitle: 接入概览
description: 在 Cursor、Claude Code 等客户端中使用海宇数科 API
---

# 工具接入概览

海宇数科提供 **OpenAI 兼容** 的 `https://api.haiyushuke.com/v1` 网关。多数支持「自定义 OpenAI Base URL + API Key」的 IDE / 编程助手，均可指向海宇，并在请求中使用控制台 **模型广场** 里的 **国内模型 ID**（如 DeepSeek、智谱 GLM、通义、Kimi、MiniMax 等）。

> 当前平台 **不提供** OpenAI GPT、Anthropic Claude 等海外原厂模型；请勿在文档或客户端中填写 `gpt-*`、`claude-*` 等海外 ID，一律以 [控制台模型广场](https://console.haiyushuke.com/models) 为准。

## 接入三要素

| 项 | 值 |
| --- | --- |
| API Base URL | `https://api.haiyushuke.com/v1` |
| API Key | 控制台 **API Key** 中创建（非登录密码） |
| Model | 模型广场复制的 **模型 ID** |

创建 Key、实名认证与充值说明见 [快速开始](/docs/getting-started)、[API Key 管理](/docs/guides/api_keys)。

## 按工具查看

| 工具 | 文档 | 说明 |
| --- | --- | --- |
| Cursor | [Cursor 接入](/docs/integrations/cursor) | 覆盖 OpenAI Base URL，适合日常编码 |
| Claude Code | [Claude Code 接入](/docs/integrations/claude_code) | CLI 助手，需确认客户端协议与网关兼容 |
| Continue | [Continue 接入](/docs/integrations/continue) | VS Code / JetBrains 插件 |
| Cline | [Cline 接入](/docs/integrations/cline) | VS Code 自主编程扩展 |

## 通用 HTTP / SDK

不通过 IDE 而由业务服务调用时，请阅 [HTTP API](/docs/guides/http_api)、[OpenAI 兼容 SDK](/docs/guides/openai_compatible)。

## 常见问题

- Key 无效、402 余额不足、403 模型未授权：见 [常见问题](/docs/faq)  
- Token 与上下文：见 [核心概念](/docs/concepts/overview)  
