工具对接教程

Alaya Code 兼容 OpenAI API，可直接对接主流 AI 编程工具。以下是各工具的配置方法。

⚡ 推荐使用一键配置工具自动完成设置：

npx @alayacode/coding-helper

了解详情 →

OpenClaw 配置

OpenClaw 是一款开源的个人 AI Agent，可通过自然语言指令执行文件整理、代码运行、邮件发送等任务，相当于一个 7×24 小时在线的 AI 数字员工。九章云极提供自研的 OpenClaw 产品，可与 CodingPlan 直接对接，使用更稳定、更便捷。

立即开通 →

步骤 1：打开 OpenClaw 的部署环境中的配置文件

一般为 ~/.openclaw/openclaw.json。

步骤 2：配置 JSON

在 OpenClaw 设置中配置以下 JSON（替换 API Key 为你自己的）：

{
  ......
  "models": {
    "providers": {
      "alayacode": {
        "baseUrl": "https://codingplan.alayanew.com/v1",
        "apiKey": "sk-your-api-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "minimax-m2.5",
            "name": "minimax-m2.5",
            "reasoning": true,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 16384,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "alayacode/minimax-m2.5"
      }
    },
    ......
  }
}

步骤 3：开始使用 配置完成后，即可在云端环境中使用 AI 编程助手功能。

步骤 4：验证配置

为了确保配置正确，可以通过以下方式验证 API 连接：

检查 API Key 是否正确填写在配置文件中
确认 baseUrl 指向正确的服务地址
在 OpenClaw 中发送一个简单的测试请求，验证是否能正常响应
如果出现连接错误，请检查网络连接和防火墙设置

提示

OpenClaw 支持 minimax-m2.5、glm-5、minimax-m2.1、glm-5.1 等多种模型，可根据需求选择。

Claude Code 配置

Claude Code 是 Anthropic 的命令行 AI 助手，支持自定义 API 端点。

步骤 1：创建配置目录

~ 代表用户主目录。如果 .claude 目录不存在，需要先行创建。

mkdir -p ~/.claude

步骤 2：编辑配置文件

创建并打开配置文件 ~/.claude/settings.json。

步骤 3：写入配置内容

将以下内容写入配置文件，将 sk-your-api-key 替换为你的 API Key。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://codingplan.alayanew.com/anthropic",
    "ANTHROPIC_MODEL": "minimax-m2.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY": "3"
  }
}

步骤 4：启动 Claude Code

保存配置文件后，直接在终端启动 Claude Code 即可。

claude

注意

Claude Code 使用 Anthropic API 格式（x-api-key），Alaya Code 已完全兼容此格式。

VSCode + Cline 配置

Cline 是 VSCode 中流行的 AI 编程扩展，支持自定义 OpenAI/Anthropic 兼容端点。

步骤 1：安装 Cline

在 VSCode 扩展商店中搜索 "Cline" 并安装。

步骤 2：打开设置

点击 VSCode 侧边栏的 Cline 图标，点击齿轮图标打开设置。

步骤 3：配置 API

选择 "OpenAI Compatible" 作为 Provider，填入以下信息：

Base URL：https://codingplan.alayanew.com/v1
API Key：你的 Alaya Code API Key
Model ID：minimax-m2.5（或其他支持的模型）

步骤 4：验证

在 Cline 面板中输入任意问题，确认能正常获取响应。

OpenCode 配置

OpenCode 是一款开源的终端 AI 编程助手，支持自定义 API 端点。

配置文件

编辑 OpenCode 配置文件 ~/.config/opencode/opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "alayacode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Alaya Code",
      "options": {
        "baseURL": "https://codingplan.alayanew.com/v1",
        "apiKey": "sk-your-api-key"
      },
      "models": {
        "minimax-m2.5": {
          "name": "Minimax-M2.5",
          "limit": { "context": 196608, "output": 65536 }
        },
        "glm-5": {
          "name": "GLM-5",
          "limit": { "context": 202752, "output": 128000 }
        },
        "minimax-m2.1": {
          "name": "Minimax-M2.1",
          "limit": { "context": 204800, "output": 32000 }
        }
      }
    }
  }
}

启动 OpenCode

使用指定 provider 和模型启动：

opencode -m alayacode/minimax-m2.5

通用提示

所有支持 OpenAI API 的工具都可以通过修改 Base URL 来对接 Alaya Code。
如果工具只支持 OPENAI_API_KEY 环境变量，直接将 Alaya Code 的 Key 设为该环境变量即可。
某些工具可能需要手动指定模型名称。请确保使用 Alaya Code 支持的模型 ID。
如果遇到连接问题，请检查 API Base URL 是否以 /v1 结尾（部分工具需要，部分不需要）。