> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aioagi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# 最新：Claude Opus 4.8

> 了解 Claude Opus 4.8 在 AIOAGI 中的定位、适用场景、Token 组核对和 OpenAI 兼容接口调用方法。

`Claude Opus 4.8` 是 Anthropic 在 2026 年 5 月 28 日发布的 Opus 系列更新。官方公告强调，它在编码、智能体任务、推理和专业知识工作中提升了稳定性与协作质量，并继续面向复杂、长流程任务。

AIOAGI 将 Claude、GPT、DeepSeek、Gemini、Qwen 和 Vibe Coding 等模型聚合到统一平台。你可以使用 AIOAGI API Key，通过 OpenAI 兼容接口调用 Claude 系列模型。`Claude Opus 4.8` 的可用模型 ID、价格、上下文长度、限流策略和 Claude Code 支持情况可能变化，请以 **控制台** 和 **开发者指南** 为准。

<Warning>
  上线生产前，请先确认你的 API Key 所属 Token 组支持 `claude-opus-4-8` 或控制台展示的对应别名。不同 Token 组可用模型、额度、缓存策略和计费方式可能不同。
</Warning>

<CardGroup cols={2}>
  <Card title="Anthropic 官方公告" icon="newspaper" href="https://www.anthropic.com/news/claude-opus-4-8">
    查看 Claude Opus 4.8 的发布时间、能力更新、可用性和官方说明。
  </Card>

  <Card title="Claude Code 配置" icon="terminal" href="/ai-tools/claude-code/windows.mdx">
    在 Claude Code 中配置 AIOAGI API Key、接入端点和 Claude 模型。
  </Card>
</CardGroup>

## 适合场景

<CardGroup cols={2}>
  <Card title="复杂代码任务" icon="code">
    适合仓库级代码理解、重构计划、测试补全、代码审查、多服务排障和长流程修复。
  </Card>

  <Card title="智能体工作流" icon="route">
    适合需要分解任务、调用工具、持续验证结果和跨步骤推进的 Agent 场景。
  </Card>

  <Card title="专业知识工作" icon="briefcase">
    适合法律、金融、研究、数据分析、报告生成和需要引用检查的高价值任务。
  </Card>

  <Card title="长会话协作" icon="messages-square">
    适合长文本写作、风格保持、需求澄清、方案评审和中英文高质量表达。
  </Card>
</CardGroup>

如果你的任务只是简单分类、短文本改写或低成本批处理，可以先评估更轻量的 Claude、GPT 或开源模型。`Claude Opus 4.8` 更适合质量优先、上下文复杂、需要模型主动发现问题的业务。

## 能力特点

* **协作判断更强**：官方公告和早期测试反馈都强调，Opus 4.8 在智能体任务中更可靠，更能发现计划中的问题。
* **代码任务更稳**：它更适合 Claude Code、IDE 助手、仓库迁移、跨文件修改和需要测试验证的开发任务。
* **诚实性更好**：官方说明提到，模型更倾向于标出不确定性，减少无依据的进展判断。
* **长流程更适配**：Claude Code 的动态工作流可以让模型规划任务、运行并行子任务并验证输出。AIOAGI 是否开放相关能力，请以控制台和开发者指南为准。
* **努力程度可调**：官方产品提供 effort 控制。高 effort 更适合困难任务和异步长流程，低 effort 更适合快速响应。通过 AIOAGI 调用时，请先确认客户端和接口是否支持对应参数。

<Info>
  Anthropic 官方公告称，`Claude Opus 4.8` 可通过 Claude API 使用 `claude-opus-4-8`。在 AIOAGI 中，模型 ID 或别名可能按 Token 组策略调整。建议先调用 `GET /models` 或在控制台核对后再写入生产配置。
</Info>

## AIOAGI 使用方法

