# @aistack/claude-code-proxy 中文文档

规范地址：https://npmcn.com/package/%40aistack/claude-code-proxy/

版本：0\.1\.2
npm 元数据更新时间：2025-07-19T11:40:22.533Z
中文译文更新时间：2026-11-06T17:46:47.522Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aistack/claude-code-proxy
原文对照：https://npmcn.com/package/%40aistack/claude-code-proxy/?lang=original
项目主页：https://github.com/aistackhq/claude-code-proxy#readme
源码仓库：https://github.com/aistackhq/claude-code-proxy

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：47.9 MB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=14\.0\.0
- 运行依赖：0 个
- 首次发布：2025-07-17T08:26:28.517Z
- 最新版本发布：2025-07-19T11:40:22.320Z
- 近 30 天下载量：2548（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

一个高性能代理服务器,将 Anthropic Claude API 请求翻译为 LiteLLM 格式,用于多提供者 LLM 访问

## 安装

```sh
npm install @aistack/claude-code-proxy
```

也可以使用：`pnpm add @aistack/claude-code-proxy`、`yarn add @aistack/claude-code-proxy`、`bun add @aistack/claude-code-proxy`

## README

# @aistack/claude-code-代理服务器

一个高性能的代理服务器,将Anthropic Claude API请求翻译为LiteLLM格式,能与多个LLM供应商实现无缝集成,包括OpenAI,Google双子座,OpenRouter,和Anthropic.

## 特征

-   🚀 **多服务支持**: OpenAI、双子座、OpenRouter和Anthropic模型之间的无缝交换
-   🔄 **自动格式翻译**: 将 Anthropic API 格式转换为 LiteLLM 格式并返回
-   🎯 **智能模型映射**:智能地将克洛德模型映射到来自其他提供者的等同模型
-   📡 **流程支持**: 完全支持服务器-恒星事件流媒体响应
-   🛡️ **生产准备**: 全面错误处理、记录和优雅的关闭
-   ⚡ **高性能**: 与 Go 为最佳性能和资源使用率低而建
-   🔧 **可配置**: 通过环境变量进行灵活配置

## 安装

使用 npm 在全球安装 :

```bash
npm install -g @aistack/claude-code-proxy
```

## 快速启动

1.  **初始化配置**数字 :

```bash
ccproxy init
```

这将促使您创建配置文件 :

-   用户级别 : `$HOME/.ccproxy/settings.json`
-   项目级别: `./.ccproxy/settings.json`

2.  **编辑配置文件**数字 :

```json
{
  "server": {
    "port": 8082,
    "host": "0.0.0.0"
  },
  "providers": {
    "openai": {
      "apiKey": "sk-...",
      "baseURL": "https://api.openai.com/v1",
      "responseStyle": "openai"
    },
    "anthropic": {
      "apiKey": "sk-ant-...",
      "baseURL": "https://api.anthropic.com",
      "responseStyle": "anthropic"
    },
    "gemini": {
      "apiKey": "...",
      "baseURL": "https://generativelanguage.googleapis.com",
      "responseStyle": "openai"
    },
    "openrouter": {
      "apiKey": "sk-or-v1-...",
      "baseURL": "https://openrouter.ai/api/v1",
      "responseStyle": "openai"
    }
  },
  "models": {
    "bigModel": "gpt-4@openai",
    "smallModel": "gpt-4-mini@openai"
  },
  "logging": {
    "level": "info",
    "format": "json"
  }
}
```

3.  **启动代理**数字 :

```bash
# Start proxy server and launch claude CLI (default behavior)
ccproxy

# Or start only the proxy server
ccproxy server
```

服务器将启动 `http://localhost:8082` (或您配置的端口).

## 图标

### 可用命令

-   **`ccproxy`** (默认) - 启动代理服务器( 如果需要)并启动 Claude CLI
-   **`ccproxy server`** - 只启动代理服务器
-   **`ccproxy init`** - 交互式初始化配置文件
    -   `--scope user` - 创建用户级配置
    -   `--scope project` - 创建项目级别配置
-   **`ccproxy help`** - 显示帮助消息
-   **`ccproxy version`** - 显示版本信息

### 全球选项

-   **`--debug`** - 启用调试记录( 适用于所有命令)
-   **`--port`** - 覆盖服务器端口(只有服务器命令)

### 实例

```bash
# Start server and launch claude CLI (default behavior)
ccproxy

# Start with debug logging enabled
ccproxy --debug

# Start only the proxy server
ccproxy server

# Start server on custom port
ccproxy server --port 8080

# Start server with debug logging
ccproxy server --debug

# Initialize configuration interactively
ccproxy init

# Create user-level configuration
ccproxy init --scope user

# Create project-level configuration
ccproxy init --scope project
```

## 使用量

## 配置

### 配置文件

代理加载配置按优先级顺序从多个来源进行 :

1.  **命令行参数** (最高优先级)
    -   `--port`: 覆盖服务器端口
