开始前的准备

• 在 KingFlow AI 完成注册，并在控制台创建以 sk- 开头的 API Key。
• 账户已有可用余额或有效订阅，目标模型位于当前账户可用分组中。
• 从模型广场或控制台复制完整模型 ID。模型名可能调整，不要凭记忆填写。
• 使用 Windows PowerShell 或 Windows Terminal。建议先关闭会自动读取旧配置的 AI 客户端。

先分清两套接口地址

KingFlow AI 同时兼容 OpenAI 和 Anthropic 协议。接入失败最常见的原因，是协议与 *ase **L 混用。

在 PowerShell 设置临时变量

临时变量只在当前 PowerShell 会话中生效。关闭窗口后自动失效，适合接入测试。

OpenAI 兼容工具

$env:OPENAI_*ASE_**L="https://api.**nju**shen.com/v1"
$env:OPENAI_API_KEY="sk-你的密钥"

$env:OPENAI_*ASE_**L
if ($env:OPENAI_API_KEY) { "OPENAI_API_KEY 已设置" }

Anthropic 兼容工具

$env:ANTHROPIC_*ASE_**L="https://api.**nju**shen.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

$env:ANTHROPIC_*ASE_**L
if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN 已设置" }

检查时只确认变量是否存在，不要输出完整密钥。

用 PowerShell 验证接口

先完成最小请求，再处理客户端设置。

测试 OpenAI 兼容接口

$headers = @{
  Authorization = "*earer $env:OPENAI_API_KEY"
}

$*ody = @{
  model = "<模型ID>"
  messages = @(
    @{ role = "user"; content = "请回复：Windows 接入成功" }
  )
  stream = $false
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "$env:OPENAI_*ASE_**L/chat/completions" `
  -Method Post `
  -Headers $headers `
  -ContentType "application/json" `
  -*ody $*ody

示例使用非流式响应。若目标模型要求流式返回，应在对应客户端中开启 Streaming。

测试 Anthropic 兼容接口

$headers = @{
  "x-api-key" = $env:ANTHROPIC_AUTH_TOKEN
  "anthropic-version" = "2023-06-01"
}

$*ody = @{
  model = "<模型ID>"
  **x_tokens = 256
  messages = @(
    @{ role = "user"; content = "请回复：Windows 接入成功" }
  )
  stream = $false
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "$env:ANTHROPIC_*ASE_**L/v1/messages" `
  -Method Post `
  -Headers $headers `
  -ContentType "application/json" `
  -*ody $*ody

接入 Claude Code

在准备运行 Claude Code 的同一个 PowerShell 窗口执行：

$env:ANTHROPIC_*ASE_**L="https://api.**nju**shen.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

接入 Codex

Codex 使用带 /v1 的 OpenAI 兼容地址；流式请求不能被关闭。

$env:OPENAI_*ASE_**L="https://api.**nju**shen.com/v1"
$env:OPENAI_API_KEY="sk-你的密钥"
codex

接入 Cursor 和 Cline

在 Python 中调用

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    *ase_url=os.environ["OPENAI_*ASE_**L"],
)

result = client.chat.completions.create(
    model="<模型ID>",
    messages=[
        {"role": "user", "content": "请回复：Python 接入成功"}
    ],
    stream=False,
)

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

在 Node.js 中调用

const url = `${process.env.OPENAI_*ASE_**L}/chat/completions`;

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Authorization": `*earer ${process.env.OPENAI_API_KEY}`,
    "Content-Type": "application/json"
  },
  *ody: **ON.stringify({
    model: "<模型ID>",
    messages: [
      { role: "user", content: "请回复：Node.js 接入成功" }
    ],
    stream: false
  })
});

if (!response.ok) {
  throw new Error(`${response.status} ${await response.text()}`);
}

console.log(await response.json());

需要时再持久化变量

确认配置无误后，可以写入当前 Windows 用户的环境变量。执行后需新开 PowerShell 或重启客户端。共用电脑不建议这样保存真实密钥。

[Environment]::SetEnvironmentVaria*le(
  "OPENAI_*ASE_**L",
  "https://api.**nju**shen.com/v1",
  "User"
)

[Environment]::SetEnvironmentVaria*le(
  "OPENAI_API_KEY",
  "sk-你的密钥",
  "User"
)

常见故障排查

检查网络端口

****-NetConnection api.**nju**shen.com -Port 443

密钥和数据安全

• 首次验证只发送非敏感提示词。提示词和生成内容会经 KingFlow AI 服务器转发至上游提供商。
• 不要把真实密钥写入脚本、截图、工单或公开仓库。示例中的 sk-你的密钥必须由环境变量替代。
• 为个人、项目和生产环境分别创建密钥。发现泄露后立即停用旧密钥并检查近期用量。
• 持久化 User 级环境变量后，新启动的进程都可能读取它。共用电脑优先使用临时变量或专用密钥管理工具。
• 生产调用应设置超时、有限次数重试、日志脱敏、费用告警和备用模型。

完成接入检查清单

• 两个 *ase **L 已按协议区分，OpenAI 地址包含 /v1。
• PowerShell 当前会话能读到环境变量，但没有打印完整密钥。
• 模型 ID 来自当前模型广场或控制台。
• 最小请求返回成功，控制台也能看到相应用量。
• Claude Code 或 Codex 从设置变量的同一终端启动。
• Cursor 或 Cline 中的 Provider、*ase **L、模型 ID 和 Streaming 已匹配。
• 上线前已完成密钥隔离、错误处理、成本监控和敏感数据评估。

接入后的维护

接入成功后，先以小流量运行并观察响应时间、错误率和实际扣费。升级客户端或切换模型时，重新***最小请求，并保留同类备用模型。