Astreus

提供商

Astreus CLI 支持多个 LLM 提供商。在它们之间无缝切换，用不同的模型测试你的 agent，找到最适合你使用场景的方案。 了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

Astreus CLI 支持多个 LLM 提供商。在它们之间无缝切换，用不同的模型测试你的 agent，找到最适合你使用场景的方案。

支持的提供商

OpenAI

默认提供商，可访问 GPT 模型。

export OPENAI_API_KEY=sk-your-api-key
astreus

可用模型：

  • gpt-4o（默认）—— 能力最强
  • gpt-4o-mini —— 快速且高效
  • gpt-4-turbo —— GPT-4 Turbo
  • gpt-4 —— 原始版 GPT-4
  • gpt-3.5-turbo —— 快速且经济

Anthropic（Claude）

访问 Claude 模型以进行细致入微的对话。

export ANTHROPIC_API_KEY=your-api-key
ASTREUS_PROVIDER=claude astreus

可用模型：

  • claude-sonnet-4-20250514（默认）—— Claude Sonnet 4
  • claude-3-5-sonnet-20241022 —— Claude 3.5 Sonnet

Google（Gemini）

使用 Google 的 Gemini 模型。

export GEMINI_API_KEY=your-api-key
ASTREUS_PROVIDER=gemini astreus

可用模型：

  • gemini-pro（默认）—— Gemini Pro
  • gemini-pro-vision —— 支持视觉能力

Ollama（本地模型）

使用 Ollama 在本地运行模型，无需 API 密钥。

# 确保 Ollama 正在运行
ollama serve

# 使用 Ollama 启动 CLI
ASTREUS_PROVIDER=ollama astreus

可用模型：

  • llama3（默认）—— Llama 3
  • llama2 —— Llama 2
  • mistral —— Mistral
  • codellama —— 专注代码的 Llama

切换提供商

启动时

使用环境变量：

ASTREUS_PROVIDER=claude ASTREUS_MODEL=claude-sonnet-4-20250514 astreus

会话期间

使用斜杠命令进行切换：

/provider claude
/model claude-sonnet-4-20250514

或打开交互式选择器：

/provider
/model

提供商配置

自定义端点

用于企业部署或代理：

# 在不同主机上运行的 Ollama
export OLLAMA_HOST=http://192.168.1.100:11434

视觉支持

部分提供商支持视觉（图像）能力：

# 用于视觉的单独 API 密钥（可选）
export OPENAI_VISION_API_KEY=sk-your-vision-key
export ANTHROPIC_VISION_API_KEY=your-vision-key
export GEMINI_VISION_API_KEY=your-vision-key

嵌入支持

用于内存和知识功能：

export OPENAI_EMBEDDING_API_KEY=sk-your-embedding-key
export GEMINI_EMBEDDING_API_KEY=your-embedding-key

面向 Agent 开发的模型选择

根据你正在构建的 agent 类型选择合适的模型：

Agent 类型推荐模型原因
代码分析 Agentclaude-sonnet-4-20250514擅长理解代码结构和模式
复杂推理 Agentgpt-4o、claude-sonnet-4-20250514最适合多步推理和规划
快速响应 Agentgpt-4o-mini、gemini-pro实时交互的低延迟
重度使用工具的 Agentgpt-4o可靠的函数调用和工具使用
长上下文 Agentclaude-sonnet-4-2025051420 万 token 上下文窗口，适合大型文档
本地/私有 Agentllama3、codellama数据不离开你的机器
成本敏感 Agentgpt-3.5-turbo、Ollama最小化 API 成本

跨提供商测试 Agent

在构建 agent 时，用不同的提供商进行测试很有帮助：

# 使用快速、便宜的模型开始开发
/provider openai
/model gpt-4o-mini

# 用顶级模型测试复杂推理
/provider claude
/model claude-sonnet-4-20250514

# 部署前在本地测试
/provider ollama
/model llama3

这种工作流帮助你了解 agent 在不同 LLM 上的表现，并为你的使用场景找到能力、速度和成本之间的最佳平衡。

最后更新时间:2026年7月6日

本节内容

简介

用于使用 Astreus 框架构建 agent 的 AI 驱动开发助手。CLI 帮助你直接在终端中创建、测试和迭代 AI agent —— 并且完全了解 Astreus SDK。 了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

安装

几分钟内即可让 Astreus CLI 运行起来。CLI 是你使用 Astreus 框架构建 agent 的 AI 驱动助手。 了解构建可靠的 Astreus 智能体系统所需的设置模式、API 和实用示例。

上一页
命令
下一页
配置