工具对接 · Alaya NeW Cloud Docs

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

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

npx @alayacode/coding-helper

了解详情 →

OpenClaw 配置

OpenClaw 是一款开源的个人AI Agent，可通过自然语言指令执行文件整理、代码运行、邮件发送等任务，相当于一个 7×24 小时在线的 AI 数字员工。您可通过配置OpenClaw的配置文件，对接 Alaya Token的API服务。

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

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

步骤 2：配置 JSON

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

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

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

步骤 4：验证配置

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

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

OpenAI Codex CLI

Codex 默认走 OpenAI Responses API，Alaya Token已原生支持/v1/responses，可直接对接。

步骤 1：配置 ~/.codex/config.toml

新增一个自定义 provider，wire_api设为responses，API Key通过http_headers注入（也可用env_key环境变量）：

# ~/.codex/config.toml
model = "glm-5.2"
model_provider = "alayacode"

[model_providers.alayacode]
name = "Alaya Code"
base_url = "https://token.alayanew.com/v1"
wire_api = "responses"

[model_providers.alayacode.http_headers]
Authorization = "Bearer sk-your-api-key"

步骤 2：启动

# 在项目目录直接运行
codex

Claude Code 配置

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

步骤 1：创建配置目录

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

mkdir -p ~/.claude

步骤 2：编辑配置文件

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

vim ~/.claude/settings.json

步骤 3：写入配置内容

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

{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
        "ANTHROPIC_BASE_URL": "https://token.alayanew.com/anthropic",
        "ANTHROPIC_MODEL": "glm-5.1",
        "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 Token已完全兼容此格式。

OpenCode 配置

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

配置文件

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

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "alayacode": {
      "npm": "@ai-sdk/anthropic",
      "name": "Alaya Code",
      "options": {
        "baseURL": "https://token.alayanew.com/anthropic/v1",
        "apiKey": "sk-your-api-key"
      },
      "models": {
        "glm-5.1": {
          "name": "GLM-5.1",
          "limit": { "context": 200000, "output": 128000 }
        },
        "glm-5.2": {
          "name": "GLM-5.2",
          "limit": { "context": 200000, "output": 128000 }
        },
        "deepseek-v4-flash": {
          "name": "DeepSeek-V4 Flash",
          "limit": { "context": 200000, "output": 32000 }
        }
      }
    }
  }
}

启动 OpenCode

使用指定 provider 和模型启动：

# 使用指定 provider 和模型启动
opencode -m alayacode/glm-5.1

通用提示

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