Claude Code 离线安装与网络受限环境指南#

#!/bin/bash
# 网络环境检测脚本

echo "🔍 检测网络环境..."

# 检测是否能访问官方CDN
if curl -s --connect-timeout 5 https://install.claude.ai > /dev/null; then
  echo "✅ 可直接访问官方CDN"
  NETWORK_TYPE="direct"
else
  echo "❌ 无法访问官方CDN"
  
  # 检测是否能通过代理访问
  if curl -s --proxy http://proxy.example.com:8080 https://install.claude.ai > /dev/null; then
    echo "✅ 可通过代理访问"
    NETWORK_TYPE="proxy"
  else
    echo "❌ 代理也无法访问"
    NETWORK_TYPE="offline"
  fi
fi

# 检测DNS解析
if nslookup install.claude.ai > /dev/null 2>&1; then
  echo "✅ DNS解析正常"
else
  echo "❌ DNS解析失败"
fi

# 检测带宽
echo "📊 带宽测试..."
SPEED=$(curl -w %{speed_download} -o /dev/null -s https://install.claude.ai/speed-test)
echo "下载速度: $SPEED B/s"

echo "网络类型: $NETWORK_TYPE"

# macOS (Intel)
curl -LO https://github.com/anthropics/claude-code/releases/latest/download/ClaudeCode-macos-x64.zip

# macOS (Apple Silicon)  
curl -LO https://github.com/anthropics/claude-code/releases/latest/download/ClaudeCode-macos-arm64.zip

# Linux (x64)
curl -LO https://github.com/anthropics/claude-code/releases/latest/download/ClaudeCode-linux-x64.tar.gz

# Linux (ARM64)
curl -LO https://github.com/anthropics/claude-code/releases/latest/download/ClaudeCode-linux-arm64.tar.gz

# Windows (x64)
curl -LO https://github.com/anthropics/claude-code/releases/latest/download/ClaudeCode-windows-x64.zip

# Windows (ARM64)
curl -LO https://github.com/anthropics/claude-code/releases/latest/download/ClaudeCode-windows-arm64.zip

# 获取最新版本号
curl -s https://api.github.com/repos/anthropics/claude-code/releases/latest | grep tag_name

# 获取所有版本
curl -s https://api.github.com/repos/anthropics/claude-code/releases | grep tag_name

# 1. 传输安装包到目标机器
scp ClaudeCode-macos-x64.zip user@target-machine:/tmp/

# 2. 在目标机器上解压
cd /tmp
unzip ClaudeCode-macos-x64.zip

# 3. 移动到Applications目录
sudo mv Claude\ Code.app /Applications/

# 4. 创建命令行工具链接
sudo ln -s /Applications/Claude\ Code.app/Contents/Resources/app/bin/claude /usr/local/bin/claude

# 5. 验证安装
claude --version

# 1. 传输安装包
scp ClaudeCode-linux-x64.tar.gz user@target-machine:/tmp/

# 2. 解压
cd /tmp
tar -xzf ClaudeCode-linux-x64.tar.gz

# 3. 安装到/opt目录
sudo mkdir -p /opt/claude-code
sudo cp -r claude-code/* /opt/claude-code/

# 4. 创建符号链接
sudo ln -s /opt/claude-code/bin/claude /usr/local/bin/claude

# 5. 设置执行权限
sudo chmod +x /opt/claude-code/bin/claude

# 6. 验证安装
claude --version

# 1. 传输安装包
# 使用SCP、USB驱动器或其他传输方式

# 2. 解压到目标目录
Expand-Archive -Path C:\Temp\ClaudeCode-windows-x64.zip -DestinationPath C:\Program Files\ClaudeCode

# 3. 添加到系统PATH
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\ClaudeCode\bin", "Machine")

# 4. 验证安装
claude --version

# 1. 下载新版本
# 2. 停止Claude Code进程
pkill -f claude

# 3. 备份当前配置
cp -r ~/.claude ~/.claude.backup

# 4. 替换二进制文件
sudo cp /tmp/claude-code/bin/claude /usr/local/bin/claude

# 5. 重启Claude Code
claude

#!/bin/bash
# offline-update.sh

VERSION=$1
INSTALL_DIR="/opt/claude-code"
BACKUP_DIR="$HOME/.claude.backup"

echo "🔄 开始离线更新到版本 $VERSION..."

# 1. 检查新版本包是否存在
if [ ! -f "/tmp/ClaudeCode-linux-x64-v$VERSION.tar.gz" ]; then
  echo "❌ 新版本包不存在"
  exit 1
fi

# 2. 停止Claude Code进程
echo "🛑 停止Claude Code..."
pkill -f claude

# 3. 备份配置
echo "💾 备份配置..."
cp -r ~/.claude $BACKUP_DIR

# 4. 解压新版本
echo "📦 解压新版本..."
cd /tmp
tar -xzf ClaudeCode-linux-x64-v$VERSION.tar.gz

# 5. 替换安装
echo "🔧 替换安装..."
sudo cp -r claude-code/* $INSTALL_DIR/

# 6. 恢复配置
echo "📂 恢复配置..."
cp -r $BACKUP_DIR/.claude ~/

# 7. 设置权限
sudo chmod +x $INSTALL_DIR/bin/claude

echo "✅ 更新完成"
echo "新版本: $(claude --version)"

#!/bin/bash
# 代理环境检测

echo "🔍 检测代理配置..."

# 检查环境变量
if [ -n "$HTTP_PROXY" ]; then
  echo "✅ HTTP_PROXY: $HTTP_PROXY"
fi

if [ -n "$HTTPS_PROXY" ]; then
  echo "✅ HTTPS_PROXY: $HTTPS_PROXY"
fi

if [ -n "$ALL_PROXY" ]; then
  echo "✅ ALL_PROXY: $ALL_PROXY"
fi

# 测试代理连接
if curl -s --proxy $HTTP_PROXY http://httpbin.org/ip > /dev/null; then
  echo "✅ 代理连接正常"
else
  echo "❌ 代理连接失败"
fi

# 在 ~/.bashrc 或 ~/.zshrc 中添加

# HTTP代理
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080

# SOCKS5代理
export ALL_PROXY=socks5://proxy.example.com:1080

# 不使用代理的地址
export NO_PROXY=localhost,127.0.0.1,*.internal.com

{
  "env": {
    "HTTP_PROXY": "http://proxy.example.com:8080",
    "HTTPS_PROXY": "http://proxy.example.com:8080",
    "ALL_PROXY": "socks5://proxy.example.com:1080",
    "NO_PROXY": "localhost,127.0.0.1"
  }
}

# 单次使用代理
claude --proxy http://proxy.example.com:8080 "分析代码"

# 使用系统代理
claude --use-system-proxy "优化性能"

# 带认证的代理
export HTTP_PROXY=http://username:password@proxy.example.com:8080
export HTTPS_PROXY=http://username:password@proxy.example.com:8080

# NTLM代理（Windows）
export HTTP_PROXY=http://domain\username:password@proxy.example.com:8080

# 自定义CA证书
export SSL_CERT_FILE=/path/to/custom-ca.crt
export REQUESTS_CA_BUNDLE=/path/to/custom-ca.crt

# 在Claude配置中
{
  "env": {
    "SSL_CERT_FILE": "/path/to/custom-ca.crt"
  }
}

# 使用国内镜像源
export CLAUDE_CODE_MIRROR=https://mirrors.tuna.tsinghua.edu.cn/claude-code

# 下载时使用镜像
curl -LO $CLAUDE_CODE_MIRROR/releases/latest/download/ClaudeCode-macos-x64.zip

# 使用私有GitHub仓库
export GITHUB_MIRROR=https://github.internal.com

# 配置Git使用私有仓库
git config --global url."https://github.internal.com/".insteadOf "https://github.com/"

#!/bin/bash
# enterprise-deploy.sh

# 企业Claude Code部署脚本

set -e

INSTALL_DIR="/opt/claude-code"
VERSION=${1:-"latest"}
ARCH=$(uname -m)

echo "🏢 企业Claude Code部署 v$VERSION"

# 1. 下载安装包
download_package() {
  local version=$1
  local arch=$2
  
  case $arch in
    x86_64)
      ARCH="x64"
      ;;
    aarch64|arm64)
      ARCH="arm64"
      ;;
    *)
      echo "❌ 不支持的架构: $arch"
      exit 1
      ;;
  esac
  
  echo "📥 下载Claude Code v$version ($ARCH)..."
  
  # 从内部镜像下载
  curl -LO "https://mirror.internal.com/claude-code/releases/$version/ClaudeCode-linux-$ARCH.tar.gz"
}

# 2. 验证完整性
verify_package() {
  local package=$1
  
  echo "🔍 验证包完整性..."
  
  # 检查SHA256
  if [ -f "$package.sha256" ]; then
    sha256sum -c "$package.sha256"
  else
    echo "⚠️ 无SHA256校验文件，跳过验证"
  fi
}

# 3. 安装
install_package() {
  local package=$1
  
  echo "🔧 安装Claude Code..."
  
  # 解压
  tar -xzf $package
  
  # 安装到/opt
  sudo mkdir -p $INSTALL_DIR
  sudo cp -r claude-code/* $INSTALL_DIR/
  
  # 创建符号链接
  sudo ln -sf $INSTALL_DIR/bin/claude /usr/local/bin/claude
  
  # 设置权限
  sudo chmod +x $INSTALL_DIR/bin/claude
}

# 4. 配置
configure_claude() {
  echo "⚙️ 配置Claude Code..."
  
  # 创建配置目录
  sudo mkdir -p /etc/claude-code
  
  # 复制企业配置
  sudo cp enterprise-settings.json /etc/claude-code/settings.json
  
  # 设置权限
  sudo chmod 644 /etc/claude-code/settings.json
}

# 5. 验证
verify_installation() {
  echo "✅ 验证安装..."
  
  if command -v claude > /dev/null; then
    echo "✅ Claude Code已安装"
    claude --version
  else
    echo "❌ 安装失败"
    exit 1
  fi
  
  # 运行诊断
  claude doctor
}

# 主流程
main() {
  echo "开始企业部署..."
  
  # 下载安装包
  download_package $VERSION $ARCH
  
  # 验证
  verify_package "ClaudeCode-linux-$ARCH.tar.gz"
  
  # 安装
  install_package "ClaudeCode-linux-$ARCH.tar.gz"
  
  # 配置
  configure_claude
  
  # 验证
  verify_installation
  
  echo "🎉 企业部署完成"
}

main "$@"

# 组策略配置脚本

# 1. 下载Claude Code
$Version = "latest"
$Architecture = "x64"
$DownloadUrl = "https://mirror.internal.com/claude-code/releases/$Version/ClaudeCode-windows-$Architecture.zip"

# 2. 安装到Program Files
$InstallPath = "C:\Program Files\ClaudeCode"
$TempPath = "C:\Temp\ClaudeCode"

# 创建临时目录
New-Item -ItemType Directory -Path $TempPath -Force | Out-Null

# 下载
Invoke-WebRequest -Uri $DownloadUrl -OutFile "$TempPath\ClaudeCode.zip"

# 解压
Expand-Archive -Path "$TempPath\ClaudeCode.zip" -DestinationPath $InstallPath -Force

# 添加到系统PATH
$CurrentPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
$NewPath = $CurrentPath + ";$InstallPath\bin"
[Environment]::SetEnvironmentVariable("Path", $NewPath, "Machine")

# 创建桌面快捷方式
$ShortcutPath = "$env:Public\Desktop\Claude Code.lnk"
$TargetPath = "$InstallPath\bin\claude.exe"
$WScriptShell = New-Object -ComObject WScript.Shell
$Shortcut = $WScriptShell.CreateShortcut($ShortcutPath)
$Shortcut.TargetPath = $TargetPath
$Shortcut.Save()

# 验证安装
claude --version

# Dockerfile - Claude Code容器化部署

FROM ubuntu:22.04

# 设置环境变量
ENV DEBIAN_FRONTEND=noninteractive
ENV CLAUDE_CODE_VERSION=latest

# 安装依赖
RUN apt-get update && apt-get install -y \
    curl \
    unzip \
    tar \
    git \
    python3 \
    nodejs \
    npm \
    && rm -rf /var/lib/apt/lists/*

# 下载Claude Code
RUN curl -LO "https://mirror.internal.com/claude-code/releases/$CLAUDE_CODE_VERSION/ClaudeCode-linux-x64.tar.gz" && \
    tar -xzf ClaudeCode-linux-x64.tar.gz && \
    mv claude-code /opt/claude-code && \
    ln -s /opt/claude-code/bin/claude /usr/local/bin/claude && \
    rm ClaudeCode-linux-x64.tar.gz

# 创建非root用户
RUN useradd -m -s /bin/bash claude

# 创建配置目录
RUN mkdir -p /home/claude/.claude && \
    chown -R claude:claude /home/claude/.claude

# 切换到非root用户
USER claude

# 工作目录
WORKDIR /home/claude

# 启动命令
ENTRYPOINT ["claude"]

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

# 运行容器
docker run -it --rm \
  -v $(pwd):/workspace \
  -v ~/.claude:/home/claude/.claude \
  claude-code:latest

# 使用代理
docker run -it --rm \
  -e HTTP_PROXY=http://proxy.example.com:8080 \
  -e HTTPS_PROXY=http://proxy.example.com:8080 \
  -v $(pwd):/workspace \
  claude-code:latest

# 检查网络连接
curl -v https://install.claude.ai

# 检查DNS解析
nslookup install.claude.ai

# 检查端口连通性
telnet install.claude.ai 443

# 检查安装目录权限
ls -ld /usr/local/bin
ls -ld /Applications

# 修复权限
sudo chown -R $(whoami) /usr/local/bin
sudo chmod +w /usr/local/bin

# Linux依赖检查
ldd /opt/claude-code/bin/claude

# 安装缺失的依赖
# Ubuntu/Debian
sudo apt-get install -f

# CentOS/RHEL  
sudo yum install -y glibc libstdc++

# macOS依赖
brew install git node python

# 测试代理连接
curl -v --proxy http://proxy.example.com:8080 https://install.claude.ai

# 检查代理环境变量
env | grep -i proxy

# 测试直接连接
curl -v --noproxy "*" https://install.claude.ai

# 检查文件完整性
sha256sum ClaudeCode-linux-x64.tar.gz

# 检查文件权限
ls -lh ClaudeCode-linux-x64.tar.gz

# 验证解压
tar -tzf ClaudeCode-linux-x64.tar.gz | head -5