# 快速入门

让你的 Agent 用上网页搜索、正文读取和带来源引用的研究。

## 1. 检查 API 密钥

接入前，先确认 AREX_API_KEY 中有可用的密钥：

```bash
curl -s -o /dev/null -w "%{http_code}\n" \
  https://api.arex-research.com/v1/research/00000000-0000-4000-8000-000000000000 \
  -H "Authorization: Bearer $AREX_API_KEY"
```

返回 404 表示密钥可用：该请求查询一个不存在的 Run，不会创建任何内容。返回 401 表示密钥缺失或无效。已安装 arex CLI 时，arex doctor 会做同样的检查。

没有可用的密钥时，请用户在 https://www.arex-research.com/platform/console/keys 创建密钥，并在自己的终端中设置 AREX_API_KEY，或运行 arex setup。不要让用户把密钥贴到对话里。

## 2. 接入 AREX

按用户的环境选择一种方式，都使用同一个 API 密钥。

### MCP

适用于支持远程 MCP 服务器的 Agent。命令行 Agent 一条命令即可添加；ZCode、WorkBuddy 等应用在 MCP 设置中粘贴 mcp.json 配置。

#### Codex

```bash
codex mcp add arex --url https://api.arex-research.com/v1/mcp \
  --bearer-token-env-var AREX_API_KEY
```

#### Claude Code

```bash
claude mcp add --transport http arex https://api.arex-research.com/v1/mcp \
  --header "Authorization: Bearer $AREX_API_KEY"
```

#### Kimi Code

```bash
kimi mcp add --transport http arex https://api.arex-research.com/v1/mcp \
  --header "Authorization: Bearer $AREX_API_KEY"
```

#### mcp.json

```json
{
  "mcpServers": {
    "arex": {
      "type": "http",
      "url": "https://api.arex-research.com/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

[MCP 完整说明](/platform/docs/integrations/mcp.md?locale=zh)

### Skill

适用于能执行命令的 Agent。安装 arex CLI 和 arex Skill。

#### Shell

```bash
npm install -g @arex-research/cli
arex setup
arex skill install
```

[Agent Skills 完整说明](/platform/docs/integrations/skills.md?locale=zh)

### SDK

在你自己的 TypeScript 或 Python 代码中调用。

#### TypeScript

```typescript
// npm install @arex-research/ts-sdk
import { Arex } from "@arex-research/ts-sdk";

const arex = new Arex(); // reads AREX_API_KEY
const run = await arex.research.run("How are AI agents evaluated?", { mode: "fast" });
console.log(run.result.answer);
```

#### Python

```python
# pip install arex-python-sdk
from arex import Arex

with Arex() as arex:  # reads AREX_API_KEY
    run = arex.research.run("How are AI agents evaluated?", mode="fast")
    print(run.result.answer)
```

[SDK 完整说明](/platform/docs/integrations/sdk.md?locale=zh)

## 下一步

- [搜索](/platform/docs/reference/search.md?locale=zh): 按查询查找网页。

- [内容](/platform/docs/reference/contents.md?locale=zh): 读取已知 URL 的网页正文。

- [研究](/platform/docs/reference/research.md?locale=zh): 获取带来源引用的答案。

- [文档](/platform/docs/llms.txt?locale=zh)