<Steps>
  <Step title="创建 API Key">
    登录 AIOAGI 控制台，在 **令牌** 或 **API Key** 页面创建密钥。为 Claude 生产调用建议单独创建 API Key，方便统计用量和限制额度。
  </Step>

  <Step title="选择 Token 组">
    选择支持 Claude 系列的 Token 组。Claude Code、低成本测试和生产高稳定调用可能适合不同分组，请结合业务优先级选择。
  </Step>

  <Step title="确认模型名称">
    在控制台、开发者指南或 `GET /models` 返回结果中确认 `claude-opus-4-8` 是否可用。如果控制台展示了别名，请优先使用控制台中的名称。
  </Step>

  <Step title="配置 OpenAI 兼容端点">
    在服务端保存 API Key 和 base URL。常用端点为 `https://api.aiearth.dev/v1`，也可以按网络情况使用 `https://api.aiearth.vip/v1`。
  </Step>

  <Step title="发起聊天补全请求">
    将请求中的 `model` 设置为 `claude-opus-4-8` 或控制台展示的模型别名，并使用 `POST /chat/completions` 发起调用。
  </Step>
</Steps>

## curl 示例

```bash theme={null}
export AIO_API_KEY="sk-your-api-key"
export AIO_BASE_URL="https://api.aiearth.dev/v1"

curl "$AIO_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $AIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [
      {
        "role": "system",
        "content": "你是 AIOAGI 上的企业开发助手。回答要先澄清风险，再给出可执行步骤。"
      },
      {
        "role": "user",
        "content": "请审查一个多服务订单系统的重构计划，并指出上线前必须验证的风险。"
      }
    ]
  }'
```

## Python 示例

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIO_API_KEY"],
    base_url=os.environ.get("AIO_BASE_URL", "https://api.aiearth.dev/v1"),
)

response = client.chat.completions.create(
    model="claude-opus-4-8",
    messages=[
        {
            "role": "system",
            "content": "你是 AIOAGI 上的企业开发助手。回答要先澄清风险，再给出可执行步骤。",
        },
        {
            "role": "user",
            "content": "请审查一个多服务订单系统的重构计划，并指出上线前必须验证的风险。",
        },
    ],
)

print(response.choices[0].message.content)
```

## Claude Code 使用

Claude Code 原生面向 Anthropic 接口。你可以把 Claude Code 指向 AIOAGI，并使用控制台可用的 Claude 模型 ID 或别名。

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aiearth.dev/",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_MODEL": "claude-opus-4-8"
  },
  "model": "claude-opus-4-8"
}
```

如果你的网络更适合 CDN 加速线路，可以把 `ANTHROPIC_BASE_URL` 改成 `https://api.aiearth.vip/`。如果 Claude Code 中的 `model` 字段需要填写平台别名，请以控制台或开发者指南为准。

<Tip>
  Claude Code、缓存策略、effort 等能力与客户端版本、Token 组和平台策略有关。遇到认证失败、模型不存在或费用异常时，请先核对 API Key、Token 组、模型名称和客户端配置。
</Tip>

## 提示词建议

Claude Opus 4.8 更适合把目标、约束和验证标准写清楚的任务。不要只让模型“继续做”，而要告诉它如何判断完成。

推荐写法：

```text theme={null}
目标：审查订单系统从单体迁移到多服务架构的方案。
上下文：已有用户服务、订单服务、支付服务和库存服务。
成功标准：
1. 找出数据一致性、回滚、限流和监控风险。
2. 给出上线前必须补充的测试清单。
3. 标出哪些结论需要人工确认。
输出格式：先给风险摘要，再给验证步骤，最后给建议的灰度发布顺序。
```

使用建议：

* 对代码任务，提供仓库背景、改动范围、测试命令和验收标准。
* 对长文档任务，要求模型标注不确定点，不要让它补造缺失信息。
* 对智能体任务，明确可调用工具、禁止操作、预算限制和停止条件。
* 对生产调用，记录失败样例，并用小流量对比旧模型的准确率、延迟和成本。

## 迁移建议

如果你已经在 AIOAGI 中使用 `claude-opus-4-7`、`claude-sonnet` 或其他 Claude 模型，不建议一次性切换所有生产流量。

1. 先保留现有模型作为基线。
2. 选择真实业务样例做 A/B 测试。
3. 对比准确率、工具调用成功率、输出长度、延迟、缓存命中和成本。
4. 优先在代码审查、复杂分析和长流程 Agent 中灰度验证。
5. 将失败样例沉淀为回归测试，再扩大流量。