微云API使用指南

站点信息卡

第一章 准备工作

1.1 注册账号

1.2 充值与订阅

注册完成并登录账号后，在左侧导航栏找到「充值 / 订阅」或类似入口。 站点可能提供充值模式、订阅模式，具体以后台实际显示为准。

1.3 兑换码兑换（可选）

如果你手上有兑换码，例如活动赠送、管理员发放、经销商发放， 可以在「充值 / 订阅」页面找到「兑换码」入口。 输入兑换码后点击兑换即可。

第二章 创建 API Key：所有客户端通用

2.1 进入 API Key 页面

2.2 创建新密钥

2.3 一键查看接入配置

密钥创建成功后，如果页面提供「使用密钥」「接入配置」「查看配置」等按钮， 可以点击查看 Codex、Claude Code、Open Code 等客户端的现成配置。 按提示复制粘贴即可。

第三章 客户端接入：按客户端分

3.1 Codex 系列：CLI / VSCode 插件 / APP

适用范围：Codex CLI、Codex VSCode 插件、Codex APP。 三者通常共用同一份配置。

3.1.1 通用：定位 Codex 配置目录

3.1.2 修改 config.toml 与 auth.json

在本站创建 API Key 后，分别复制以下配置到对应文件中。

config.toml 文件位置

config.toml 示例

model = "gpt-5.5"
model_provider = "MicroCloudAPI"
model_reasoning_effort = "xhigh"

[model_providers.MicroCloudAPI]
name = "MicroCloudAPI"
base_url = "https://api.wei-yun.org/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json 文件位置

auth.json 示例

{
  "OPENAI_API_KEY": "填写你的 API 密钥"
}

3.1.3 验证

3.2 Claude Code 系列：CLI / VSCode 插件

适用范围：Claude Code CLI、VSCode Claude 插件。

3.2.1 通用：定位 Claude 配置目录

3.2.2 配置环境变量

配置环境变量和修改 settings.json 二选一即可。 更推荐使用 3.2.3 的 settings.json 方式。

Windows

控制面板 → 系统 → 高级系统设置 → 环境变量 → 新建用户变量。 也可以使用 PowerShell：

setx ANTHROPIC_BASE_URL "https://api.wei-yun.org"
setx ANTHROPIC_AUTH_TOKEN "填写你的 API 密钥"

macOS

在 ~/.zshrc 末尾追加：

export ANTHROPIC_BASE_URL="https://api.wei-yun.org"
export ANTHROPIC_AUTH_TOKEN="填写你的 API 密钥"

保存后执行：

source ~/.zshrc

Linux

在 ~/.bashrc 或 ~/.zshrc 末尾追加：

export ANTHROPIC_BASE_URL="https://api.wei-yun.org"
export ANTHROPIC_AUTH_TOKEN="填写你的 API 密钥"

然后执行：

source ~/.bashrc

3.2.3 修改 settings.json，建议

进入 3.2.1 表中对应的 .claude 目录， 编辑或新建 settings.json。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wei-yun.org",
    "ANTHROPIC_AUTH_TOKEN": "填写你的 API 密钥"
  },
  "model": "claude-opus-4-8",
  "modelOverrides": {
    "claude-opus-4-8[1m]": "claude-opus-4-8"
  }
}

VSCode 插件需要代理时

如果你的网络必须通过本地代理访问本站，建议把代理也写进 settings.json。 VSCode 启动的 Claude Code 子进程不一定会继承你终端里的代理环境变量。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.wei-yun.org",
    "ANTHROPIC_AUTH_TOKEN": "填写你的 API 密钥",
    "HTTP_PROXY": "http://127.0.0.1:10808",
    "HTTPS_PROXY": "http://127.0.0.1:10808",
    "ALL_PROXY": "http://127.0.0.1:10808",
    "NO_PROXY": "localhost,127.0.0.1"
  },
  "model": "claude-opus-4-8",
  "modelOverrides": {
    "claude-opus-4-8[1m]": "claude-opus-4-8"
  }
}

3.2.4 验证

打开新的终端窗口，输入 claude。 能正常进入交互即成功。

3.3 Open Code

适用范围：Open Code CLI。

3.3.1 通用：定位 Open Code 配置目录

3.3.2 配置 Provider 与 API Key

Open Code 支持两种接入方式，任选其一。

方式 A：写入 opencode.json，推荐，永久生效

打开 3.3.1 表中对应的 opencode.json，写入以下内容：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "MicroCloudAPI": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "MicroCloudAPI",
      "options": {
        "baseURL": "https://api.wei-yun.org/v1",
        "apiKey": "填写你的 API 密钥"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}

方式 B：客户端内 /connect 命令，适合临时切换

启动 Open Code 后，在交互界面输入：

/connect

按提示填入：
baseURL： https://api.wei-yun.org/v1
apiKey： 你的 sk-xxxx

此方式无需手动编辑 JSON，适合多账号或临时测试。

3.3.3 验证

任意终端输入 opencode 启动客户端， 发起一次对话测试，能正常返回响应即成功。

3.4 Open Claw

Open Claw 支持两种部署方式：腾讯云在线配置和本地配置。 新手推荐使用腾讯云在线配置。

3.4.1 腾讯云在线配置

适用场景：你已经在腾讯云开通了「龙虾服务器」， 希望直接通过云端面板接入。

{
  "provider": "MicroCloudAPI",
  "base_url": "https://api.wei-yun.org/v1",
  "api": "openai-completions",
  "api_key": "填写你的 API 密钥",
  "model": {
    "id": "gpt-5.5",
    "name": "GPT-5.5"
  }
}

3.4.2 本地配置：Windows / macOS / Linux

定位本地配置目录

修改 openclaw.json

进入上述目录，编辑或新建 openclaw.json，写入：

{
  "baseUrl": "https://api.wei-yun.org/v1",
  "api": "openai-responses",
  "apiKey": "填写你的 API 密钥"
}

第四章 验证与排错

总结

不同客户端的核心配置略有区别：
OpenAI 兼容客户端 Base URL = https://api.wei-yun.org/v1
Claude Code ANTHROPIC_BASE_URL = https://api.wei-yun.org
API Key = 你自己创建的 sk-xxxx
Model = 本站支持的模型名称