Claude Code 및 Codex 외부 확장¶
Backend.AI GO는 호스트의 스킬과 에이전트를 원본에 연결하거나, 편집 가능한 복사본으로 가져올 수 있습니다. 외부 정의를 활성화하기 전에 내용을 검토하세요. 연결된 스킬을 사용하려면 현재 정의 버전도 승인해야 합니다. 항목 활성화와 정의 승인은 해당 스킬의 도구 호출을 승인하지 않습니다.
소스 연결¶
- 에이전트 확장에서 Connected sources를 연 뒤 Connect source를 선택합니다.
- Claude Code 또는 Codex를 고르고 실제
.claude또는.codex디렉터리를 선택합니다. 헤드리스 서버에서는 서버의 디렉터리를 선택합니다. - 연결한 뒤 발견된 항목을 검토합니다. 새 연결 항목은 비활성 상태로 시작합니다.
- 스킬을 열어 정의를 검토하고 해당 버전을 승인합니다. 사용할 항목을 활성화합니다. 일괄 활성화는 활성 상태만 바꿉니다.
Claude Code 연결은 skills/*/SKILL.md, commands/*.md, agents/*.md를 읽습니다. Codex 연결은 skills/*/SKILL.md, prompts/*.md, agents/*.toml을 읽습니다. 디렉터리를 연결해도 그 안의 지침 파일이 모든 실행에 적용되지는 않습니다. 지침 로딩은 작업공간 실행의 별도 설정입니다.
연결, 복사, 분리¶
| 모드 | 사용하는 내용 | 편집 및 업데이트 |
|---|---|---|
| 연결됨 | 현재 외부 정의 | 원본 파일을 편집하거나, 분리한 뒤 앱에서 편집 |
| 복사됨 | 가져온 앱 내부 복사본 | 앱에서 편집하며 원본 갱신은 명시적으로 다시 가져오기 |
| 분리됨 | 앱이 소유한 복사본 | 앱에서 편집하며 원본 변경을 따라가지 않음 |
연결된 정의는 확인할 때 읽고 실행 직전에 다시 검사합니다. 백그라운드 파일 감시기는 없습니다. 분리하면 항목의 식별자, 활성 상태, 사용자 정책을 유지하면서 현재 정의와 보조 파일을 복사합니다. 소스를 연결 해제하면 그 소스의 연결 항목만 제거하며, 복사하거나 분리한 항목은 남습니다.
스킬 편집기의 정의 탭은 스킬 본문과 frontmatter를 편집합니다. 보조 파일 탭은 스킬 디렉터리 아래의 스크립트와 파일을 관리합니다. 탭을 바꿔도 저장하지 않은 정의는 유지됩니다. 정의는 별도로 저장하세요. 연결된 스킬은 분리한 뒤 편집해야 합니다.
보조 파일은 최대 512개, 전체 항목 1,024개, 깊이 8, 파일당 16 MiB, 총 64 MiB로 제한됩니다. SKILL.md는 정의 편집기에서 관리합니다. 심볼릭 링크와 reparse 경로 우회는 거부합니다. 가져오기와 내보내기는 일반 Unix 실행 권한을 보존하고 특권 비트는 제거합니다.
변경과 이름 충돌¶
| 상태 | 의미 |
|---|---|
| 변경됨 | 이전 버전과 정의가 다릅니다. 연결된 스킬은 다시 검토하고 승인해야 사용할 수 있습니다 |
| 없음 | 원본 파일을 사용할 수 없어 실행할 수 없습니다 |
| 유효하지 않음 | 원본을 안전하게 읽거나 해석할 수 없습니다. 원본을 수정해야 합니다 |
| 가려짐 | 이름이 같은 다른 항목이 실행 우선순위에서 선택되었습니다 |
이름이 같은 스킬은 앱 소유 항목, Claude Code 항목, Codex 항목 순으로 우선합니다. 선택된 항목이 승인되지 않았거나 유효하지 않아도 가려진 정의를 대신 실행하지 않습니다. 작업공간 항목은 출처가 같은 전역 항목보다만 우선합니다.
연결된 스킬의 정의 승인은 정의 파일의 정확한 바이트를 대상으로 합니다. 보조 스크립트는 원본 디렉터리에서 계속 읽으며 이 해시의 승인 범위에 포함되지 않습니다. 정의를 바꾸면 승인이 무효화됩니다. 스킬의 allowed-tools는 일반 도구 승인이나 사용자의 도구 거부 정책을 우회할 수 없습니다.
설치된 Claude Code 플러그인¶
설치된 플러그인 소스 옵션을 선택하면 호스트에 이미 설치된 플러그인을 검색합니다. 표시된 버전을 확인하고 연결하세요. 플러그인의 스킬, 명령어, 에이전트는 연결 항목이 되며 비활성 상태로 시작합니다. 이 작업은 Claude Code에 새 플러그인을 설치하지 않습니다.
플러그인을 업그레이드한 뒤에는 Connect source를 열어 해당 설치 플러그인을 다시 연결하세요. 기존 소스와 안정적인 항목 식별자를 유지하면서 표시된 버전으로 갱신하며, 변경된 스킬 정의는 다시 승인해야 합니다. 연결 해제는 연결 항목을 제거하지만 Claude Code의 설치는 유지합니다. 플러그인 훅, 출력 스타일과 선언된 MCP 서버는 건너뛰고 지원하지 않는 자산으로 표시합니다.
호환성¶
도구 매핑은 이름을 Backend.AI GO의 도구로 변환합니다. 다른 앱의 권한 체계를 재현하지는 않습니다. 실제 사용 가능 여부는 현재 실행, 프로필 제한과 도구 승인에 따라 결정됩니다.
| 자산 또는 기능 | Backend.AI GO 지원 |
|---|---|
| Claude Code 스킬 | frontmatter와 보조 파일을 가진 스킬로 지원 |
| Claude Code 명령어 | 스킬로 매핑 |
| Claude Code 하위 에이전트 | 에이전트 프로필로 매핑, 위임은 별도 활성화 필요 |
| Codex 스킬 | 스킬로 지원 |
| Codex 프롬프트 | 스킬로 매핑 |
| Codex TOML 에이전트 | 에이전트 프로필로 매핑, 지원하는 추론 강도는 검증된 기본값으로 적용 |
| 설치된 플러그인의 스킬, 명령어, 에이전트 | 설치된 플러그인에서 명시적으로 연결, 플러그인 사본은 Claude Code 플러그인 탭에서 가져오기 |
| 플러그인 훅 | 건너뛰며 실행하지 않음 |
| 플러그인 출력 스타일 | 건너뜀 |
Read | read_file |
Write | write_file |
Edit | write_file |
MultiEdit | write_file |
Glob | search_files |
Grep | search_content |
Bash | run_shell, 런타임의 run_command 도구로 실행 |
WebFetch | fetch_url |
WebSearch | web_search |
AskUserQuestion | select_option |
Task | delegate, 위임 활성화 여부와 제한 적용 |
Agent | delegate, 위임 활성화 여부와 제한 적용 |
Skill | use_skill, 선택 및 버전 승인 적용 |
TodoWrite | 지원하지 않으며 원본 메타데이터에 보존 |
NotebookEdit | 지원하지 않으며 원본 메타데이터에 보존 |
mcp__* | 지원하지 않으며 원본 메타데이터에 보존 |
Codex shell | run_shell |
Codex read_file | read_file |
Codex apply_patch | write_file |
| 원본 모델 이름 | 힌트로만 보존하며 Backend.AI GO 실행 모델을 선택하지 않음 |
Bash(git *) 같은 인자 범위 | 정보로 보존하며 인자 허용 목록으로 강제하지 않음 |
연결된 allowed-tools 자동 승인 | 상속하지 않으며 일반 도구 승인 적용 |
${CLAUDE_SKILL_DIR} | 활성 스킬 디렉터리로 확장, 호스트 스크립트 실행에는 작업공간 모드와 셸 승인 필요 |
CLAUDE.md, AGENTS.md, 사용자 규칙 | 기본적으로 꺼진 작업공간 지침 로딩을 명시적으로 활성화 |
헤드리스 사용¶
소스 경로는 Backend.AI GO를 실행하는 컴퓨터의 경로입니다. ~/.claude, ~/.codex와 플러그인 검색은 서버 프로세스의 홈 디렉터리를 사용합니다. 브라우저에서 연결해도 브라우저 컴퓨터의 파일을 업로드하지 않습니다.
서버의 인증된 API로도 같은 소스 관리와 버전 승인을 사용할 수 있습니다. 연결과 인증 설정은 헤드리스 모드와 CLI 레퍼런스를 참조하세요. git, gh 또는 스크립트가 필요한 워크플로에는 서버의 실행 파일과 인증 정보, 승인된 호스트 작업공간이 필요합니다.