Claude Code本地化部署指南：不依赖npm的完整安装方案

1次阅读

共计 2266 个字符，预计需要花费 6 分钟才能阅读完成。

在企业开发环境中，我们经常会遇到无法使用 npm 的情况，比如内网隔离、安全策略限制或 CI/CD 流水线需要完全离线部署。这时候就需要寻找不依赖 npm 的 Claude Code 部署方案。本文将介绍两种可靠的替代方案，帮助开发者在这种限制条件下顺利完成部署。

这个方案适合需要高度定制化或安全要求严格的环境。核心思路是通过 Golang 直接编译源码生成可执行文件。

优势：完全掌控构建过程，可进行深度定制
劣势：需要配置 Golang 环境，构建时间较长

对于需要快速部署的场景，可以从可信 CDN 直接获取预构建的静态资源。

优势：部署速度快，无需构建环境
劣势：依赖外部资源，需要严格校验完整性

准备基础镜像

FROM golang:1.18-alpine AS builder
WORKDIR /app
COPY . .
RUN go build -o claude-code .

FROM alpine:latest
COPY --from=builder /app/claude-code /usr/local/bin/
USER nobody

使用多阶段构建减少镜像体积
最后以 nobody 用户运行增强安全性

安装 Golang 1.18+ 并设置 GOPATH

创建专用用户和目录

groupadd -r claude && useradd -r -g claude -s /bin/false claude
mkdir -p /opt/claude-code && chown claude:claude /opt/claude-code

config.yaml示例：

security:
  cors_origins: https://your.domain.com # 严格限制来源
  rate_limit: 100 # 请求限制
  enable_tls: true
  cert_path: /etc/ssl/certs/claude.pem # 证书路径

database:
  max_connections: 20 # 连接池大小
  timeout: 5s # 超时设置

#!/bin/bash
set -euo pipefail

# 安全检查
if ["$(id -u)" -eq 0 ]; then
  echo "请勿使用 root 用户运行" >&2
  exit 1
fi

# 下载源码
REPO="https://github.com/anthropic/claude-code"
COMMIT="v1.2.0" # 固定版本
WORKDIR="/tmp/build-$(date +%s)"

echo "[1/4] 准备构建环境..."
mkdir -p "$WORKDIR"
cd "$WORKDIR"

echo "[2/4] 下载源码..."
git clone --depth 1 --branch "$COMMIT" "$REPO" . || {
  echo "下载失败" >&2
  exit 2
}

# SHA256 校验
EXPECTED="a1b2c3..."
ACTUAL=$(sha256sum go.sum | cut -d' ' -f1)
if ["$EXPECTED" != "$ACTUAL"]; then
  echo "校验失败" >&2
  exit 3
fi

echo "[3/4] 编译..."
go build -ldflags="-s -w" -o bin/claude-code . || {
  echo "编译失败" >&2
  exit 4
}

echo "[4/4] 安装..."
sudo install -m 0755 -o claude -g claude bin/claude-code /usr/local/bin/

- name: 配置 Claude Code
  hosts: all
  become: yes
  tasks:
    - name: 创建用户
      user:
        name: claude
        system: yes
        shell: /sbin/nologin

    - name: 设置目录权限
      file:
        path: /opt/claude-code
        state: directory
        owner: claude
        group: claude
        mode: '0750'

使用 go mod graph 查看完整依赖树
通过 go mod why -m <module> 分析引入原因
使用 replace 指令强制指定版本

创建内部 CA

使用 OpenSSL 生成自签名证书

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem \
  -days 365 -nodes -subj "/CN=claude.internal"

将 CA 证书加入系统信任链

curl -X POST https://localhost:8080/api/v1/complete \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Hello","max_tokens":20}' \
  --cacert /path/to/ca.pem