wakeya/magic-claude-code

Magic Claude Code

让 Claude Code 误以为在与官方 API 通信的透明代理服务。

功能特性

• 透明代理所有 Claude Code API 请求
• 多供应商管理：支持配置多个 API 供应商，灵活切换
• 模型映射：自动将请求模型名转换为供应商支持的模型（如 claude-sonnet-4 → glm-5）
• 自动生成 CA 证书（10年有效期）
• 前端配置页面管理供应商和模型映射
• 密码保护配置页面
• Docker 单容器部署
• 热更新配置无需重启

发布说明

版本发布由 v* tag 触发 CI 自动构建。GitHub/GitLab 会生成并上传跨平台二进制资产；Gitee/GitCode 通过 Release API 上传附件。开发者提交与发布步骤见 AGENT.md。

快速开始

1. 使用 Docker 部署

方式一：使用 docker build（推荐）

# 克隆项目
git clone <repo-url>
cd magic-claude-code

# 构建镜像
docker build -t magic-claude-code .

# 运行容器
docker run -d \
  --name mcc \
  -p 443:443 \
  -p 8442:8442 \
  -v ./data:/app/data \
  -v "${CLAUDE_PROJECTS_DIR:-$HOME/.claude/projects}:/claude-projects:ro" \
  -e ADMIN_PASSWORD=admin123 \
  -e CLAUDE_PROJECTS_DIR=/claude-projects \
  --cap-add NET_BIND_SERVICE \
  --restart=unless-stopped \
  magic-claude-code

# 查看日志获取配置提示
docker logs mcc

方式二：使用 docker-compose

# 克隆项目
git clone <repo-url>
cd magic-claude-code

# 安装 docker-compose-plugin（如果未安装）
sudo apt-get install docker-compose-plugin

# 启动服务
docker compose up -d

# 查看日志获取配置提示
docker logs mcc

2. 测试构建和验证

# 1. 测试构建镜像
docker compose build

# 2. 查看构建的镜像
docker images | grep magic-claude-code

# 3. 启动服务
docker compose up -d

# 4. 查看服务日志
docker compose logs -f

# 5. 验证服务是否正常运行
curl -k https://localhost:8442

# 6. 查看容器状态
docker compose ps

3. 重新打包部署

代码更新后，重新构建镜像并重启容器：

# 一键重新构建并部署
docker compose up -d --build

# 查看启动日志
docker compose logs -f

4. 使用二进制运行（非 Docker）

二进制运行适合不想使用 Docker 的环境。服务会固定监听：

• 443：代理服务入口，用于接收 https://api.anthropic.com 请求
• 8442：配置页面

macOS / Linux

从源码构建：

# 克隆项目
git clone <repo-url>
cd magic-claude-code

# 构建前端静态资源
npm --prefix internal/frontend ci
npm --prefix internal/frontend run build

# 构建二进制
make build

启动服务：

# Linux 可先授予绑定 443 端口的能力
sudo setcap 'cap_net_bind_service=+ep' ./bin/mcc

# 启动，建议显式设置管理密码
./bin/mcc -data ./data -password "your-a