Theo 文档

什么是 Theo？

认识 Theo——一个有个性的 AI 编排引擎。意图分类、多引擎路由、技能和工具执行，全部在一次 API 调用中完成。诞生于木星，为开发者而生。

开始使用

获取你的 API 密钥

注册并在 30 秒内创建一个 API 密钥。

第一次补全请求

使用 curl 发起你的第一次 API 调用。

安装 SDK

为 TypeScript 项目安装 @hitheo/sdk。

你好，世界

用 5 分钟构建一个可运行的示例。

Explore

API 参考总览

覆盖所有端点的 REST API 文档。

安装与设置

TypeScript SDK 的方法与类型。

什么是技能？

构建并发布领域专业知识包。

构建 E.V.I.

通过自定义角色将 Theo 嵌入你的产品。

IDE 集成

在 Cursor、Claude Code、Warp 等工具中使用 Theo。

MCP 服务器概览

@hitheo/mcp 服务器，及其 8 个工具和 3 个资源。

CLI 概览

theo init、status、complete、skill publish。

Set Up in Your IDE

First, set your API key as an environment variable:

export THEO_API_KEY=theo_sk_...

Then pick your IDE:

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "theo": {
      "command": "npx",
      "args": ["-y", "@hitheo/mcp"],
      "env": {
        "THEO_API_KEY": "${env:THEO_API_KEY}"
      }
    }
  }
}

Or run:

theo mcp install --ide cursor

Run this in your terminal:

claude mcp add theo npx -y @hitheo/mcp

Or run:

theo mcp install --ide claude-code

Add to .warp/mcp.json in your project root:

{
  "mcpServers": {
    "theo": {
      "command": "npx",
      "args": ["-y", "@hitheo/mcp"],
      "env": {
        "THEO_API_KEY": "${env:THEO_API_KEY}"
      }
    }
  }
}

Or run:

theo mcp install --ide warp

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "theo": {
      "command": "npx",
      "args": ["-y", "@hitheo/mcp"],
      "env": {
        "THEO_API_KEY": "${env:THEO_API_KEY}"
      }
    }
  }
}

Or run:

theo mcp install --ide windsurf

Add to .vscode/mcp.json in your project root:

{
  "mcpServers": {
    "theo": {
      "command": "npx",
      "args": ["-y", "@hitheo/mcp"],
      "env": {
        "THEO_API_KEY": "${env:THEO_API_KEY}"
      }
    }
  }
}

Or run:

theo mcp install --ide vscode

Auto-detect and configure all installed IDEs at once:

npm install -g @hitheo/sdk
theo init

This detects Cursor, Claude Code, Warp, Windsurf, and VS Code, writes the correct config for each, and creates a theo.config.json for project-level settings.

Restart your IDE after adding the config.

入门

快速开始

核心概念

故障排查

技能

指南

MCP 服务器

Playground

控制台

安全与合规

更新日志

什么是 Theo？

开始使用

获取你的 API 密钥

第一次补全请求

安装 SDK

你好，世界

Explore

API 参考总览

安装与设置

什么是技能？

构建 E.V.I.

IDE 集成

MCP 服务器概览

CLI 概览

Set Up in Your IDE

什么是 Theo？

​开始使用

获取你的 API 密钥

第一次补全请求

安装 SDK

你好，世界

​Explore

API 参考总览

安装与设置

什么是技能？

构建 E.V.I.

IDE 集成

MCP 服务器概览

CLI 概览

​Set Up in Your IDE

开始使用

Explore

Set Up in Your IDE