# vscode-server-cc-cli

**Repository Path**: henryqi91/vscode-server-cc-cli

## Basic Information

- **Project Name**: vscode-server-cc-cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-03
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# VSCode Server with Claude CLI 部署项目

本项目提供基于 Docker 和 Kubernetes 的 VSCode Server 部署方案，集成了 Anthropic Claude CLI 工具，支持多用户场景，并包含 Nginx 反向代理配置。

## 功能特性

- **Docker 容器化部署**：基于 linuxserver/code-server 镜像，预装 Claude CLI
- **Kubernetes 编排支持**：提供完整的多用户部署模板
- **开箱即用**：预配置 VSCode 设置、快捷键和 Claude 集成
- **SSL/HTTPS 支持**：Nginx 配置及证书自动生成脚本
- **用户管理工具**：Kubernetes 环境下用户创建/删除脚本

## 目录结构

```
├── Dockerfile                 # Docker 镜像构建文件
├── docker-compose.yml        # Docker Compose 配置
├── claude-settings.md        # Claude CLI 配置说明
├── config/
│   ├── claude.json          # Claude CLI 配置
│   ├── claude-settings.json # Claude 设置
│   ├── keybindings.json     # VSCode 快捷键配置
│   └── settings.json        # VSCode 全局设置
├── scripts/
│   └── init.sh              # 容器初始化脚本
├── nginx/
│   ├── generate-certs.sh    # SSL 证书生成脚本
│   └── nginx.conf           # Nginx 配置
├── k8s/                     # Kubernetes 部署模板
│   ├── all-in-one.yaml      # 一键部署配置
│   ├── configmap.yaml       # ConfigMap 配置
│   ├── deployment-template.yaml
│   ├── ingress-template.yaml
│   ├── namespace.yaml
│   ├── pvc-template.yaml
│   ├── secret.yaml
│   ├── service-template.yaml
│   ├── tls-secret.yaml
│   ├── setup.sh             # K8s 环境初始化脚本
│   ├── create-user.sh       # 创建用户脚本
│   ├── delete-user.sh       # 删除用户脚本
│   ├── users-5pods.yaml      # 5用户部署示例
│   └── user-test01.yaml      # 单用户部署示例
└── test-new-api/            # API 测试脚本
    ├── query_token.sh       # Token 查询脚本
    └── test_api.sh          # API 测试脚本
```

## 快速开始

### Docker 部署

```bash
# 构建并启动
docker-compose up -d

# 访问地址
http://localhost:8443
```

### 环境变量配置

复制 `.env.example` 为 `.env` 并修改：

```bash
cp .env.example .env
```

### 初始配置

1. 安装 Claude CLI：
   ```bash
   npm install -g @anthropic-ai/claude-code
   ```

2. 配置认证：编辑 `~/.claude/settings.json` 和 `~/.claude.json`

3. 在终端运行 `claude` 启动 CLI

## Kubernetes 部署

### 前提条件

- Kubernetes 集群
- kubectl 配置完成
- Ingress Controller（如 Nginx Ingress）

### 部署步骤

```bash
# 1. 创建命名空间
kubectl apply -f k8s/namespace.yaml

# 2. 创建密钥和配置
kubectl apply -f k8s/secret.yaml
kubectl apply -f k8s/configmap.yaml
kubectl apply -f k8s/tls-secret.yaml

# 3. 部署应用
kubectl apply -f k8s/deployment-template.yaml
kubectl apply -f k8s/service-template.yaml

# 4. 配置 Ingress
kubectl apply -f k8s/ingress-template.yaml
```

### 用户管理

```bash
# 创建用户
./k8s/create-user.sh <USER_ID> <DOMAIN> <NAMESPACE>

# 删除用户
./k8s/delete-user.sh <USER_ID>
```

### 批量部署

```bash
# 部署 5 个用户实例
kubectl apply -f k8s/users-5pods.yaml
```

## Nginx SSL 配置

### 生成自签名证书

```bash
cd nginx
./generate-certs.sh
```

### 配置说明

- `nginx/nginx.conf`：VSCode Server 反向代理配置
- 支持 SSL/TLS 加密
- 包含 WebSocket 代理配置（用于 VSCode 实时连接）

## 配置说明

### VSCode 设置

主要配置项位于 `config/settings.json`，包括：

- 字体大小和主题
- 编辑器行为
- 扩展管理
- 终端集成

### Claude CLI 集成

通过 `scripts/init.sh` 在容器启动时自动配置 Claude CLI 环境。

## API 测试

```bash
# 查询 Token
cd test-new-api
./query_token.sh

# 测试 API 接口
./test_api.sh
```

## 端口说明

| 端口 | 用途 |
|------|------|
| 8443 | VSCode Server Web 界面 |

## 许可证

本项目遵循相关开源许可证。