跳到主要内容

使用 AgentWeave 代理大模型

AgentWeave 支持通过 Proxy LLM 功能代理主流大模型（OpenAI / Claude / Gemini）。配置完成后，你将获得一个统一的 API Key，可用于任何兼容 OpenAI 或 Anthropic 格式的客户端。

创建 Proxy LLM Agent​

  1. 前往 www.agentweave.ai 注册并登录
  2. 点击创建 Agent，选择 Proxy LLM 模版
  3. 上传头像，输入智能体名称
  4. 选择大模型供应商（OpenAI / Claude / Gemini）及相关配置
  5. 点击创建完成

获取 API Key​

  1. 进入已创建的 Agent 详情页
  2. 选择 管理 > Api Key
  3. 点击生成新的 ApiKey
  4. 复制生成的 Key 备用

创建成功后你将获得：

  • API Key：agentweave-xxxxxxxxxxxxxxxx
  • Base URL：https://chat.agentweave.ai/api/v1/chat/proxy/{AgentID}

接入 Claude Code​

安装 Claude Code​

npm install -g @anthropic-ai/claude-code

配置 settings.json​

编辑 ~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json）：

{
    "env": {
        "ANTHROPIC_API_KEY": "your_agentweave_api_key",
        "ANTHROPIC_BASE_URL": "https://chat.agentweave.ai/api/v1/chat/proxy/{AgentID}",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}

启动​

打开新的终端窗口，进入项目目录后执行：

claude

首次运行时按提示授权文件访问权限即可开始使用。

使用你自己的 Claude 订阅（可选）​

默认情况下，Proxy LLM 的调用按平台积分计费。你也可以让 Agent 的所有者连接自己的 Claude Pro / Max 订阅，这样调用将计入该订阅，而不消耗平台积分。

当前仅 Anthropic（Claude） 支持订阅模式，OpenAI 和 Gemini 暂不支持。

1. 在 Agent 上启用订阅模式​

创建或编辑 Proxy LLM Agent 时，在供应商配置里为 Claude（Anthropic）供应商打开**「使用我自己的订阅」**开关，然后保存。

2. 配置 Claude Code​

与上文完全相同的 settings.json（你的 AgentWeave API Key + Base URL），无需额外配置。

3. 首次使用时授权​

在 Claude Code 里随意发一条消息。由于尚未连接订阅，代理会内联返回一个授权链接：

🔐 请先授权你的 Claude 订阅以继续：
https://claude.ai/oauth/authorize?...

授权后页面会显示一段 code，回到这里直接发送（不要带斜杠）：
    claude-auth <粘贴 code>

  1. 在浏览器打开链接，用你的 Claude 账号登录并授权

  2. 回调页面会显示一段一次性 code（格式为 code#state）

  3. 回到终端，用 claude-auth 命令把 code 发回 —— 不要带前导斜杠，否则 Claude Code 会把它当成本地命令（显示 Unknown command），消息发不到代理：

    claude-auth <粘贴完整的 code>

  4. 代理返回「✅ 已连接」。重新发送你最初的消息，即可走订阅调用。

仅 Agent 所有者可授权（订阅按所有者存储）。其他调用者会被提示请所有者去连接。

重新授权​

access token 会自动续期。若订阅授权彻底过期或被撤销，下次调用会再次返回授权提示 —— 重复 claude-auth 这一步即可。

接入 Cursor​

注意：使用自定义 API Key 功能需要 Cursor 付费用户（Pro 及以上）。

在 AgentWeave 创建 Proxy LLM Agent 时，供应商请选择 OpenAI。Cursor 仅支持 OpenAI 兼容的模型，Claude 和 Gemini 模型在此场景下不可用。

  1. 打开 Cursor，进入 Settings > Models
  2. 在 OpenAI API Key 处填入你的 AgentWeave API Key
  3. 展开 Override OpenAI Base URL，填入： 
    https://chat.agentweave.ai/api/v1/chat/proxy/{AgentID}

Cursor 设置

  1. 保存后即可在 Cursor 中使用 AgentWeave 代理的模型

常见问题​

配置未生效​

  1. 关闭所有 Claude Code 窗口
  2. 打开新的命令行窗口重新执行 claude
  3. 检查 JSON 格式是否正确
  4. 若仍未生效，删除配置文件后重新写入

Claude Code v2.1.69 兼容问题​

使用 claude-opus-4-6 时需额外设置（参见 Issue #30926）：

ENABLE_TOOL_SEARCH=0 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 claude