Claude 部署完整教程｜一键部署

本文将以“可落地、可复制、适合新手”为目标，完整讲解如何部署一个可访问 Claude API 的 Web 聊天服务。
需要说明的是：Claude 模型本身并不能像普通开源模型一样下载到本地运行，Claude 是 Anthropic 提供的闭源大模型服务。因此所谓“部署 Claude”，通常指的是部署一个前端或中转服务，通过 Anthropic API Key 调用 Claude 模型，实现类似 Claude 官网的聊天体验。

一、部署前你需要了解什么？

Claude 是 Anthropic 推出的强大大语言模型系列，常见模型包括：

• Claude 3.5 Sonnet
• Claude 3 Opus
• Claude 3 Sonnet
• Claude 3 Haiku
• Claude 3.7 Sonnet 等

不同模型在能力、价格、速度和上下文长度上有所区别。一般来说：

• Sonnet：综合能力强，适合日常写作、代码、分析、办公场景；
• Opus：能力更强，但成本更高；
• Haiku：速度快、价格低，适合轻量任务。

如果你只是想搭建一个自己或团队使用的 Claude 聊天网站，最推荐的方式是：

使用 Docker 一键部署一个支持 Claude API 的 Web UI，然后在后台配置 Anthropic API Key。

这种方式的优点是：

1. 部署简单，适合新手；
2. 不需要复杂环境；
3. 支持服务器、NAS、云主机；
4. 可搭配域名和 HTTPS；
5. 便于团队多人使用；
6. 后续升级维护也比较方便。

本文将使用 Docker Compose 的方式进行部署。你只需要准备一台服务器和一个 API Key，就可以快速完成 Claude 私有化 Web 服务搭建。

二、部署方案选择

目前常见的 Claude 部署方案主要有以下几类：

1. 直接使用官方 Claude 网页版

这是最简单的方式，不需要部署。但缺点也比较明显：

• 依赖官方网页；
• 不方便团队统一管理；
• 不适合内网环境；
• 不方便集成自己的业务系统；
• 部分地区访问可能受限。

2. 使用第三方 AI Web UI

例如一些开源项目支持 Claude、OpenAI、Gemini、Azure OpenAI 等多模型接入。你可以把它理解为一个“AI 聊天前端”。

优点：

• 部署方便；
• 支持多模型；
• 支持多用户；
• UI 体验好；
• 可以自定义模型和接口地址。

3. 自己开发后端调用 Claude API

这种方式适合有开发能力的团队。你可以用 Node.js、Python、Go 等语言封装 Claude API。

优点是灵活，缺点是开发和维护成本更高。

4. 使用 Dify、FastGPT 等平台

这类平台更适合知识库问答、智能体、工作流、企业 AI 应用搭建。
如果你只是想聊天，可能稍显复杂；如果你想搭建企业级 AI 应用，则非常合适。

三、本文采用的部署架构

本文推荐的部署架构如下：

用户浏览器
   ↓
域名 / IP 地址
   ↓
Nginx / Caddy 反向代理，可选
   ↓
AI Web UI 容器
   ↓
Anthropic Claude API

简单来说：

• 用户通过浏览器访问你的 Web UI；
• Web UI 接收用户输入；
• 后端通过 Anthropic API Key 调用 Claude；
• Claude 返回结果；
• Web UI 展示回答。

这种架构不需要你拥有 GPU，也不需要本地运行大模型。服务器只负责网页服务和 API 转发，因此对配置要求不高。

四、服务器配置建议

如果只是个人使用，最低配置如下：

如果是团队使用，建议配置：

五、准备工作

在正式部署之前，你需要准备以下内容：

1. 一台服务器

可以使用：

• 阿里云
• 腾讯云
• 华为云
• AWS
• Google Cloud
• Azure
• Vultr
• DigitalOcean
• 搬瓦工
• 自建服务器
• NAS

本文以 Ubuntu 22.04 为例。

2. 一个 Anthropic API Key

你需要前往 Anthropic 官方平台申请 API Key。
拿到 API Key 后，请妥善保存，后续会用到。

API Key 通常长这样：

sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxx

注意：

• 不要把 API Key 上传到公开仓库；
• 不要写进前端页面；
• 不要截图公开分享；
• 建议定期轮换；
• 如果泄露，请立即删除旧 Key 并重新生成。

3. 一个域名，可选

如果只是自己测试，可以直接用服务器 IP 访问。
如果需要长期使用，建议绑定域名，例如：

claude.example.com

然后通过 Nginx 或 Caddy 配置 HTTPS。

六、一键安装 Docker 环境

大多数 AI Web UI 项目都推荐使用 Docker 部署，因为 Docker 可以避免各种环境冲突。

使用 SSH 登录服务器：

ssh root@你的服务器IP

更新系统：

apt update && apt upgrade -y

安装基础工具：

apt install -y curl wget git vim ca-certificates

安装 Docker：

curl -fsSL https://get.docker.com | bash

启动 Docker 并设置开机自启：

systemctl enable docker
systemctl start docker

检查 Docker 是否安装成功：

docker version

如果能看到 Docker 版本信息，说明安装成功。

