# 9. 지원 AI 도구 및 통합
← [[openspec-08-customization|8. 커스터마이징]] | 다음 → [[openspec-10-advanced-usage-patterns|10. 고급 사용 패턴]]
---
## 9.1 전체 지원 도구 목록
| 카테고리 | 도구 (init --tools ID) |
|----------|----------------------|
| Anthropic | Claude Code (`claude`) |
| Microsoft | GitHub Copilot (`github-copilot`) |
| Editor | Cursor (`cursor`), Windsurf (`windsurf`), Trae (`trae`) |
| AWS | Amazon Q Developer (`amazon-q`), Kiro (`kiro`) |
| Google | Gemini CLI (`gemini`) |
| Open Source | Cline (`cline`), Continue (`continue`), RooCode (`roocode`), Kilo Code (`kilocode`), OpenCode (`opencode`), Qwen Code (`qwen`) |
| Enterprise | IBM Bob Shell (`bob`), Lingma (`lingma`), CodeBuddy (`codebuddy`), CoStrict (`costrict`) |
| 기타 | Codex (`codex`), Factory Droid (`factory`), Auggie (`auggie`), Crush (`crush`), Pi (`pi`), Junie (`junie`), ForgeCode (`forgecode`), iFlow (`iflow`), Qoder (`qoder`), Antigravity (`antigravity`), Kimi CLI (`kimi`) |
> [!info] 30종 이상의 AI 도구 지원
> `openspec init` 실행 시 사용할 도구를 선택하면 해당 도구에 맞는 설정 파일이 자동 생성된다.
## 9.2 도구별 명령어 문법 비교
도구마다 슬래시 명령어 호출 방식이 다르다.
| 도구 | 명령어 문법 | 예시 |
|------|------------|------|
| Claude Code | `/opsx:propose` | `/opsx:propose add-dark-mode` |
| Cursor | `/opsx-propose` | `/opsx-propose add-dark-mode` |
| Windsurf | `/opsx-propose` | `/opsx-propose add-dark-mode` |
| GitHub Copilot | `/opsx-propose` | `/opsx-propose add-dark-mode` |
| Continue | `/opsx-propose` | `/opsx-propose add-dark-mode` |
| Kimi CLI | `/skill:openspec-propose` | `/skill:openspec-propose add-dark-mode` |
| ForgeCode | 스킬 패널 | 도구 내 스킬 패널에서 호출 |
| Trae | 스킬 패널 | 도구 내 스킬 패널에서 호출 |
## 9.3 도구별 설치 파일 위치
`openspec init --tools <도구>` 실행 시 생성되는 파일 경로:
| 도구 | 스킬 경로 | 명령어 경로 |
|------|----------|------------|
| Claude Code | `.claude/skills/openspec-*/SKILL.md` | `.claude/commands/opsx/<id>.md` |
| Cursor | `.cursor/skills/openspec-*/SKILL.md` | `.cursor/commands/opsx-<id>.md` |
| GitHub Copilot | `.github/skills/openspec-*/SKILL.md` | `.github/prompts/opsx-<id>.prompt.md`† |
| Windsurf | `.windsurf/skills/openspec-*/SKILL.md` | `.windsurf/workflows/opsx-<id>.md` |
| Continue | `.continue/skills/openspec-*/SKILL.md` | `.continue/prompts/opsx-<id>.prompt` |
| Cline | `.cline/skills/openspec-*/SKILL.md` | `.clinerules/workflows/opsx-<id>.md` |
| Amazon Q | `.amazonq/skills/openspec-*/SKILL.md` | `.amazonq/prompts/opsx-<id>.md` |
| Gemini CLI | `.gemini/skills/openspec-*/SKILL.md` | `.gemini/commands/opsx/<id>.toml` |
| RooCode | `.roo/skills/openspec-*/SKILL.md` | `.roo/commands/opsx-<id>.md` |
| Kiro | `.kiro/skills/openspec-*/SKILL.md` | `.kiro/prompts/opsx-<id>.prompt.md` |
| Codex | `.codex/skills/openspec-*/SKILL.md` | `$CODEX_HOME/prompts/opsx-<id>.md`‡ |
| Kimi CLI | `.kimi/skills/openspec-*/SKILL.md` | 미생성 (스킬 기반 `/skill:openspec-*`) |
| Trae | `.trae/skills/openspec-*/SKILL.md` | 미생성 (스킬 기반 `/openspec-*`) |
| ForgeCode | `.forge/skills/openspec-*/SKILL.md` | 미생성 (스킬 기반 `/openspec-*`) |
| Antigravity | `.agent/skills/openspec-*/SKILL.md` | `.agent/workflows/opsx-<id>.md` |
| Auggie | `.augment/skills/openspec-*/SKILL.md` | `.augment/commands/opsx-<id>.md` |
| CoStrict | `.cospec/skills/openspec-*/SKILL.md` | `.cospec/openspec/commands/opsx-<id>.md` |
| Crush | `.crush/skills/openspec-*/SKILL.md` | `.crush/commands/opsx/<id>.md` |
† GitHub Copilot 명령어 파일은 IDE 확장(VS Code, JetBrains, Visual Studio)에서만 동작. Copilot CLI 미지원.
‡ Codex 명령어는 프로젝트 디렉터리가 아닌 전역 Codex 홈(`$CODEX_HOME/prompts/`)에 설치됨.
> [!note] 스킬과 명령어 파일 수는 프로필에 따라 달라진다
> Core 프로필은 5개, 확장 프로필 전체 활성화 시 최대 11개 스킬이 생성된다.
## 9.4 Claude Code 통합 상세
`openspec init --tools claude` 실행 후 생성 파일:
**Core 프로필 (기본):**
```
.claude/
├── skills/
│ ├── openspec-propose/SKILL.md
│ ├── openspec-explore/SKILL.md
│ ├── openspec-apply/SKILL.md
│ ├── openspec-sync/SKILL.md
│ └── openspec-archive/SKILL.md
└── commands/opsx/
├── propose.md
├── explore.md
├── apply.md
├── sync.md
└── archive.md
```
**확장 프로필 전체 활성화 시 추가 생성되는 스킬:**
| 스킬 파일 | 대응 슬래시 명령어 |
|-----------|-------------------|
| `openspec-new-change/SKILL.md` | `/opsx:new` |
| `openspec-continue-change/SKILL.md` | `/opsx:continue` |
| `openspec-ff-change/SKILL.md` | `/opsx:ff` |
| `openspec-verify-change/SKILL.md` | `/opsx:verify` |
| `openspec-bulk-archive-change/SKILL.md` | `/opsx:bulk-archive` |
| `openspec-onboard/SKILL.md` | `/opsx:onboard` |
**Claude Code에서 명령어 호출:**
```
/opsx:propose add-feature
```
> [!tip] 확장 프로필 활성화
> ```bash
> openspec config profile # 대화형으로 확장 명령어 활성화
> openspec update # 변경 사항 파일 반영
> ```
> 확장 프로필 활성화 후 `/opsx:new`, `/opsx:ff`, `/opsx:verify` 등 추가 명령어를 사용할 수 있다.
## 9.5 도구 추가 / 변경
```bash
# 새 도구 추가 (기존 파일 유지)
openspec init --tools windsurf
# 여러 도구 동시 설정
openspec init --tools claude,cursor,github-copilot
# 모든 도구
openspec init --tools all
# AI 도구 파일 없이 OpenSpec 구조만 초기화
openspec init --tools none
# 도구 파일 최신화
openspec update
# CI 환경에서 강제 재설정
openspec init --force --tools claude --no-interactive
```
> [!note] `--tools none` 사용 시기
> AI 도구 슬래시 명령어 없이 OpenSpec 폴더 구조(`openspec/`)와 `config.yaml`만 생성하고 싶을 때 사용한다. 이후 `openspec init --tools <도구>`로 원하는 도구를 추가할 수 있다.
---
← [[openspec-08-customization|8. 커스터마이징]] | 다음 → [[openspec-10-advanced-usage-patterns|10. 고급 사용 패턴]]