[!重要] Claude 似乎已阻止所有非浏览器流量访问其内部 API，这使得该项目几乎无法使用。如果你有解决此问题的方法，请提交 PR。抱歉——@Explosion-Scratch

claude-unofficial-api

https://github.com/Explosion-Scratch/claude-unofficial-api/assets/61319150/6c3f706d-bddf-42e6-9745-aa1f7561ca40

这是一个轻量级的（同构、无依赖）JavaScript 库，用于与 Claude AI 聊天机器人的非官方内部 API 进行交互。CLI 安装、API 安装 + 使用

嘘——它还能编写完整的项目，以及输出有效的 JSON

特性

• 💬 开始新的对话

• 📎 上传文件

• 🧪 包含单元测试，代码覆盖率85%，通过率100%！

• 🌎 同构（假设你设置了代理；CORS 让我很难过）

• 🔄 支持 async/await 和现代语法

• 💾 获取并回复现有对话

• 🚀 即将推出

  • CLI：重试响应、实现Reflexion、提示模板、自动保存对话
  • API：更好的错误处理、自动化单元测试、缓存层、搜索功能、setActiveModel、列出可用模型、直接向现有对话发送消息、事件钩子、已使用 token 数量（百分比/原始值）、token 预估器、模型可用 token 数量

• 💪 支持所有 Claude 模型（claude-2、claude-1.3、claude-instant-100k——参见 --model 标志）

安装

npm install claude-ai

CLI 安装

npm install -g claude-cli

注意 运行 claude --help 或查看 CLI_DOCS.md 以获取有关 CLI 的更多信息。

使用

首先，导入库：

const Claude = require('claude-ai'); 

使用你的会话密钥初始化一个新的 Claude 实例：

注意 从 Claude 网站的 sessionKey Cookie 中获取 sessionKey。

const claude = new Claude({
  sessionKey: 'YOUR_SESSION_KEY' 
});

通过调用 startConversation() 并传入提示信息来开始对话（或通过 .getConversations() 获取现有对话）：

const conversation = await claude.startConversation('Hello Claude!');

Conversation 实例提供了如 sendMessage() 等方法来继续聊天：

await conversation.sendMessage('How are you today?');

完整代码如下：

const Claude = require('claude-ai');

const claude = new Claude({
  sessionKey: 'YOUR_SESSION_KEY'
});

await claude.init();

const conversation = await claude.startConversation('Hello Claude!');

await conversation.sendMessage('How are you today?');

请参阅下方的文档，以获取完整的 API 参考。

文档

Claude

用于与 Claude API 交互的主要类。

构造函数：

const claude_instance = new Claude({
  sessionKey: string,
  proxy: string | ({endpoint, options}) => ({endpoint, options})
})

• 如果 proxy 是一个函数，它会接收要请求的 API 路径以及 fetch 选项，并在执行 fetch 之前对这些选项进行修改。如果你愿意冒险，也可以直接修改 claude.request 函数（更多信息请参阅源码）。
• 如果 proxy 是一个字符串，则该字符串会简单地被添加到 API 端点之前，例如：https://claude.ai/

参数：

• sessionKey —— 你的 Claude sessionKey Cookie

实例方法：

• startConversation(prompt) —— 使用给定的提示信息开始新对话
• getConversations() —— 获取最近的对话
• clearConversations() —— 清除所有对话
• uploadFile(file) —— 上传文件

Conversation

由 Claude.startConversation() 返回。

方法：

• sendMessage(message, options) —— 在对话中发送后续消息
• getInfo() —— 获取对话信息（包括消息、名称、创建时间、更新时间等）
• delete() —— 删除对话（返回 fetch 响应）

sendMessage 选项：

• timezone —— 完成时使用的时区
• attachments —— 文件附件数组
• model —— 要使用的 Claude 模型（默认为 claude-2；其他已知模型包括 claude-1.3 和 claude-instant-100k。似乎也接受 claude-1，但会将其转换为 claude-1.3）
• done —— 完成时的回调
• progress —— 进度回调

贡献

欢迎贡献！本库由 GitHub 上的 @Explosion-Scratch 创建。请提交 PR 来帮助改进它。

claude-unofficial-api 快速上手指南

⚠️ 重要提示 根据项目作者说明，Claude 官方似乎已屏蔽所有非浏览器流量访问其内部 API，导致本项目目前可能无法正常使用。如果您有解决方案，欢迎向原仓库提交 PR。本指南仅基于项目原有文档整理，供参考或本地调试使用。

环境准备

• 运行环境: Node.js (推荐最新 LTS 版本)
• 前置依赖: 无 (该库为 0 依赖的轻量级 JavaScript 库)
• 关键凭证: 需要从 Claude 官网获取 sessionKey Cookie
  • 登录 claude.ai
  • 打开浏览器开发者工具 (F12) -> Application (应用) -> Cookies
  • 复制名为 sessionKey 的值

安装步骤

1. 安装核心库 (用于代码调用)

npm install claude-ai

国内加速方案（可选）：

npm install claude-ai --registry=https://registry.npmmirror.com

2. 安装命令行工具 (可选)

如需在终端直接使用，可全局安装 CLI 工具：

npm install -g claude-cli

安装完成后，可通过 claude --help 查看命令帮助。

基本使用

以下是最简单的代码调用示例，展示如何初始化并发送消息。

代码示例

const Claude = require('claude-ai');

// 1. 初始化实例，填入从浏览器获取的 sessionKey
const claude = new Claude({
  sessionKey: 'YOUR_SESSION_KEY' 
});

// 2. 初始化连接
await claude.init();

// 3. 开启新对话并发送第一条消息
const conversation = await claude.startConversation('Hello Claude!');

// 4. 继续发送消息
await conversation.sendMessage('How are you today?');

进阶选项说明

在 sendMessage 方法中，您可以传入配置对象以指定模型或添加附件：

await conversation.sendMessage('请帮我写一段代码', {
  model: 'claude-2', // 可选模型：claude-2, claude-1.3, claude-instant-100k
  attachments: [],   // 文件附件数组
  timezone: 'Asia/Shanghai'
});

主要功能概览

• 启动对话: claude.startConversation(prompt)
• 获取历史: claude.getConversations()
• 上传文件: claude.uploadFile(file)
• 删除对话: conversation.delete()