claude-ai-ultimate-suite

用途

Claude AI Ultimate Suite 是一套综合性工具包，用于将 Claude AI 模型（Claude 4.6 Opus、Claude 3.5 Sonnet）集成到开发工作流中。它面向希望借助 Claude 的进阶推理能力完成架构决策、缺陷修复、代码审查和复杂问题求解任务的开发者，支持 AI 驱动的结对编程与代码生成。

主要能力

API 封装：提供 Python 的 query_claude 基础查询封装，以及 JavaScript/Node.js 的 Claude 调用示例（如代码审查函数）。
上下文管理：ClaudeSession 类可跨多次查询维护对话历史，并支持自定义 system prompt。
提示词库：ClaudePromptLibrary 从 prompts/artifacts.json 加载预配置提示词，按类别与任务取用并执行，例如调试场景的根因定位。
代码生成：如 generate_crud_api 通过结构化提示词生成完整 REST API。
流式响应：client.messages.stream 实现实时输出。
视觉与文档分析：通过 base64 图像输入分析截图中的代码。
工具调用（Function Calling）：定义 tools 让 Claude 调用外部函数（如 execute_code、search_documentation）。
批处理分析：AsyncAnthropic 与 asyncio.gather 并行分析多个文件，可指定分析类型（如 security）。
文档生成：根据源码生成 Markdown 格式的 API 文档。

使用方式

安装（Windows 平台）

从项目文档站点下载最新发布版本。
解压到安装目录，示例路径：

# Example extraction path
C:\Program Files\ClaudeSuite\

$env:Path += ";C:\Program Files\ClaudeSuite\bin"

验证安装：

claude-suite --version

环境配置

在项目根目录创建 .env 文件：

ANTHROPIC_API_KEY=your_api_key_here
CLAUDE_MODEL=claude-opus-4-6
CLAUDE_MAX_TOKENS=4096
CLAUDE_TEMPERATURE=0.7

基本调用（Python）

import os
from anthropic import Anthropic

# Initialize client with environment variable
client = Anthropic(
    api_key=os.environ.get("ANTHROPIC_API_KEY")
)

def query_claude(prompt, model="claude-opus-4-6", max_tokens=4096):
    """
    Basic Claude API query wrapper
    """
    message = client.messages.create(
        model=model,
        max_tokens=max_tokens,
        messages=[
            {"role": "user", "content": prompt}
        ]
    )
    return message.content[0].text

模型选择

文档提供 CLAUDE_MODELS 配置映射，按任务推荐模型：claude-opus-4-6 适用于复杂推理、架构设计、深度代码分析（重构、系统设计、缺陷调查）；claude-opus-4-8 适用于关键系统与安全审查；claude-sonnet-3-5 适用于代码生成、文档与一般查询。select_model_for_task 函数可按任务类型自动选择模型，默认返回 claude-sonnet-3-5。

高级配置

ClaudeConfig dataclass 从环境变量读取 api_key、default_model、max_tokens、temperature、top_p、timeout、retry_attempts，并提供 to_api_params 输出请求参数。

适用场景

结对编程：PairProgrammingAssistant 提供代码审查、重构建议、错误解释，并可注入项目上下文。
批量代码分析：对多个文件并行执行指定类型（如安全）分析。
API 文档生成：从源码生成包含端点、请求/响应示例、认证要求、错误处理的 Markdown 文档。
代码生成：根据实体与字段定义生成包含框架、模型、校验、错误处理的代码。

限制与注意事项

文档提到 RateLimitError 处理与指数退避重试（query_with_retry）。
Token 管理：estimate_tokens 按约 1 token ≈ 4 字符估算；truncate_to_token_limit 可按上限截断文本。
错误处理：safe_claude_query 处理 APITimeoutError、APIError 及一般异常，返回后备响应。
对话上下文管理函数 manage_conversation_context 在资料中未完整给出实现细节。
关于收费、价格、各平台支持情况、性能效果等未在资料中提供，暂未提供。