claude2api

这是什么？适合谁？

Claude2API（basketikun/claude2api）是一个Claude.ai 的 API 兼容网关：Go + Docker 构建的 Claude.ai API 兼容网关，含账号池与网页镜像，支持 OpenAI Chat Completions 格式调用。MIT。自托管 Claude 接入方案（账号池模式有服务条款风险，需自担）。

核心价值：把 Claude 网页版封装成 OpenAI 兼容的 API，支持账号池轮询与网页镜像，让 Claude Code/Codex 等客户端可接入（账号池模式存在服务条款风险）。

适合人群：

• 想用 OpenAI 兼容接口调用 Claude 的开发者
• 需要自托管网关的团队
• 研究 Claude 网页版接入方案的技术人员

使用前提：Docker 或 Go 环境；账号池模式需自备账号并自行承担条款风险

准备工作

1. 安装：git clone 后 Docker 构建或 Go 编译
2. 环境：Docker / Go
3. 账号：自备 Claude 账号（注意条款风险）
4. 成本：MIT 开源免费；账号池模式需承担账户成本与风险
5. 时间：Docker 部署约 15 分钟

快速上手（3 步）

第一步：克隆并构建网关

git clone https://github.com/basketikun/claude2api && cd claude2api && docker compose up -d

克隆仓库并用 Docker 起网关服务。

第二步：配置账号池

# 按 README 配置 Claude 账号池与网页镜像

配置账号池轮询与网页镜像参数。

第三步：以 OpenAI 格式调用

curl http://localhost:8080/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"claude","messages":[{"role":"user","content":"hi"}]}'

用 OpenAI Chat Completions 格式调用网关。

成功判定：网关返回兼容的流式响应，Claude Code/Codex 等客户端能通过它对话。

初级用法

OpenAI 兼容调用

以 Chat Completions/Responses/Anthropic Messages 接口接入。

账号池轮询

多账号轮询与流式输出，分摊调用。

多轮对话与多模态

支持多轮对话、图片、Thinking 与 Function Calling。

高级玩法

网页镜像自托管

部署网页镜像，作为自有前端使用。

接入 Claude Code/Codex

把网关配置为 Claude Code、Codex CLI 的后端。

账号池健康监控

监控各账号可用性与限流状态，自动剔除失效账号。

小技巧

1. 1. 仔细评估服务条款风险再上账号池
2. 2. 用独立账号，别用主力账号
3. 3. 控制并发，避免触发风控
4. 4. 网关日志脱敏，不落明文 cookie
5. 5. 生产环境加鉴权，别裸暴露端口

常见踩坑

踩坑 1：违反服务条款

• 现象：账号被限制或封禁
• 原因：账号池模式与官方条款冲突
• 解决：自担风险，或改用官方 API

踩坑 2：裸端口暴露

• 现象：网关被他人滥用
• 原因：未加访问鉴权
• 解决：加反向代理 + token 鉴权

踩坑 3：账号风控

• 现象：并发高触发验证码
• 原因：轮询策略过激进
• 解决：降低并发，模拟正常使用节奏

踩坑 4：格式兼容问题

• 现象：客户端报接口错误
• 原因：版本差异或参数映射不全
• 解决：对照 README 支持矩阵，升级版本

踩坑 5：凭据泄漏

• 现象：账号信息泄露
• 原因：日志或配置未脱敏
• 解决：日志脱敏，密钥走环境变量

常见问题 FAQ

Q1: 它合法吗？

A: 代码 MIT 开源，但账号池/网页镜像可能违反 Claude 服务条款，使用前自行评估。

Q2: 和官方 API 有何区别？

A: 它封装网页版能力，成本模型与合规性都不同，官方 API 更稳妥。

Q3: 免费吗？

A: 软件免费，但需要自备账号与计算资源。

Q4: 支持哪些接口？

A: OpenAI Chat Completions、Responses 与 Anthropic Messages 等，以 README 为准。

Q5: 能用于生产吗？

A: 稳定性与合规风险需自行评估，不建议承载关键业务。

进阶学习建议

掌握基础后，建议深入：

1. 1. 研究 Claude 网页版协议与官方 API 的差异
2. 2. 理解账号池的限流与风控机制
3. 3. 对比各类自托管 Claude 网关的实现取舍

参考链接

• 官方仓库

最后更新：2026-09-01 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成