Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Welcome to Theo Docs — the AI orchestration API.
为 TypeScript 和 Node.js 项目配置 @hitheo/sdk。
npm install @hitheo/sdk
yarn add @hitheo/sdk
pnpm add @hitheo/sdk
fetch。
import { Theo } from "@hitheo/sdk";
const theo = new Theo({
apiKey: process.env.THEO_API_KEY!,
// 可选：
// baseUrl: "https://www.hitheo.ai", // 默认值（规范的 `www` 主机）
// timeoutMs: 30_000, // 默认值
// maxRetries: 2, // 默认值 — 在 429/5xx 时重试
});
| 选项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
apiKey | string | 必填 | 你的 theo_sk_... API 密钥 |
baseUrl | string | https://www.hitheo.ai | API 基础 URL（请始终指向 www —— 顶级域名会重定向，且部分 HTTP 客户端在 3xx 跳转时会剥离 Authorization 头） |
timeoutMs | number | 30000 | 请求超时时间（毫秒） |
maxRetries | number | 2 | 在 429/5xx 错误时的最大重试次数 |
Retry-After 响应头npm install -g @hitheo/sdk
theo init # 在项目中配置 Theo
theo status # 检查连接与健康状态（同时探测 apex 和 www）
theo verify # 机器可读的 JSON 诊断结果（适合 CI 使用）
theo complete "What is quantum computing?"
export THEO_API_KEY=theo_sk_...
.cursor/mcp.json in your project root:{
"mcpServers": {
"theo": {
"command": "npx",
"args": ["-y", "@hitheo/mcp"],
"env": {
"THEO_API_KEY": "${env:THEO_API_KEY}"
}
}
}
}
theo mcp install --ide cursor
claude mcp add theo npx -y @hitheo/mcp
theo mcp install --ide claude-code
.warp/mcp.json in your project root:{
"mcpServers": {
"theo": {
"command": "npx",
"args": ["-y", "@hitheo/mcp"],
"env": {
"THEO_API_KEY": "${env:THEO_API_KEY}"
}
}
}
}
theo mcp install --ide warp
~/.codeium/windsurf/mcp_config.json:{
"mcpServers": {
"theo": {
"command": "npx",
"args": ["-y", "@hitheo/mcp"],
"env": {
"THEO_API_KEY": "${env:THEO_API_KEY}"
}
}
}
}
theo mcp install --ide windsurf
.vscode/mcp.json in your project root:{
"mcpServers": {
"theo": {
"command": "npx",
"args": ["-y", "@hitheo/mcp"],
"env": {
"THEO_API_KEY": "${env:THEO_API_KEY}"
}
}
}
}
theo mcp install --ide vscode
npm install -g @hitheo/sdk
theo init
theo.config.json for project-level settings.此页面对您有帮助吗？