# glmProxy

**Repository Path**: kaikz/glm-proxy

## Basic Information

- **Project Name**: glmProxy
- **Description**: 将你自己的智谱ai本地中转，使用局域网让你的好友通过 Claude Code 直接调用智谱服务，同时隐藏真实智谱 API Key。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-20
- **Last Updated**: 2026-05-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZhiPu AI <-> Anthropic API Proxy

将 Claude Code 发出的 Anthropic API 请求翻译为智谱 OpenAI 兼容格式，使局域网内用户通过 Claude Code 直接调用智谱服务，同时隐藏真实智谱 API Key。

## 功能

- Anthropic ↔ 智谱 API 双向格式翻译（请求体 + 流式响应）
- 隐藏真实智谱 API Key，对外仅暴露自定义访问令牌
- 支持流式（SSE）和非流式响应
- 支持 tool_use / tool_result（function calling）
- 模型名自动映射（Claude 模型名 → 智谱模型名）

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 修改配置

编辑 `zhipu_proxy.py` 顶部的 CONFIG 区域：

```python
REAL_ZHIPU_KEY = "你的智谱API Key"
ACCESS_TOKEN   = "自定义访问密码"
PORT           = 23456
```

### 3. 启动服务

```bash
python zhipu_proxy.py
```

启动后会显示客户端配置信息。

### 4. 客户端配置

局域网用户在 Claude Code 的 `settings.json` 中添加：

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://<服务端IP>:23456",
    "ANTHROPIC_API_KEY": "<ACCESS_TOKEN>"
  }
}
```

配置完成后即可正常使用 Claude Code，无需其他操作。

## 模型映射

| Claude 模型 | 智谱模型 |
|---|---|
| claude-opus-4-7 | glm-5 |
| claude-sonnet-4-* | glm-5-turbo |
| claude-haiku-4-* | glm-5-turbo |
| 其他 | glm-5-turbo |

可在 `MODEL_MAP` 中自定义映射关系。

## 原理

```
Claude Code ──Anthropic格式──▶ 代理(本服务) ──OpenAI格式──▶ 智谱API
Claude Code ◀──Anthropic格式── 代理(本服务) ◀──OpenAI格式── 智谱API
```

代理监听 `/v1/messages` 路径，接收 Anthropic 格式请求，转换为 OpenAI 兼容格式后转发至智谱 API，再将响应翻译回 Anthropic 格式返回给客户端。