---
title: "GitHub 仓库处理"
description: "处理公共仓库： ```bash # 使用完整 URL repomix --remote https://github.com/user/repo"
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/remote-repository-processing-13
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:37:36.455Z
license: CC-BY-4.0
attribution: "GitHub 仓库处理 — Claudary (https://claudary.paisolsolutions.com/skills/remote-repository-processing-13)"
---

# GitHub 仓库处理
处理公共仓库： ```bash # 使用完整 URL repomix --remote https://github.com/user/repo

## Overview

# GitHub 仓库处理

## 基本用法

处理公共仓库：
```bash
# 使用完整 URL
repomix --remote https://github.com/user/repo

# 使用 GitHub 简写
repomix --remote user/repo
```

## 分支和提交选择

```bash
# 指定分支
repomix --remote user/repo --remote-branch main

# 指定标签
repomix --remote user/repo --remote-branch v1.0.0

# 指定提交哈希
repomix --remote user/repo --remote-branch 935b695
```

## 系统要求

- 必须安装 Git
- 需要网络连接
- 需要仓库的读取权限

## 输出控制

```bash
# 自定义输出位置
repomix --remote user/repo -o custom-output.xml

# 使用 XML 格式
repomix --remote user/repo --style xml

# 移除注释
repomix --remote user/repo --remove-comments
```

## Docker 使用方法

```bash
# 在当前目录处理并输出
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix \\
  --remote user/repo

# 输出到指定目录
docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix \\
  --remote user/repo
```

## 安全性

出于安全考虑，远程仓库中的配置文件（`repomix.config.*`）默认不会被加载。这可以防止不受信任的仓库通过 `repomix.config.ts` 等配置文件执行代码。

你的全局配置和 CLI 选项仍然会正常生效。

如需信任远程仓库的配置：

```bash
# 使用 CLI 标志
repomix --remote user/repo --remote-trust-config

# 使用环境变量
REPOMIX_REMOTE_TRUST_CONFIG=true repomix --remote user/repo
```

在 `--remote` 模式下使用 `--config` 时，必须指定绝对路径：

```bash
repomix --remote user/repo --config /home/user/repomix.config.json
```

## 常见问题

### 访问问题
- 确保仓库是公开的
- 检查 Git 是否已安装
- 验证网络连接

### 大型仓库处理
- 使用 `--include` 选择特定路径
- 启用 `--remove-comments`
- 分开处理不同分支

## 相关资源

- [命令行选项](/zh-cn/guide/command-line-options) - 完整的 CLI 参考，包括 `--remote` 选项
- [配置](/zh-cn/guide/configuration) - 为远程处理设置默认选项
- [代码压缩](/zh-cn/guide/code-compress) - 为大型仓库减少输出大小
- [安全](/zh-cn/guide/security) - Repomix 如何处理敏感数据检测

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/remote-repository-processing-13) · https://claudary.paisolsolutions.com