常用客户端接入配置大全

将 MagicCore Fuel 接入各类常见编程工具、桌面客户端与应用生态。

---

核心参数速查

在任何支持自定义 OpenAI / Anthropic 代理的客户端中，通用配置核心如下：

配置项	推荐填法	注意事项
OpenAI API Base URL	https://fuel.magiccoreai.com/v1	部分客户端要求末尾带 /v1，部分要求不带，参见下方具体工具说明
Anthropic API Base URL	https://fuel.magiccoreai.com	通常不要加 /v1，SDK 会自动补全 /v1/messages
API Key	sk-...	在 Fuel 控制台创建的对应分组密钥

---

1. 编程与 IDE 插件

Cursor

Cursor 是一款极受欢迎的 AI 编程 IDE，原生支持自定义 OpenAI API。

1. 打开 Cursor，点击右上角设置图标（Settings ➔ Features ➔ Model）；
2. 展开 OpenAI API Key 选项：
   • 勾选打开 Override OpenAI Base URL；
   • 填入地址：https://fuel.magiccoreai.com/v1；
   • 填入密钥：您的 Fuel API Key（推荐使用 GPT稳定池 或 Kiro按量计费 分组）；
3. 点击 Verify 验证连通性；
4. 在下方 Models 列表中添加自定义模型名，例如：
   • claude-opus-5
   • claude-sonnet-5
   • deepseek-v4-pro
   • gpt-5.6-terra

---

Cline / Roo Code (VS Code 插件)

Cline 是 VS Code 内非常强大的自主编程智能体插件。

• 推荐方式一：使用 Anthropic 协议接入 Claude

  • API Provider：选择 Anthropic 或 Claude
  • Base URL：https://fuel.magiccoreai.com
  • API Key：填入绑定 Kiro按量计费 分组的 Key
  • Model ID：输入 claude-sonnet-5 或 claude-opus-5

• 推荐方式二：使用 OpenAI 兼容协议接入 DeepSeek / GPT

  • API Provider：选择 OpenAI Compatible
  • Base URL：https://fuel.magiccoreai.com/v1
  • API Key：填入绑定 DeepSeek按量计费 或 GPT稳定池 的 Key
  • Model ID：输入 deepseek-v4-pro 或 gpt-5.6-terra

---

Claude Code (Anthropic 官方终端智能体)

Claude Code 是 Anthropic 官方推出的命令行编程工具。Fuel 提供专属的 ClaudeMax 分组提供满血接入。

1. 在 Fuel 控制台创建一把绑定 ClaudeMax 分组的 API Key；
2. 在终端配置环境变量并启动：

macOS / Linux (Bash / Zsh):

export ANTHROPIC_BASE_URL="https://fuel.magiccoreai.com"
export ANTHROPIC_API_KEY="sk-你的ClaudeMax专属Key"
export ANTHROPIC_MODEL="claude-opus-4-7"

# 启动 Claude Code
claude

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL = "https://fuel.magiccoreai.com"
$env:ANTHROPIC_API_KEY = "sk-你的ClaudeMax专属Key"
$env:ANTHROPIC_MODEL = "claude-opus-4-7"

# 启动 Claude Code
claude

注意：ClaudeMax 具有客户端特征校验，仅接受 Claude Code 官方终端发起调用；请勿将此 Key 用于 Cursor 或其他客户端。

---

2. 桌面与 Web 对话客户端

Cherry Studio

Cherry Studio 是一款界面优雅、功能强大的开源多模型桌面客户端。

1. 进入 设置 ➔ 模型服务 ➔ 添加或选择 OpenAI（或直接添加自定义提供商）；
2. API 域名（Base URL）：填入 https://fuel.magiccoreai.com/v1；
3. API 密钥：填入您的 Fuel API Key；
4. 点击“管理模型”，添加您所购买分组的模型名（如 deepseek-v4-pro、kimi-k3、gpt-5.5）；
5. 点击“检查”，提示连接成功即可开始对话。

---

NextChat (ChatGPT-Next-Web)

1. 点击界面左下角设置齿轮；
2. 接口地址：填入 https://fuel.magiccoreai.com（NextChat 会自动在末尾追加 /v1）；
3. API Key：填入您的 Fuel API Key；
4. 自定义模型：在自定义模型列表末尾添加 +deepseek-v4-pro,+claude-sonnet-5,+gpt-5.6-terra 并勾选启用。

---

Chatbox

1. 打开 Chatbox 设置 ➔ 模型提供方 选择 OpenAI API；
2. API 密钥：填入 Fuel API Key；
3. API 代理地址：填入 https://fuel.magiccoreai.com/v1；
4. 模型：输入自定义模型名称（如 deepseek-v4-pro 或 gpt-5.5）；
5. 保存即可畅享对话与代码预览。

---

3. 浏览器与生活生产力生态

沉浸式翻译 (Immersive Translate)

1. 打开沉浸式翻译扩展设置 ➔ 翻译服务；
2. 选择 OpenAI 或 DeepSeek 自定义服务：
   • 自定义接口地址：https://fuel.magiccoreai.com/v1/chat/completions
   • API 密钥：填入绑定 DeepSeek按量计费 或 GPT稳定池 的 Key
   • 模型：推荐 deepseek-v4-flash 或 gpt-5.4-mini（极速、低廉且翻译质量高）

---

4. 开发者代码 SDK 接入 (Python / Node.js)

Python (OpenAI 官方库)

from openai import OpenAI

client = OpenAI(
    base_url="https://fuel.magiccoreai.com/v1",
    api_key="sk-你的Fuel密钥"
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "你是一位资深工程师"},
        {"role": "user", "content": "请写一个 Python 二分查找示例"}
    ],
    temperature=0.7
)

print(response.choices[0].message.content)

Node.js (OpenAI 官方库)

import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://fuel.magiccoreai.com/v1',
  apiKey: 'sk-你的Fuel密钥'
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: 'gpt-5.6-terra',
    messages: [{ role: 'user', content: '介绍一下微服务架构的优缺点' }],
  });

  console.log(completion.choices[0].message.content);
}

main();