Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
이 문서는 OpenShift 환경에서 개발 작업을 자동화하는 Claude Code 플러그인 모음(ai-helpers) 사용법을 안내합니다. 마켓플레이스 추가, 플러그인 설치 및 업데이트 방법과 자동 카탈로그 동기화 설정 방법을 설명하고 있습니다. 또한, OpenCode, Gemini, Cursor 등 다른 코딩 에이전트와의 연동 방안과 컨테이너를 이용한 배포 가이드도 제공합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기다양한 개발 작업을 자동화하고 지원하기 위한 Claude Code 플러그인 모음입니다.
마켓플레이스 추가:
/plugin marketplace add openshift-eng/ai-helpers
플러그인 설치:
/plugin install jira@ai-helpers
명령어 사용:
/jira:solve OCPBUGS-12345 origin
최신 플러그인 버전을 받으려면:
마켓플레이스 업데이트 (최신 플러그인 카탈로그 가져오기):
/plugin marketplace update ai-helpers
플러그인 재설치 (새 버전 다운로드):
/plugin install <plugin>@ai-helpers
세션마다 마켓플레이스 카탈로그를 자동으로 동기화하려면 SessionStart 훅을 추가하세요. 프로젝트의 .claude/settings.json에 다음 내용을 추가합니다:
{
"hooks": {
"SessionStart": [
...
참고: 이것은 카탈로그(사용 가능한 항목)만 새로 고칩니다. 실제로 설치된 플러그인을 새 버전으로 업데이트하려면 여전히 /plugin install <plugin>@ai-helpers로 재설치해야 합니다.
OpenCode, Gemini, Cursor와 같은 코딩 에이전트는 Agent Package Manager (APM)를 사용하여 Claude Code 플러그인을 사용할 수 있습니다.
예시 apm.yml:
name: my-project
version: 1.0.0
description: My project is great.
...
그런 다음 apm install을 실행합니다. 이는 프로젝트에만 설치하거나 --global 범위로 설치할 수 있습니다.
Claude Code와 모든 플러그인이 미리 설치된 컨테이너가 제공됩니다. 이는 주로 OpenShift CI에서 사용하기 위한 것입니다.
이미지에는 두 개의 Claude Code 바이너리가 포함되어 있습니다:
claude (기본 진입점) — stable RPM 채널에서 설치됨claude-latest — 최신 기능 테스트 또는 버전 간 동작 비교를 위해 latest RPM 채널에서 설치됨podman build -f images/Dockerfile -t ai-helpers .
Claude Code를 Google Cloud의 Vertex AI와 함께 사용하려면, gcloud 자격 증명을 전달하고 필요한 환경 변수를 설정해야 합니다:
podman run -it \
-e CLAUDE_CODE_USE_VERTEX=1 \
-e CLOUD_ML_REGION=your-ml-region \
...
환경 변수:
CLAUDE_CODE_USE_VERTEX=1 - Vertex AI 통합 활성화CLOUD_ML_REGION - 사용자의 GCP 리전 (예: us-east5)ANTHROPIC_VERTEX_PROJECT_ID - 사용자의 GCP 프로젝트 ID볼륨 마운트:
-v ~/.config/gcloud:/home/claude/.config/gcloud:ro - gcloud 인증을 전달합니다 (읽기 전용)-v $(pwd):/workspace - 현재 디렉토리를 컨테이너 내부의 /workspace에 마운트합니다-p 또는 --print 플래그를 사용하여 대화형 세션에 진입하지 않고도 Claude Code 명령을 직접 실행할 수 있습니다:
podman run -it \
-e CLAUDE_CODE_USE_VERTEX=1 \
-e CLOUD_ML_REGION=your-ml-region \
...
이렇게 하면 다음 작업을 수행합니다:
/hello-world:echo 명령을 실행합니다.사용 가능한 모든 플러그인과 명령어의 전체 목록은 **AI Helpers Marketplace**를 참조하십시오.
직접 기여하거나 자신만의 플러그인을 만들고 싶으신가요? plugins/ 디렉토리에서 예시를 확인하세요.
명령어와 에이전트가 hello-world 참조 구현 플러그인에 제시된 섹션 구조 규칙을 따르도록 하십시오 (예시는 hello-world:echo를 참고하십시오).
플러그인, 명령어, 스킬 및 훅은 스타일적 예시로 사용되더라도 실제 사람의 이름을 절대 언급해서는 안 됩니다 (예: "<특정 인물>의 스타일로").
윤리적 근거:
대신, 구체적인 특성을 명시적으로 설명하세요
좋은 예시:
원하는 특성(명료성, 간결성, 격식 등)을 식별할 때, 사람을 대리인으로 사용하기보다 명시적으로 설명하세요.
먼저 중복 여부를 확인하세요 - 코딩하기 전에 아이디어를 검증하세요:
/utils:review-ai-helpers-overlap --idea "명령어에 대한 간략한 설명"
중복이 발견되면 병렬적인 노력을 반복하는 대신 기존 작업과 협력하는 것이 항상 권장됩니다. 이는 이렇게 활발하게 개발되는 프로젝트에서 깨끗하고 중복되지 않는 플러그인 모음을 유지하는 데 도움이 됩니다 (자세한 사용법은 /utils:review-ai-helpers-overlap를 참조하세요).
새로운 명령어를 기여할 때:
commands/ 디렉토리에 추가합니다.plugins/utils/commands/)에 추가합니다.
관련된 여러 명령어를 포함하여 자체적인 플러그인이 필요하다면:
plugins/ 아래에 플러그인 이름으로 새 디렉토리를 만듭니다.plugins/your-plugin/
├── .claude-plugin/
│ └── plugin.json
...
3. `.claude-plugin/marketplace.json`에 플러그인을 등록합니다.
### 플러그인 유효성 검사 (Validating Plugins)
이 저장소는 [skillsaw](https://github.com/stbenjam/skillsaw)를 사용하여 플러그인 구조를 검증합니다:
```bash
make lint
site/requirements.txt에서 의존성을 설치한 후, 다음 명령어를 실행합니다:
make site-serve
MkDocs 사이트는 http://127.0.0.1:8000/ai-helpers/에서 이용 가능하며, GitHub Pages는 main 브랜치에 변경 사항이 병합된 후 동일한 생성 콘텐츠를 빌드합니다.
자세한 내용은 LICENSE를 참조하세요.