继续安装 Docker Compose：

apt install -y docker-compose-plugin

检查 Docker Compose：

docker compose version

如果输出版本号，则说明 Docker Compose 已可用。

七、一键部署 Claude Web UI

下面提供一个通用的一键部署方式。为了便于维护，我们将项目放在 /opt/claude-web 目录下。

1. 创建部署目录

mkdir -p /opt/claude-web
cd /opt/claude-web

2. 创建环境变量文件

vim .env

写入以下内容：

ANTHROPIC_API_KEY=你的_Anthropic_API_Key
PORT=3000

请将：

你的_Anthropic_API_Key

替换成你自己的 API Key。

例如：

ANTHROPIC_API_KEY=sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxx
PORT=3000

保存退出。

3. 创建 Docker Compose 文件

vim docker-compose.yml

写入以下内容：

services:
  claude-web:
    image: ghcr.io/open-webui/open-webui:main
    container_name: claude-web
    restart: always
    ports:
      - "3000:8080"
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - WEBUI_AUTH=true
    volumes:
      - ./data:/app/backend/data

保存退出。

说明：

• image：使用 Web UI 镜像；
• ports：将服务器的 3000 端口映射到容器内部的 8080；
• WEBUI_AUTH=true：开启登录认证；
• volumes：持久化数据，避免容器重启后数据丢失。

4. 启动服务

docker compose up -d

查看容器状态：

docker ps

如果看到 claude-web 正在运行，说明部署成功。

查看日志：

docker logs -f claude-web

八、访问 Claude Web 服务

如果你没有配置域名，可以直接访问：

http://服务器IP:3000

首次访问时，一般需要创建管理员账号。
创建完成后进入后台，在模型或接口配置中选择 Anthropic / Claude，并配置相应模型。

如果 Web UI 没有自动读取环境变量，你可以在后台手动添加：

API Provider: Anthropic
API Key: 你的 Anthropic API Key
Model: claude-3-5-sonnet-latest

常见模型名称示例：

claude-3-5-sonnet-latest
claude-3-opus-latest
claude-3-haiku-20240307

具体模型名称请以 Anthropic 官方文档为准。

九、配置域名访问

如果你想通过域名访问，例如：

https://claude.example.com

需要先把域名解析到服务器 IP。

添加一条 DNS 解析：

等待 DNS 生效后，在服务器上安装 Nginx：

apt install -y nginx

创建 Nginx 配置文件：

vim /etc/nginx/conf.d/claude.conf

写入：

server {
    listen 80;
    server_name claude.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

将：

claude.example.com

替换为你的真实域名。

检查 Nginx 配置：

nginx -t

重载 Nginx：

systemctl reload nginx

现在可以通过：

http://claude.example.com

访问你的 Claude Web 服务。

十、配置 HTTPS 证书

为了安全，建议开启 HTTPS。

安装 Certbot：

apt install -y certbot python3-certbot-nginx

申请证书：

certbot --nginx -d claude.example.com

按照提示输入邮箱、同意协议即可。

申请成功后，访问：

https://claude.example.com

测试自动续期：

certbot renew --dry-run

如果没有报错，说明证书自动续期正常。

十一、使用一键脚本部署

如果你希望进一步简化操作，也可以使用下面的一键脚本。

1. 创建脚本

vim install-claude-web.sh

写入：

#!/bin/bash

set -e

echo "请输入 Anthropic API Key："
read -r ANTHROPIC_API_KEY

INSTALL_DIR="/opt/claude-web"

echo "开始安装 Docker..."
if ! command -v docker >/dev/null 2>&1; then
  curl -fsSL https://get.docker.com | bash
  systemctl enable docker
  systemctl start docker
else
  echo "Docker 已安装，跳过。"
fi

echo "安装 Docker Compose 插件..."
apt update
apt install -y docker-compose-plugin

echo "创建部署目录..."
mkdir -p ${INSTALL_DIR}
cd ${INSTALL_DIR}

echo "写入环境变量..."
cat > .env < docker-compose.yml <

chmod +x install-claude-web.sh
./install-claude-web.sh

22、80、443

ufw allow 22
ufw allow 80
ufw allow 443
ufw allow 3000
ufw enable
ufw status

cd /opt/claude-web

docker compose pull

docker compose up -d

docker image prune -f

volumes:
  - ./data:/app/backend/data

/opt/claude-web/data

cd /opt
tar -czvf claude-web-backup.tar.gz claude-web

docker compose up -d

cd /opt/claude-web
docker compose down

docker compose up -d

cd /opt/claude-web
docker compose down
cd /opt
rm -rf claude-web

docker rmi ghcr.io/open-webui/open-webui:main

docker ps

docker logs -f claude-web

ss -lntp | grep 3000

cd /opt/claude-web
docker compose down
mv data data_backup
docker compose up -d

location / {
    allow 你的固定IP;
    deny all;

    proxy_pass http://127.0.0.1:3000;
}

claude-3-5-sonnet-latest

claude-3-haiku-20240307

Claude API
OpenAI API
Gemini API
DeepSeek API
通义千问 API
智谱 GLM API
本地 Ollama 模型