跳到主要内容

使用 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

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

接入 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