Claude Code API

Claude Code API

[](https://github.com/ZhangHanDong/claude-code-api-rs) [](LICENSE) [](https://www.rust-lang.org)

中文文档 | [日本語](README_JA.md) | [English](README.md)

---

🦀 cc-sdk v0.4.0 - Claude Code Rust SDK

**🎉 与 Python claude-agent-sdk v0.1.14 实现 100% 功能同等！**

[](https://crates.io/crates/cc-sdk) [](https://docs.rs/cc-sdk)

**[cc-sdk](./claude-code-sdk-rs)** 是 Claude Code CLI 的官方 Rust SDK，提供：

• 📥 CLI 自动下载 - 找不到 Claude Code CLI 时自动下载
• 📁 文件检查点 - 将文件更改回滚到任意会话节点
• 📊 结构化输出 - 响应的 JSON Schema 验证
• 🔧 完整控制协议 - 权限、钩子、MCP 服务器
• 💰 预算控制 - 支持 max_budget_usd 和 fallback_model
• 🏖️ 沙箱隔离 - Bash 命令的文件系统/网络隔离

use cc_sdk::{query, ClaudeCodeOptions};
use futures::StreamExt;

#[tokio::main]
async fn main() -> cc_sdk::Result<()> {
    let options = ClaudeCodeOptions::builder()
        .model("claude-opus-4-5-20251101")  // 最新 Opus 4.5
        .auto_download_cli(true)             // 自动下载 CLI
        .max_budget_usd(10.0)                // 预算限制
        .build();

    let mut stream = query("你好，Claude！", Some(options)).await?;
    while let Some(msg) = stream.next().await {
        println!("{:?}", msg?);
    }
    Ok(())
}

👉 **[完整 SDK 文档](./claude-code-sdk-rs/README_CN.md)** | **[API 文档](https://docs.rs/cc-sdk)**

---

一个高性能的 Rust 实现的 OpenAI 兼容 API 网关，用于 Claude Code CLI。基于强大的 [cc-sdk](https://github.com/ZhangHanDong/claude-code-api-rs/tree/main/claude-code-sdk-rs) 构建，该项目提供了一个 RESTful API 接口，让您可以使用熟悉的 OpenAI API 格式与 Claude Code 进行交互。

🎉 谁在使用 Claude Code API

• url-preview v0.6.0 - 一个用于从网页提取结构化数据的 Rust 库，使用 LLM 技术。它通过 claude-code-api 提供 Claude 驱动的网页内容提取功能，同时支持 OpenAI。

✨ 特性

• 🔌 OpenAI API 兼容 - 可直接替换 OpenAI API，兼容现有的 OpenAI 客户端库
• 🚀 高性能 - 使用 Rust、Axum 和 Tokio 构建，性能卓越
• 📦 基于 claude-code-sdk-rs - 使用强大的 SDK 实现与 Claude Code CLI 的完整集成
• ⚡ 连接池优化 - 通过优化的连接池复用 Claude 进程，响应速度提升 5-10 倍
• 💬 会话管理 - 内置会话支持，实现多轮对话
• 🖼️ 多模态支持 - 在请求中同时处理图片和文本
• ⚡ 响应缓存 - 智能缓存系统，减少延迟和成本
• 🔧 MCP 支持 - 模型上下文协议集成，可访问外部工具和服务
• 📁 文件访问控制 - 可配置的文件系统权限，确保安全操作
• 🌊 流式响应 - 支持长文本的实时流式传输
• 🛡️ 健壮的错误处理 - 全面的错误处理和自动重试机制
• 📊 统计 API - 监控使用情况和性能指标
• 🔄 多种客户端模式 - OneShot（单次查询）、Interactive（交互式）和 Batch（批处理）模式
• 🔧 工具调用 - 支持 OpenAI tools 格式，用于 AI 工具集成

🚀 快速开始

前置要求

• Rust 1.75 或更高版本
• 已安装并配置 Claude CLI
• （可选）用于扩展功能的 MCP 服务器

安装

**方式一：从 crates.io 安装**

cargo install claude-code-api

然后运行：

RUST_LOG=info claude-code-api
# 或使用短别名
RUST_LOG=info ccapi

**方式二：从源码构建**

git clone https://github.com/ZhangHanDong/claude-code-api-rs.git
cd claude-code-api-rs

构建整个工作区（API 服务器 + SDK）：

carg