2.  **JSON 配置文件**数字 :
    -   `/etc/ccproxy/managed-settings.json` (管理/全系统)
    -   `$CWD/.ccproxy/settings.json` (项目一级)
    -   `$HOME/.ccproxy/settings.json` (用户级)

### 模型格式

格式中指定模型 `modelname@provider`数字 :

-   `gpt-4@openai`
-   `claude-3-opus@anthropic`
-   `gemini-pro@gemini`
-   `gpt-4@openrouter`

### 响应样式

提供者可以有不同的响应风格:

-   `"responseStyle": "anthropic"` - 原生Anthropic格式(无转换)
-   `"responseStyle": "openai"` - OpenAI格式(需要转换)

这使得代理机可以跳过本地支持Anthropic的API格式的提供者不必要的转换.

## 模型绘图

代理自动映射 Claude 模型以配置模型 :

| 克劳德模型 | 调试到 | 说明 |
| --- | --- | --- |
| 克劳德.._\-海库_ | `smallModel` | 配置的小模型的地图 |
| 克劳德.._\- 孙网_ | `bigModel` | 配置的大模型地图 |
| 其他模式 | 按规定 | 使用模型@ professor 格式 |

## 配置选项

### JSON 配置

| 外地 | 说明 | 默认 |
| --- | --- | --- |
| `server.port` | 服务器端口 | `8082` |
| `server.host` | 服务器主机 | `0.0.0.0` |
| `providers.<name>.apiKey` | API 密钥提供者 | \- 说吧 |
| `providers.<name>.baseURL` | 提供者基础 URL | \- 说吧 |
| `providers.<name>.responseStyle` | 响应格式样式 | `openai` |
| `models.bigModel` | 大宗请求的模式 | `gpt-4@openai` |
| `models.smallModel` | 小请求模式 | `gpt-4-mini@openai` |
| `logging.level` | 日志级别 | `info` |
| `logging.format` | 日志格式 | `json` |

## 默认行为

当你跑的时候 `ccproxy` 它将:

1.  检查代理服务器是否已运行
2.  未运行时启动服务器
3.  用 ANTHROPIC BASE URL 设置到代理服务器启动 CLI

这意味着你可以使用 `ccproxy` 用于替换 `claude` 命令,同时自动获得多提供者支持.

### 添加自定义提供者

本地安特罗皮克支持的自定义提供者 :

```json
{
  "providers": {
    "custom-llm": {
      "baseURL": "https://your-llm-api.com",
      "apiKey": "your-api-key",
      "responseStyle": "anthropic"
    }
  }
}
```

然后使用它与: `custom-model@custom-llm`

## 平台支持

用于下列平台的CLI:

-   macOS (英特尔和苹果硅)
-   Linux (x64 & ARM64) (韩语)
-   视窗 (x64)

## 解决问题

### 二进制未找到

如果您看到"Binary没有找到"错误,这意味着您的平台不被支持. 请 [打开一个问题](https://github.com/aistackhq/claude-code-proxy/issues) 你的平台细节.

### 拒绝权限

在Unix系统上,如果遇到许可错误:

```bash
sudo npm install -g @aistack/claude-code-proxy
```

### API 关键问题

保证您的 API 密钥正确设置在您的中 `settings.json` 并获得必要的权限.

## 发展

为了发展或作出贡献,访问 [GitHub 仓库](https://github.com/aistackhq/claude-code-proxy)。 。 。 .

## 许可证

麻省理工学院的执照 - 看 [自由主义](https://github.com/aistackhq/claude-code-proxy/blob/main/LICENSE) 详细文件.

## 支助

-   📚 [文档](https://github.com/aistackhq/claude-code-proxy)
-   🐛 [问题跟踪器](https://github.com/aistackhq/claude-code-proxy/issues)
-   💬 [讨论情况](https://github.com/aistackhq/claude-code-proxy/discussions)

## 更改日志

见 [变动情况](https://github.com/aistackhq/claude-code-proxy/blob/main/CHANGELOG.md) 为释放历史.

## 常见问题

### @aistack/claude-code-proxy 是什么？

一个高性能代理服务器,将 Anthropic Claude API 请求翻译为 LiteLLM 格式,用于多提供者 LLM 访问

### 如何安装 @aistack/claude-code-proxy？

在项目目录运行 npm install @aistack/claude-code-proxy，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ccproxy，可以用 npx ccproxy 直接运行。

### @aistack/claude-code-proxy 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aistack\_\_claude-code-proxy 是否存在。

### @aistack/claude-code-proxy 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aistack/claude-code-proxy 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=14\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aistack/claude-code-proxy 可以商用吗？

@aistack/claude-code-proxy 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aistack/claude-code-proxy 的下载量有多少？

根据 npm 官方下载统计，@aistack/claude-code-proxy 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,548 次，日均约 85 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aistack/claude-code-proxy 还在维护吗？

最新版本 0\.1\.2 发布于 2025/07/19（1\.3 年前）；至今共发布 3 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/07/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。