络科坊 API 新手接入文档

本页用于帮助新用户把 Claude Code、Codex CLI、OpenClaw、 OpenAI 兼容 SDK 接入络科坊 AI 网关。你只需要完成三件事：获取 API Key、填对 Base URL、验证请求是否成功。

一句话说明： 络科坊提供稳定的 AI API 网关服务。你可以把原本调用官方 API 的工具改成调用络科坊地址。多数 OpenAI 兼容工具只需要修改 base_url 和 api_key。

最重要的两个地址

Claude Code / Anthropic 格式

Anthropic API Base URL

https://ai.luokefang.top

环境变量：ANTHROPIC_BASE_URL。注意：这里不带 /v1。

Codex CLI / OpenAI 兼容工具

OpenAI API Base URL

https://ai.luokefang.top/v1

环境变量：OPENAI_BASE_URL。注意：这里必须带 /v1。

新手最容易错的地方： Claude Code 地址不带 /v1；Codex、OpenClaw、 OpenAI SDK 地址带 /v1。如果填反，通常会出现 404、Connection refused 或工具无法识别模型。

新手快速开始

按照下面三个步骤完成首次接入。

创建 API Key

进入络科坊控制台，创建并复制你的 API Key。

配置 Base URL

根据使用的客户端选择对应地址，注意是否包含 /v1。

发送测试请求

使用命令行或 SDK 发送一次请求，确认返回内容正常。

获取 API Key

API Key 用于验证身份以及统计接口调用量，请勿将其提交到公开代码仓库。

配置项	说明	示例
`api_key`	络科坊控制台生成的访问密钥	`lkf_xxxxxxxxxxxx`
`base_url`	API 请求的基础地址	`https://ai.luokefang.top/v1`
`model`	要调用的模型名称	`gpt-4o-mini`

Claude Code 配置

Claude Code 使用 Anthropic 兼容接口，请使用不带 /v1 的地址。

export ANTHROPIC_BASE_URL="https://ai.luokefang.top"
export ANTHROPIC_API_KEY="你的络科坊 API Key"

Codex CLI 配置

Codex CLI 使用 OpenAI 兼容接口，请使用包含 /v1 的地址。

export OPENAI_BASE_URL="https://ai.luokefang.top/v1"
export OPENAI_API_KEY="你的络科坊 API Key"

OpenClaw 配置

OpenClaw 可以通过 OpenAI 兼容模式访问络科坊模型服务。

{
  "base_url": "https://ai.luokefang.top/v1",
  "api_key": "你的络科坊 API Key",
  "model": "gpt-4o-mini"
}

项目代码接入

下面以 JavaScript SDK 为例，展示如何配置络科坊 API。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://ai.luokefang.top/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [
    { role: "user", content: "你好，络科坊" }
  ]
});

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

cc-switch 切换工具

如果你经常在官方 API 和络科坊之间切换，可以使用 cc-switch 管理环境变量。这样不需要每次手动修改配置。

安装 cc-switch

npm install -g cc-switch

添加络科坊配置

cc-switch add luokefang \
  --anthropic-url https://ai.luokefang.top \
  --openai-url https://ai.luokefang.top/v1 \
  --key 你的络科坊 API Key

切换到络科坊

cc-switch use luokefang

查看当前配置

cc-switch status

提示： 如果你安装的 cc-switch 版本要求使用其他配置名称，可以将命令中的 luokefang 替换成你自己设置的名称。

Node.js 安装

cc-switch、部分 AI CLI 工具以及 JavaScript SDK 需要使用 Node.js 环境。建议安装 Node.js LTS 长期支持版本。

Windows 安装

访问 Node.js 官网，下载并安装 LTS 版本。

https://nodejs.org/zh-cn/download

macOS 安装

如果已经安装 Homebrew，可以在终端执行：

brew install node

Linux 安装

Ubuntu 用户可以使用以下命令安装 Node.js 和 npm：

sudo apt update
sudo apt install -y nodejs npm

检查 Node.js 是否安装成功

node -v
npm -v

如果能正常显示版本号，例如 v22.x.x 和 10.x.x，说明 Node.js 和 npm 已经安装成功。

安装 cc-switch

npm install -g cc-switch

验证是否成功

可以通过下面的 curl 请求验证 API Key 和接口地址是否配置正确。

curl https://ai.luokefang.top/v1/chat/completions \
  -H "Authorization: Bearer 你的络科坊 API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": "请回复：连接成功"
      }
    ]
  }'

验证成功： 如果接口返回 JSON 数据，并且包含模型回复内容，说明络科坊 API 已经配置成功。

常见错误

错误表现	可能原因	处理方式
`401 Unauthorized`	API Key 无效或未传递	检查 API Key 是否完整，确认请求头格式正确
`404 Not Found`	Base URL 配置错误	确认 OpenAI 地址是否包含 `/v1`
`429 Too Many Requests`	请求频率或额度达到限制	稍后重试，或到控制台查看额度状态
`Connection refused`	地址、端口或网络连接错误	检查网络连接和接口地址是否填写正确
模型不存在	模型名称填写错误	到络科坊控制台查看可用模型名称

安全使用建议

不要公开 API Key

不要把 API Key 发布到 GitHub、公开网页、截图或聊天群中。

优先使用环境变量

建议将 API Key 设置在环境变量中，避免直接写入项目代码。

发现泄露后立即删除

如果 API Key 已经泄露，请立即在控制台删除并重新创建。

FAQ

Claude Code 的地址为什么不带 /v1？

Claude Code 使用 Anthropic 格式接口，配置时使用 https://ai.luokefang.top。

Codex 和 OpenAI SDK 的地址为什么要带 /v1？

Codex CLI、OpenClaw 和 OpenAI SDK 使用 OpenAI 兼容格式接口，配置时使用 https://ai.luokefang.top/v1。

Node.js 需要安装哪个版本？

建议安装 Node.js LTS 长期支持版本。安装完成后，可以通过 node -v 和 npm -v 检查环境。

cc-switch 配置后如何确认已经切换？

执行 cc-switch status 查看当前使用的配置。