claude-secure-installer

Claude Secure Installer

🔐 通过mTLS代理安全安装Claude Code的npm包

功能特性

• ✅ 自动证书管理 - 自动生成客户端证书用于mTLS认证
• ✅ 代理配置 - 自动配置npm使用安全代理
• ✅ 一键安装 - 完整的安装流程自动化
• ✅ 多种模式 - 支持快速安装、自定义安装、手动配置
• ✅ 安全清理 - 安装完成后自动清理临时配置

快速开始

安装npm包

npm install -g @yourcompany/claude-secure-installer

一键安装Claude Code

# 使用默认配置快速安装
claude-secure install

# 或者使用自定义配置
claude-secure install --proxy https://your-proxy:3130 --cert-path ./mycerts

使用方法

1. 快速安装（推荐）

# 一键安装，使用默认配置
claude-secure install

这会自动：

• 生成客户端证书
• 配置npm代理设置
• 安装Claude Code
• 清理临时配置

2. 分步安装

# Step 1: 生成客户端证书
claude-secure setup-certs \
  --server-cert /path/to/server.crt \
  --server-key /path/to/server.key \
  --output ./certs

# Step 2: 配置npm代理
claude-secure config \
  --proxy https://8.216.35.106:3130 \
  --cert-path ./certs

# Step 3: 安装Claude Code
npm install -g @anthropic-ai/claude-code

3. 编程方式使用

const { oneClickInstall, quickInstall } = require('@yourcompany/claude-secure-installer');

// 快速安装
await quickInstall();

// 自定义安装
await oneClickInstall({
  proxyUrl: 'https://your-proxy:3130',
  certPath: './mycerts',
  serverCert: '/path/to/server.crt',
  serverKey: '/path/to/server.key',
  cleanup: true
});

命令行选项

claude-secure install

选项	描述	默认值
-p, --proxy <url>	代理服务器地址	https://8.216.35.106:3130
-c, --cert-path <path>	证书文件路径	./certs
--skip-cert-setup	跳过证书设置	false

claude-secure setup-certs

选项	描述	默认值
-s, --server-cert <path>	服务器证书路径	必须
-k, --server-key <path>	服务器私钥路径	必须
-o, --output <path>	输出目录	./certs

claude-secure config

选项	描述	默认值
-p, --proxy <url>	代理服务器地址	https://8.216.35.106:3130
-c, --cert-path <path>	证书文件路径	./certs

工作原理

mTLS代理认证流程

• 证书生成: 使用服务器CA证书生成客户端证书
• npm配置: 配置npm使用客户端证书和代理
• 安全连接: npm通过mTLS连接到代理服务器
• 包安装: 通过代理下载并安装Claude Code

安全特性

• 🔐 双向SSL认证 - 客户端和服务器都需要验证身份
• 🛡️ 证书管控 - 只有持有有效证书的客户端才能访问
• 🚫 中间人攻击防护 - mTLS防止网络窃听和篡改
• 🧹 配置清理 - 安装完成后自动清理敏感配置

文件结构

安装完成后会生成以下文件：

certs/
├── client.crt    # 客户端证书
├── client.key    # 客户端私钥
└── ca.crt        # CA证书（服务器证书副本）

故障排除

常见问题

Q: 连接超时或拒绝连接

A: 检查代理服务器是否启动，防火墙是否开放端口

Q: 证书验证失败

A: 确保客户端证书由正确的CA签发，检查证书路径

Q: npm配置错误

A: 运行 claude-secure config 重新配置代理设置

手动清理配置

如果需要手动清理npm配置：

npm config delete proxy
npm config delete https-proxy
npm config delete cert
npm config delete key
npm config delete ca
npm config set strict-ssl true

开发和调试

本地开发

# 克隆项目
git clone https://github.com/yourcompany/claude-secure-installer.git

# 安装依赖
cd claude-secure-installer
npm install

# 本地测试
npm link
claude-secure --help

调试模式

# 启用详细输出
DEBUG=claude-secure* claude-secure install

许可证

MIT License

支持

如有问题请提交 GitHub Issues