Astreus

提供商

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

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

支持的提供商

示例显式选择模型；仍受支持的现有默认值保持不变。原生 API 中已停用的模型需要显式指定当前可用的替代模型。

现有 CLI 通过 getModelsByProvider 从已安装的框架获取模型选项。 四个选项仍是 openai、claude、gemini 和 ollama。

OpenAI

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

export OPENAI_API_KEY="${OPENAI_API_KEY:?Set OPENAI_API_KEY in your environment}"
astreus

可显式选择的模型 ID:

  • gpt-6-astra
  • gpt-5.6-sol
  • gpt-5.6-terra
  • gpt-5.6-luna

通过 OpenRouter 使用免费托管模型

使用免费托管模型时，仍保留 ASTREUS_PROVIDER=openai。通过环境变量提供 OpenRouter 密钥并显式选择模型。请求速率限制和端点要求与框架 LLM 指南相同。

export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
export OPENAI_API_KEY="${OPENROUTER_API_KEY:?Set OPENROUTER_API_KEY in your environment}"
ASTREUS_PROVIDER=openai ASTREUS_MODEL=openrouter/free astreus

Anthropic（Claude）

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

export ANTHROPIC_API_KEY="${ANTHROPIC_API_KEY:?Set ANTHROPIC_API_KEY in your environment}"
ASTREUS_PROVIDER=claude ASTREUS_MODEL=claude-sonnet-5 astreus

可显式选择的模型 ID:

  • claude-fable-5-1
  • claude-opus-5
  • claude-sonnet-5
  • claude-haiku-4-5-20251001

Google（Gemini）

使用 Google 的 Gemini 模型。

export GEMINI_API_KEY="${GEMINI_API_KEY:?Set GEMINI_API_KEY in your environment}"
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-5 astreus

会话期间

使用斜杠命令进行切换：

/provider claude
/model claude-sonnet-5

或打开交互式选择器：

/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-5擅长理解代码结构和模式
复杂推理 Agentgpt-4o、claude-sonnet-5最适合多步推理和规划
快速响应 Agentgpt-4o-mini、gemini-pro实时交互的低延迟
重度使用工具的 Agentgpt-4o可靠的函数调用和工具使用
长上下文 Agentclaude-sonnet-5发送大型文档前，请检查所选模型及端点的上下文限制
本地/私有 Agentllama3、codellama数据不离开你的机器
成本敏感 Agentgpt-3.5-turbo、Ollama最小化 API 成本

跨提供商测试 Agent

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

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

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

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

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

最后更新时间:2026年9月13日

本节内容

简介

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

安装

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

上一页
命令
下一页
配置