๋ง์ผํ๋ ์ด์ค๋ฅผ ํตํด ๋ฏธ๋ฆฌ ๋น๋๋ ํ๋ฌ๊ทธ์ธ ๋ฐ๊ฒฌ ๋ฐ ์ค์น
๋ง์ผํ๋ ์ด์ค์์ ํ๋ฌ๊ทธ์ธ์ ์ฐพ์ ์ค์นํ์ฌ Claude Code๋ฅผ ์๋ก์ด ๋ช ๋ น์ด, ์์ด์ ํธ ๋ฐ ๊ธฐ๋ฅ์ผ๋ก ํ์ฅํฉ๋๋ค.
ํ๋ฌ๊ทธ์ธ์ Claude Code๋ฅผ skills, agents, hooks ๋ฐ MCP servers๋ก ํ์ฅํฉ๋๋ค. ํ๋ฌ๊ทธ์ธ ๋ง์ผํ๋ ์ด์ค๋ ์ง์ ๋น๋ํ์ง ์๊ณ ๋ ์ด๋ฌํ ํ์ฅ ๊ธฐ๋ฅ์ ๋ฐ๊ฒฌํ๊ณ ์ค์นํ ์ ์๋๋ก ๋์์ฃผ๋ ์นดํ๋ก๊ทธ์ ๋๋ค.
์์ ์ ๋ง์ผํ๋ ์ด์ค๋ฅผ ๋ง๋ค๊ณ ๋ฐฐํฌํ๋ ค๊ณ ํ์๋์? ํ๋ฌ๊ทธ์ธ ๋ง์ผํ๋ ์ด์ค ๋ง๋ค๊ธฐ ๋ฐ ๋ฐฐํฌ๋ฅผ ์ฐธ์กฐํ์ธ์.
๋ง์ผํ๋ ์ด์ค ์๋ ๋ฐฉ์
๋ง์ผํ๋ ์ด์ค๋ ๋ค๋ฅธ ์ฌ๋์ด ๋ง๋ค์ด ๊ณต์ ํ ํ๋ฌ๊ทธ์ธ์ ์นดํ๋ก๊ทธ์ ๋๋ค. ๋ง์ผํ๋ ์ด์ค๋ฅผ ์ฌ์ฉํ๋ ๊ฒ์ ๋ ๋จ๊ณ์ ํ๋ก์ธ์ค์ ๋๋ค:
๋ง์ผํ๋ ์ด์ค ์ถ๊ฐ
์ด๋ ์นดํ๋ก๊ทธ๋ฅผ Claude Code์ ๋ฑ๋กํ์ฌ ์ฌ์ฉ ๊ฐ๋ฅํ ํญ๋ชฉ์ ๊ฒ์ํ ์ ์๋๋ก ํฉ๋๋ค. ์์ง ํ๋ฌ๊ทธ์ธ์ด ์ค์น๋์ง ์์ต๋๋ค.
๊ฐ๋ณ ํ๋ฌ๊ทธ์ธ ์ค์น
์นดํ๋ก๊ทธ๋ฅผ ๊ฒ์ํ๊ณ ์ํ๋ ํ๋ฌ๊ทธ์ธ์ ์ค์นํฉ๋๋ค.
์ฑ ์คํ ์ด๋ฅผ ์ถ๊ฐํ๋ ๊ฒ๊ณผ ๊ฐ๋ค๊ณ ์๊ฐํ๋ฉด ๋ฉ๋๋ค. ์คํ ์ด๋ฅผ ์ถ๊ฐํ๋ฉด ํด๋น ์ปฌ๋ ์ ์ ๊ฒ์ํ ์ ์์ง๋ง, ์ฌ์ ํ ๊ฐ๋ณ์ ์ผ๋ก ๋ค์ด๋ก๋ํ ์ฑ์ ์ ํํฉ๋๋ค.
๊ณต์ Anthropic ๋ง์ผํ๋ ์ด์ค
๊ณต์ Anthropic ๋ง์ผํ๋ ์ด์ค(claude-plugins-official)๋ Claude Code๋ฅผ ์์ํ ๋ ์๋์ผ๋ก ์ฌ์ฉ ๊ฐ๋ฅํฉ๋๋ค. /plugin์ ์คํํ๊ณ Discover ํญ์ผ๋ก ์ด๋ํ์ฌ ์ฌ์ฉ ๊ฐ๋ฅํ ํญ๋ชฉ์ ๊ฒ์ํ๊ฑฐ๋ claude.com/plugins์์ ์นดํ๋ก๊ทธ๋ฅผ ํ์ธํฉ๋๋ค.
๊ณต์ ๋ง์ผํ๋ ์ด์ค์์ ํ๋ฌ๊ทธ์ธ์ ์ค์นํ๋ ค๋ฉด /plugin install <name>@claude-plugins-official์ ์ฌ์ฉํฉ๋๋ค. ์๋ฅผ ๋ค์ด GitHub ํตํฉ์ ์ค์นํ๋ ค๋ฉด:
/plugin install github@claude-plugins-official
๊ณต์ ๋ง์ผํ๋ ์ด์ค๋ Anthropic์์ ์ ์ง ๊ด๋ฆฌํฉ๋๋ค. ๊ณต์ ๋ง์ผํ๋ ์ด์ค์ ํ๋ฌ๊ทธ์ธ์ ์ ์ถํ๋ ค๋ฉด ๋ค์ ์ฑ ๋ด ์ ์ถ ์์ ์ค ํ๋๋ฅผ ์ฌ์ฉํ์ธ์:
- Claude.ai: claude.ai/settings/plugins/submit
- Console: platform.claude.com/plugins/submit
ํ๋ฌ๊ทธ์ธ์ ๋ ๋ฆฝ์ ์ผ๋ก ๋ฐฐํฌํ๋ ค๋ฉด ์์ ์ ๋ง์ผํ๋ ์ด์ค๋ฅผ ๋ง๋ค๊ณ ์ฌ์ฉ์์ ๊ณต์ ํ์ธ์.
๊ณต์ ๋ง์ผํ๋ ์ด์ค์๋ ์ฌ๋ฌ ์นดํ ๊ณ ๋ฆฌ์ ํ๋ฌ๊ทธ์ธ์ด ํฌํจ๋์ด ์์ต๋๋ค:
์ฝ๋ ์ธํ ๋ฆฌ์ ์ค
์ฝ๋ ์ธํ ๋ฆฌ์ ์ค ํ๋ฌ๊ทธ์ธ์ Claude Code์ ๊ธฐ๋ณธ ์ ๊ณต LSP ๋๊ตฌ๋ฅผ ํ์ฑํํ์ฌ Claude๊ฐ ์ ์๋ก ์ด๋ํ๊ณ , ์ฐธ์กฐ๋ฅผ ์ฐพ์ผ๋ฉฐ, ํธ์ง ์งํ ํ์ ์ค๋ฅ๋ฅผ ๋ณผ ์ ์๋๋ก ํฉ๋๋ค. ์ด๋ฌํ ํ๋ฌ๊ทธ์ธ์ Language Server Protocol ์ฐ๊ฒฐ์ ๊ตฌ์ฑํ๋ฉฐ, ์ด๋ VS Code์ ์ฝ๋ ์ธํ ๋ฆฌ์ ์ค๋ฅผ ์ง์ํ๋ ๋์ผํ ๊ธฐ์ ์ ๋๋ค.
์ด๋ฌํ ํ๋ฌ๊ทธ์ธ์ ์ธ์ด ์๋ฒ ๋ฐ์ด๋๋ฆฌ๊ฐ ์์คํ ์ ์ค์น๋์ด ์์ด์ผ ํฉ๋๋ค. ์ด๋ฏธ ์ธ์ด ์๋ฒ๊ฐ ์ค์น๋์ด ์์ผ๋ฉด ํ๋ก์ ํธ๋ฅผ ์ด ๋ Claude๊ฐ ํด๋น ํ๋ฌ๊ทธ์ธ์ ์ค์นํ๋๋ก ์์ฒญํ ์ ์์ต๋๋ค.
| ์ธ์ด | ํ๋ฌ๊ทธ์ธ | ํ์ํ ๋ฐ์ด๋๋ฆฌ |
|---|---|---|
| C/C++ | clangd-lsp |
clangd |
| C# | csharp-lsp |
csharp-ls |
| Go | gopls-lsp |
gopls |
| Java | jdtls-lsp |
jdtls |
| Kotlin | kotlin-lsp |
kotlin-language-server |
| Lua | lua-lsp |
lua-language-server |
| PHP | php-lsp |
intelephense |
| Python | pyright-lsp |
pyright-langserver |
| Rust | rust-analyzer-lsp |
rust-analyzer |
| Swift | swift-lsp |
sourcekit-lsp |
| TypeScript | typescript-lsp |
typescript-language-server |
๋ค๋ฅธ ์ธ์ด๋ฅผ ์ํ ์์ ์ LSP ํ๋ฌ๊ทธ์ธ์ ๋ง๋ค ์๋ ์์ต๋๋ค.
ํ๋ฌ๊ทธ์ธ์ ์ค์นํ ํ /plugin Errors ํญ์์ Executable not found in $PATH๋ฅผ ๋ณด๋ฉด ์ ํ์์ ํ์ํ ๋ฐ์ด๋๋ฆฌ๋ฅผ ์ค์นํ์ธ์.
์ฝ๋ ์ธํ ๋ฆฌ์ ์ค ํ๋ฌ๊ทธ์ธ์ด Claude์ ์ ๊ณตํ๋ ๊ฒ
์ฝ๋ ์ธํ ๋ฆฌ์ ์ค ํ๋ฌ๊ทธ์ธ์ด ์ค์น๋๊ณ ํด๋น ์ธ์ด ์๋ฒ ๋ฐ์ด๋๋ฆฌ๋ฅผ ์ฌ์ฉํ ์ ์์ผ๋ฉด Claude๋ ๋ ๊ฐ์ง ๊ธฐ๋ฅ์ ์ป์ต๋๋ค:
- ์๋ ์ง๋จ: Claude๊ฐ ํ์ผ์ ํธ์งํ ๋๋ง๋ค ์ธ์ด ์๋ฒ๋ ๋ณ๊ฒฝ ์ฌํญ์ ๋ถ์ํ๊ณ ์ค๋ฅ ๋ฐ ๊ฒฝ๊ณ ๋ฅผ ์๋์ผ๋ก ๋ณด๊ณ ํฉ๋๋ค. Claude๋ ์ปดํ์ผ๋ฌ๋ ๋ฆฐํฐ๋ฅผ ์คํํ ํ์ ์์ด ํ์ ์ค๋ฅ, ๋๋ฝ๋ import ๋ฐ ๊ตฌ๋ฌธ ๋ฌธ์ ๋ฅผ ๋ด ๋๋ค. Claude๊ฐ ์ค๋ฅ๋ฅผ ๋์ ํ๋ฉด ๊ฐ์ ํด์์ ๋ฌธ์ ๋ฅผ ์์์ฐจ๋ฆฌ๊ณ ์์ ํฉ๋๋ค. ์ด๋ ํ๋ฌ๊ทธ์ธ ์ค์น ์ด์์ ๊ตฌ์ฑ์ด ํ์ํ์ง ์์ต๋๋ค. "์ง๋จ ๋ฐ๊ฒฌ๋จ" ํ์๊ธฐ๊ฐ ๋ํ๋ ๋ Ctrl+O๋ฅผ ๋๋ฌ ์ง๋จ์ ์ธ๋ผ์ธ์ผ๋ก ๋ณผ ์ ์์ต๋๋ค.
- ์ฝ๋ ๋ค๋น๊ฒ์ด์ : Claude๋ ์ธ์ด ์๋ฒ๋ฅผ ์ฌ์ฉํ์ฌ ์ ์๋ก ์ด๋ํ๊ณ , ์ฐธ์กฐ๋ฅผ ์ฐพ์ผ๋ฉฐ, ํธ๋ฒ ์ ํ์ ์ ๋ณด๋ฅผ ์ป๊ณ , ๊ธฐํธ๋ฅผ ๋์ดํ๊ณ , ๊ตฌํ์ ์ฐพ์ผ๋ฉฐ, ํธ์ถ ๊ณ์ธต์ ์ถ์ ํ ์ ์์ต๋๋ค. ์ด๋ฌํ ์์ ์ Claude์๊ฒ grep ๊ธฐ๋ฐ ๊ฒ์๋ณด๋ค ๋ ์ ํํ ๋ค๋น๊ฒ์ด์ ์ ์ ๊ณตํ์ง๋ง, ๊ฐ์ฉ์ฑ์ ์ธ์ด ๋ฐ ํ๊ฒฝ์ ๋ฐ๋ผ ๋ค๋ฅผ ์ ์์ต๋๋ค.
๋ฌธ์ ๊ฐ ๋ฐ์ํ๋ฉด ์ฝ๋ ์ธํ ๋ฆฌ์ ์ค ๋ฌธ์ ํด๊ฒฐ์ ์ฐธ์กฐํ์ธ์.
์ธ๋ถ ํตํฉ
์ด๋ฌํ ํ๋ฌ๊ทธ์ธ์ ๋ฏธ๋ฆฌ ๊ตฌ์ฑ๋ MCP servers๋ฅผ ๋ฒ๋ค๋ก ์ ๊ณตํ๋ฏ๋ก ์๋ ์ค์ ์์ด Claude๋ฅผ ์ธ๋ถ ์๋น์ค์ ์ฐ๊ฒฐํ ์ ์์ต๋๋ค:
- ์์ค ์ ์ด:
github,gitlab - ํ๋ก์ ํธ ๊ด๋ฆฌ:
atlassian(Jira/Confluence),asana,linear,notion - ๋์์ธ:
figma - ์ธํ๋ผ:
vercel,firebase,supabase - ์ปค๋ฎค๋์ผ์ด์
:
slack - ๋ชจ๋ํฐ๋ง:
sentry
๊ฐ๋ฐ ์ํฌํ๋ก์ฐ
์ผ๋ฐ์ ์ธ ๊ฐ๋ฐ ์์ ์ ์ํ ๋ช ๋ น์ด ๋ฐ ์์ด์ ํธ๋ฅผ ์ถ๊ฐํ๋ ํ๋ฌ๊ทธ์ธ:
- commit-commands: commit, push ๋ฐ PR ์์ฑ์ ํฌํจํ Git commit ์ํฌํ๋ก์ฐ
- pr-review-toolkit: pull request ๊ฒํ ๋ฅผ ์ํ ํนํ๋ ์์ด์ ํธ
- agent-sdk-dev: Claude Agent SDK๋ก ๋น๋ํ๊ธฐ ์ํ ๋๊ตฌ
- plugin-dev: ์์ ์ ํ๋ฌ๊ทธ์ธ์ ๋ง๋ค๊ธฐ ์ํ ๋๊ตฌ ๋ชจ์
์ถ๋ ฅ ์คํ์ผ
Claude๊ฐ ์๋ตํ๋ ๋ฐฉ์์ ์ฌ์ฉ์ ์ ์ํฉ๋๋ค:
- explanatory-output-style: ๊ตฌํ ์ ํ์ ๋ํ ๊ต์ก์ ํต์ฐฐ๋ ฅ
- learning-output-style: ๊ธฐ์ ์ต๋์ ์ํ ๋ํํ ํ์ต ๋ชจ๋
์๋ํด๋ณด๊ธฐ: ๋ฐ๋ชจ ๋ง์ผํ๋ ์ด์ค ์ถ๊ฐ
Anthropic์ ๋ํ ํ๋ฌ๊ทธ์ธ ์์คํ
์ผ๋ก ๊ฐ๋ฅํ ๊ฒ์ ๋ณด์ฌ์ฃผ๋ ์์ ํ๋ฌ๊ทธ์ธ์ด ์๋ ๋ฐ๋ชจ ํ๋ฌ๊ทธ์ธ ๋ง์ผํ๋ ์ด์ค(claude-code-plugins)๋ฅผ ์ ์ง ๊ด๋ฆฌํฉ๋๋ค. ๊ณต์ ๋ง์ผํ๋ ์ด์ค์ ๋ฌ๋ฆฌ ์ด ๋ง์ผํ๋ ์ด์ค๋ ์๋์ผ๋ก ์ถ๊ฐํด์ผ ํฉ๋๋ค.
๋ง์ผํ๋ ์ด์ค ์ถ๊ฐ
Claude Code ๋ด์์ anthropics/claude-code ๋ง์ผํ๋ ์ด์ค์ ๋ํด plugin marketplace add ๋ช
๋ น์ด๋ฅผ ์คํํฉ๋๋ค:
/plugin marketplace add anthropics/claude-code
์ด๋ ๋ง์ผํ๋ ์ด์ค ์นดํ๋ก๊ทธ๋ฅผ ๋ค์ด๋ก๋ํ๊ณ ํด๋น ํ๋ฌ๊ทธ์ธ์ ์ฌ์ฉ ๊ฐ๋ฅํ๊ฒ ํฉ๋๋ค.
์ฌ์ฉ ๊ฐ๋ฅํ ํ๋ฌ๊ทธ์ธ ๊ฒ์
/plugin์ ์คํํ์ฌ ํ๋ฌ๊ทธ์ธ ๊ด๋ฆฌ์๋ฅผ ์ฝ๋๋ค. ์ด๋ Tab(๋๋ ๋ค๋ก ๊ฐ๋ ค๋ฉด Shift+Tab)์ ์ฌ์ฉํ์ฌ ์ํํ ์ ์๋ ๋ค ๊ฐ์ ํญ์ด ์๋ ํญ ์ธํฐํ์ด์ค๋ฅผ ์ฝ๋๋ค:
- Discover: ๋ชจ๋ ๋ง์ผํ๋ ์ด์ค์์ ์ฌ์ฉ ๊ฐ๋ฅํ ํ๋ฌ๊ทธ์ธ ๊ฒ์
- Installed: ์ค์น๋ ํ๋ฌ๊ทธ์ธ ๋ณด๊ธฐ ๋ฐ ๊ด๋ฆฌ
- Marketplaces: ์ถ๊ฐ๋ ๋ง์ผํ๋ ์ด์ค ์ถ๊ฐ, ์ ๊ฑฐ ๋๋ ์ ๋ฐ์ดํธ
- Errors: ํ๋ฌ๊ทธ์ธ ๋ก๋ฉ ์ค๋ฅ ๋ณด๊ธฐ
๋ฐฉ๊ธ ์ถ๊ฐํ ๋ง์ผํ๋ ์ด์ค์ ํ๋ฌ๊ทธ์ธ์ ๋ณด๋ ค๋ฉด Discover ํญ์ผ๋ก ์ด๋ํฉ๋๋ค.
ํ๋ฌ๊ทธ์ธ ์ค์น
ํ๋ฌ๊ทธ์ธ์ ์ ํํ์ฌ ์ธ๋ถ ์ ๋ณด๋ฅผ ๋ณด๊ณ ์ค์น ๋ฒ์๋ฅผ ์ ํํฉ๋๋ค:
- User scope: ๋ชจ๋ ํ๋ก์ ํธ์์ ์์ ์ ์ํด ์ค์น
- Project scope: ์ด ์ ์ฅ์์ ๋ชจ๋ ํ๋ ฅ์๋ฅผ ์ํด ์ค์น
- Local scope: ์ด ์ ์ฅ์์์๋ง ์์ ์ ์ํด ์ค์น
์๋ฅผ ๋ค์ด commit-commands(git ์ํฌํ๋ก์ฐ ๋ช ๋ น์ด๋ฅผ ์ถ๊ฐํ๋ ํ๋ฌ๊ทธ์ธ)๋ฅผ ์ ํํ๊ณ ์ฌ์ฉ์ ๋ฒ์์ ์ค์นํฉ๋๋ค.
๋ช ๋ น์ค์์ ์ง์ ์ค์นํ ์๋ ์์ต๋๋ค:
/plugin install commit-commands@anthropics-claude-code
๋ฒ์์ ๋ํด ์์ธํ ์์๋ณด๋ ค๋ฉด ๊ตฌ์ฑ ๋ฒ์๋ฅผ ์ฐธ์กฐํ์ธ์.
์ ํ๋ฌ๊ทธ์ธ ์ฌ์ฉ
์ค์น ํ /reload-plugins๋ฅผ ์คํํ์ฌ ํ๋ฌ๊ทธ์ธ์ ํ์ฑํํฉ๋๋ค. ํ๋ฌ๊ทธ์ธ ๋ช
๋ น์ด๋ ํ๋ฌ๊ทธ์ธ ์ด๋ฆ์ผ๋ก ๋ค์์คํ์ด์ค๋๋ฏ๋ก commit-commands๋ /commit-commands:commit๊ณผ ๊ฐ์ ๋ช
๋ น์ด๋ฅผ ์ ๊ณตํฉ๋๋ค.
ํ์ผ์ ๋ณ๊ฒฝํ๊ณ ๋ค์์ ์คํํ์ฌ ์๋ํด๋ณด์ธ์:
/commit-commands:commit
์ด๋ ๋ณ๊ฒฝ ์ฌํญ์ ์คํ ์ด์งํ๊ณ , commit ๋ฉ์์ง๋ฅผ ์์ฑํ๋ฉฐ, commit์ ๋ง๋ญ๋๋ค.
๊ฐ ํ๋ฌ๊ทธ์ธ์ ๋ค๋ฅด๊ฒ ์๋ํฉ๋๋ค. Discover ํญ์ ํ๋ฌ๊ทธ์ธ ์ค๋ช ์ด๋ ํด๋น ํํ์ด์ง๋ฅผ ํ์ธํ์ฌ ์ ๊ณตํ๋ ๋ช ๋ น์ด ๋ฐ ๊ธฐ๋ฅ์ ์์๋ณด์ธ์.
์ด ๊ฐ์ด๋์ ๋๋จธ์ง ๋ถ๋ถ์์๋ ๋ง์ผํ๋ ์ด์ค๋ฅผ ์ถ๊ฐํ๊ณ , ํ๋ฌ๊ทธ์ธ์ ์ค์นํ๋ฉฐ, ๊ตฌ์ฑ์ ๊ด๋ฆฌํ๋ ๋ชจ๋ ๋ฐฉ๋ฒ์ ๋ค๋ฃน๋๋ค.
๋ง์ผํ๋ ์ด์ค ์ถ๊ฐ
/plugin marketplace add ๋ช
๋ น์ด๋ฅผ ์ฌ์ฉํ์ฌ ๋ค์ํ ์์ค์์ ๋ง์ผํ๋ ์ด์ค๋ฅผ ์ถ๊ฐํฉ๋๋ค.
๋ฐ๋ก๊ฐ๊ธฐ: /plugin marketplace ๋์ /plugin market์ ์ฌ์ฉํ ์ ์์ผ๋ฉฐ, remove ๋์ rm์ ์ฌ์ฉํ ์ ์์ต๋๋ค.
- GitHub ์ ์ฅ์:
owner/repoํ์(์:anthropics/claude-code) - Git URL: ๋ชจ๋ git ์ ์ฅ์ URL(GitLab, Bitbucket, ์์ฒด ํธ์คํ )
- ๋ก์ปฌ ๊ฒฝ๋ก: ๋๋ ํ ๋ฆฌ ๋๋
marketplace.jsonํ์ผ์ ๋ํ ์ง์ ๊ฒฝ๋ก - ์๊ฒฉ URL: ํธ์คํ
๋
marketplace.jsonํ์ผ์ ๋ํ ์ง์ URL
GitHub์์ ์ถ๊ฐ
.claude-plugin/marketplace.json ํ์ผ์ ํฌํจํ๋ GitHub ์ ์ฅ์๋ฅผ owner/repo ํ์์ ์ฌ์ฉํ์ฌ ์ถ๊ฐํฉ๋๋ค. ์ฌ๊ธฐ์ owner๋ GitHub ์ฌ์ฉ์ ์ด๋ฆ ๋๋ ์กฐ์ง์ด๊ณ repo๋ ์ ์ฅ์ ์ด๋ฆ์
๋๋ค.
์๋ฅผ ๋ค์ด anthropics/claude-code๋ anthropics๊ฐ ์์ ํ claude-code ์ ์ฅ์๋ฅผ ๋ํ๋
๋๋ค:
/plugin marketplace add anthropics/claude-code
๋ค๋ฅธ Git ํธ์คํธ์์ ์ถ๊ฐ
์ ์ฒด URL์ ์ ๊ณตํ์ฌ ๋ชจ๋ git ์ ์ฅ์๋ฅผ ์ถ๊ฐํฉ๋๋ค. ์ด๋ GitLab, Bitbucket ๋ฐ ์์ฒด ํธ์คํ ์๋ฒ๋ฅผ ํฌํจํ ๋ชจ๋ Git ํธ์คํธ์์ ์๋ํฉ๋๋ค:
HTTPS ์ฌ์ฉ:
/plugin marketplace add https://gitlab.com/company/plugins.git
SSH ์ฌ์ฉ:
/plugin marketplace add git@gitlab.com:company/plugins.git
ํน์ ๋ธ๋์น ๋๋ ํ๊ทธ๋ฅผ ์ถ๊ฐํ๋ ค๋ฉด # ๋ค์ ref๋ฅผ ์ถ๊ฐํฉ๋๋ค:
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
๋ก์ปฌ ๊ฒฝ๋ก์์ ์ถ๊ฐ
.claude-plugin/marketplace.json ํ์ผ์ ํฌํจํ๋ ๋ก์ปฌ ๋๋ ํ ๋ฆฌ๋ฅผ ์ถ๊ฐํฉ๋๋ค:
/plugin marketplace add ./my-marketplace
marketplace.json ํ์ผ์ ๋ํ ์ง์ ๊ฒฝ๋ก๋ฅผ ์ถ๊ฐํ ์๋ ์์ต๋๋ค:
/plugin marketplace add ./path/to/marketplace.json
์๊ฒฉ URL์์ ์ถ๊ฐ
URL์ ํตํด ์๊ฒฉ marketplace.json ํ์ผ์ ์ถ๊ฐํฉ๋๋ค:
/plugin marketplace add https://example.com/marketplace.json
URL ๊ธฐ๋ฐ ๋ง์ผํ๋ ์ด์ค๋ Git ๊ธฐ๋ฐ ๋ง์ผํ๋ ์ด์ค์ ๋นํด ๋ช ๊ฐ์ง ์ ํ ์ฌํญ์ด ์์ต๋๋ค. ํ๋ฌ๊ทธ์ธ ์ค์น ์ "๊ฒฝ๋ก๋ฅผ ์ฐพ์ ์ ์์" ์ค๋ฅ๊ฐ ๋ฐ์ํ๋ฉด ๋ฌธ์ ํด๊ฒฐ์ ์ฐธ์กฐํ์ธ์.
ํ๋ฌ๊ทธ์ธ ์ค์น
๋ง์ผํ๋ ์ด์ค๋ฅผ ์ถ๊ฐํ ํ ํ๋ฌ๊ทธ์ธ์ ์ง์ ์ค์นํ ์ ์์ต๋๋ค(๊ธฐ๋ณธ์ ์ผ๋ก ์ฌ์ฉ์ ๋ฒ์์ ์ค์น๋จ):
/plugin install plugin-name@marketplace-name
๋ค๋ฅธ ์ค์น ๋ฒ์๋ฅผ ์ ํํ๋ ค๋ฉด ๋ํํ UI๋ฅผ ์ฌ์ฉํฉ๋๋ค: /plugin์ ์คํํ๊ณ Discover ํญ์ผ๋ก ์ด๋ํ ํ ํ๋ฌ๊ทธ์ธ์์ Enter๋ฅผ ๋๋ฆ
๋๋ค. ๋ค์ ์ต์
์ด ํ์๋ฉ๋๋ค:
- User scope(๊ธฐ๋ณธ๊ฐ): ๋ชจ๋ ํ๋ก์ ํธ์์ ์์ ์ ์ํด ์ค์น
- Project scope: ์ด ์ ์ฅ์์ ๋ชจ๋ ํ๋ ฅ์๋ฅผ ์ํด ์ค์น(
.claude/settings.json์ ์ถ๊ฐ) - Local scope: ์ด ์ ์ฅ์์์๋ง ์์ ์ ์ํด ์ค์น(ํ๋ ฅ์์ ๊ณต์ ๋์ง ์์)
managed ๋ฒ์์ ํ๋ฌ๊ทธ์ธ๋ ๋ณผ ์ ์์ต๋๋ค. ์ด๋ ๊ด๋ฆฌ์๊ฐ ๊ด๋ฆฌ๋๋ ์ค์ ์ ํตํด ์ค์นํ๋ฉฐ ์์ ํ ์ ์์ต๋๋ค.
/plugin์ ์คํํ๊ณ Installed ํญ์ผ๋ก ์ด๋ํ์ฌ ๋ฒ์๋ณ๋ก ๊ทธ๋ฃนํ๋ ํ๋ฌ๊ทธ์ธ์ ํ์ธํฉ๋๋ค.
ํ๋ฌ๊ทธ์ธ์ ์ค์นํ๊ธฐ ์ ์ ์ ๋ขฐํ ์ ์๋์ง ํ์ธํ์ธ์. Anthropic์ ํ๋ฌ๊ทธ์ธ์ ํฌํจ๋ MCP servers, ํ์ผ ๋๋ ๊ธฐํ ์ํํธ์จ์ด๋ฅผ ์ ์ดํ์ง ์์ผ๋ฉฐ ์๋ํ ๋๋ก ์๋ํ๋์ง ํ์ธํ ์ ์์ต๋๋ค. ์์ธํ ๋ด์ฉ์ ๊ฐ ํ๋ฌ๊ทธ์ธ์ ํํ์ด์ง๋ฅผ ํ์ธํ์ธ์.
์ค์น๋ ํ๋ฌ๊ทธ์ธ ๊ด๋ฆฌ
/plugin์ ์คํํ๊ณ Installed ํญ์ผ๋ก ์ด๋ํ์ฌ ํ๋ฌ๊ทธ์ธ์ ๋ณด๊ณ , ํ์ฑํํ๊ณ , ๋นํ์ฑํํ๊ฑฐ๋, ์ ๊ฑฐํฉ๋๋ค. ํ๋ฌ๊ทธ์ธ ์ด๋ฆ ๋๋ ์ค๋ช
์ผ๋ก ๋ชฉ๋ก์ ํํฐ๋งํ๋ ค๋ฉด ์
๋ ฅํฉ๋๋ค.
์ง์ ๋ช ๋ น์ด๋ก ํ๋ฌ๊ทธ์ธ์ ๊ด๋ฆฌํ ์๋ ์์ต๋๋ค.
ํ๋ฌ๊ทธ์ธ์ ์ ๊ฑฐํ์ง ์๊ณ ๋นํ์ฑํํฉ๋๋ค:
/plugin disable plugin-name@marketplace-name
๋นํ์ฑํ๋ ํ๋ฌ๊ทธ์ธ์ ๋ค์ ํ์ฑํํฉ๋๋ค:
/plugin enable plugin-name@marketplace-name
ํ๋ฌ๊ทธ์ธ์ ์์ ํ ์ ๊ฑฐํฉ๋๋ค:
/plugin uninstall plugin-name@marketplace-name
--scope ์ต์
์ ์ฌ์ฉํ๋ฉด CLI ๋ช
๋ น์ด๋ก ํน์ ๋ฒ์๋ฅผ ๋์์ผ๋ก ํ ์ ์์ต๋๋ค:
claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project
์ฌ์์ ์์ด ํ๋ฌ๊ทธ์ธ ๋ณ๊ฒฝ ์ฌํญ ์ ์ฉ
์ธ์
์ค์ ํ๋ฌ๊ทธ์ธ์ ์ค์น, ํ์ฑํ ๋๋ ๋นํ์ฑํํ ๋ /reload-plugins๋ฅผ ์คํํ์ฌ ์ฌ์์ ์์ด ๋ชจ๋ ๋ณ๊ฒฝ ์ฌํญ์ ์ ํํฉ๋๋ค:
/reload-plugins
Claude Code๋ ๋ชจ๋ ํ์ฑ ํ๋ฌ๊ทธ์ธ์ ๋ค์ ๋ก๋ํ๊ณ ํ๋ฌ๊ทธ์ธ, skills, agents, hooks, ํ๋ฌ๊ทธ์ธ MCP servers ๋ฐ ํ๋ฌ๊ทธ์ธ LSP servers์ ๊ฐ์๋ฅผ ํ์ํฉ๋๋ค.
๋ง์ผํ๋ ์ด์ค ๊ด๋ฆฌ
๋ํํ /plugin ์ธํฐํ์ด์ค ๋๋ CLI ๋ช
๋ น์ด๋ฅผ ํตํด ๋ง์ผํ๋ ์ด์ค๋ฅผ ๊ด๋ฆฌํ ์ ์์ต๋๋ค.
๋ํํ ์ธํฐํ์ด์ค ์ฌ์ฉ
/plugin์ ์คํํ๊ณ Marketplaces ํญ์ผ๋ก ์ด๋ํ์ฌ:
- ์์ค ๋ฐ ์ํ์ ํจ๊ป ์ถ๊ฐ๋ ๋ชจ๋ ๋ง์ผํ๋ ์ด์ค ๋ณด๊ธฐ
- ์ ๋ง์ผํ๋ ์ด์ค ์ถ๊ฐ
- ๋ง์ผํ๋ ์ด์ค ๋ชฉ๋ก์ ์ ๋ฐ์ดํธํ์ฌ ์ต์ ํ๋ฌ๊ทธ์ธ ๊ฐ์ ธ์ค๊ธฐ
- ๋ ์ด์ ํ์ํ์ง ์์ ๋ง์ผํ๋ ์ด์ค ์ ๊ฑฐ
CLI ๋ช ๋ น์ด ์ฌ์ฉ
์ง์ ๋ช ๋ น์ด๋ก ๋ง์ผํ๋ ์ด์ค๋ฅผ ๊ด๋ฆฌํ ์๋ ์์ต๋๋ค.
๊ตฌ์ฑ๋ ๋ชจ๋ ๋ง์ผํ๋ ์ด์ค ๋์ด:
/plugin marketplace list
๋ง์ผํ๋ ์ด์ค์์ ํ๋ฌ๊ทธ์ธ ๋ชฉ๋ก ์๋ก ๊ณ ์นจ:
/plugin marketplace update marketplace-name
๋ง์ผํ๋ ์ด์ค ์ ๊ฑฐ:
/plugin marketplace remove marketplace-name
๋ง์ผํ๋ ์ด์ค๋ฅผ ์ ๊ฑฐํ๋ฉด ํด๋น ๋ง์ผํ๋ ์ด์ค์์ ์ค์นํ ๋ชจ๋ ํ๋ฌ๊ทธ์ธ์ด ์ ๊ฑฐ๋ฉ๋๋ค.
์๋ ์ ๋ฐ์ดํธ ๊ตฌ์ฑ
Claude Code๋ ์์ ์ ๋ง์ผํ๋ ์ด์ค ๋ฐ ์ค์น๋ ํ๋ฌ๊ทธ์ธ์ ์๋์ผ๋ก ์
๋ฐ์ดํธํ ์ ์์ต๋๋ค. ๋ง์ผํ๋ ์ด์ค์ ๋ํด ์๋ ์
๋ฐ์ดํธ๊ฐ ํ์ฑํ๋๋ฉด Claude Code๋ ๋ง์ผํ๋ ์ด์ค ๋ฐ์ดํฐ๋ฅผ ์๋ก ๊ณ ์น๊ณ ์ค์น๋ ํ๋ฌ๊ทธ์ธ์ ์ต์ ๋ฒ์ ์ผ๋ก ์
๋ฐ์ดํธํฉ๋๋ค. ํ๋ฌ๊ทธ์ธ์ด ์
๋ฐ์ดํธ๋ ๊ฒฝ์ฐ /reload-plugins๋ฅผ ์คํํ๋๋ก ์์ฒญํ๋ ์๋ฆผ์ด ํ์๋ฉ๋๋ค.
UI๋ฅผ ํตํด ๊ฐ๋ณ ๋ง์ผํ๋ ์ด์ค์ ๋ํ ์๋ ์ ๋ฐ์ดํธ๋ฅผ ์ ํํฉ๋๋ค:
/plugin์ ์คํํ์ฌ ํ๋ฌ๊ทธ์ธ ๊ด๋ฆฌ์ ์ด๊ธฐ- Marketplaces ์ ํ
- ๋ชฉ๋ก์์ ๋ง์ผํ๋ ์ด์ค ์ ํ
- ์๋ ์ ๋ฐ์ดํธ ํ์ฑํ ๋๋ ์๋ ์ ๋ฐ์ดํธ ๋นํ์ฑํ ์ ํ
๊ณต์ Anthropic ๋ง์ผํ๋ ์ด์ค๋ ๊ธฐ๋ณธ์ ์ผ๋ก ์๋ ์ ๋ฐ์ดํธ๊ฐ ํ์ฑํ๋์ด ์์ต๋๋ค. ํ์ฌ ๋ฐ ๋ก์ปฌ ๊ฐ๋ฐ ๋ง์ผํ๋ ์ด์ค๋ ๊ธฐ๋ณธ์ ์ผ๋ก ์๋ ์ ๋ฐ์ดํธ๊ฐ ๋นํ์ฑํ๋์ด ์์ต๋๋ค.
Claude Code ๋ฐ ๋ชจ๋ ํ๋ฌ๊ทธ์ธ์ ๋ํด ๋ชจ๋ ์๋ ์
๋ฐ์ดํธ๋ฅผ ์์ ํ ๋นํ์ฑํํ๋ ค๋ฉด DISABLE_AUTOUPDATER ํ๊ฒฝ ๋ณ์๋ฅผ ์ค์ ํฉ๋๋ค. ์์ธํ ๋ด์ฉ์ ์๋ ์
๋ฐ์ดํธ๋ฅผ ์ฐธ์กฐํ์ธ์.
Claude Code ์๋ ์
๋ฐ์ดํธ๋ฅผ ๋นํ์ฑํํ๋ฉด์ ํ๋ฌ๊ทธ์ธ ์๋ ์
๋ฐ์ดํธ๋ฅผ ํ์ฑํ๋ ์ํ๋ก ์ ์งํ๋ ค๋ฉด DISABLE_AUTOUPDATER์ ํจ๊ป FORCE_AUTOUPDATE_PLUGINS=1์ ์ค์ ํฉ๋๋ค:
export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1
Claude Code ์ ๋ฐ์ดํธ๋ฅผ ์๋์ผ๋ก ๊ด๋ฆฌํ์ง๋ง ์ฌ์ ํ ์๋ ํ๋ฌ๊ทธ์ธ ์ ๋ฐ์ดํธ๋ฅผ ๋ฐ์ผ๋ ค๋ ๊ฒฝ์ฐ์ ์ ์ฉํฉ๋๋ค.
ํ ๋ง์ผํ๋ ์ด์ค ๊ตฌ์ฑ
ํ ๊ด๋ฆฌ์๋ .claude/settings.json์ ๋ง์ผํ๋ ์ด์ค ๊ตฌ์ฑ์ ์ถ๊ฐํ์ฌ ํ๋ก์ ํธ์ ๋ํ ์๋ ๋ง์ผํ๋ ์ด์ค ์ค์น๋ฅผ ์ค์ ํ ์ ์์ต๋๋ค. ํ ๋ฉค๋ฒ๊ฐ ์ ์ฅ์ ํด๋๋ฅผ ์ ๋ขฐํ๋ฉด Claude Code๋ ์ด๋ฌํ ๋ง์ผํ๋ ์ด์ค ๋ฐ ํ๋ฌ๊ทธ์ธ์ ์ค์นํ๋๋ก ์์ฒญํฉ๋๋ค.
ํ๋ก์ ํธ์ .claude/settings.json์ extraKnownMarketplaces๋ฅผ ์ถ๊ฐํฉ๋๋ค:
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}
extraKnownMarketplaces ๋ฐ enabledPlugins๋ฅผ ํฌํจํ ์ ์ฒด ๊ตฌ์ฑ ์ต์
์ ํ๋ฌ๊ทธ์ธ ์ค์ ์ ์ฐธ์กฐํ์ธ์.
๋ณด์
ํ๋ฌ๊ทธ์ธ ๋ฐ ๋ง์ผํ๋ ์ด์ค๋ ์ฌ์ฉ์ ๊ถํ์ผ๋ก ๋จธ์ ์์ ์์์ ์ฝ๋๋ฅผ ์คํํ ์ ์๋ ๋งค์ฐ ์ ๋ขฐํ ์ ์๋ ๊ตฌ์ฑ ์์์ ๋๋ค. ์ ๋ขฐํ ์ ์๋ ์์ค์์๋ง ํ๋ฌ๊ทธ์ธ์ ์ค์นํ๊ณ ๋ง์ผํ๋ ์ด์ค๋ฅผ ์ถ๊ฐํฉ๋๋ค. ์กฐ์ง์ ๊ด๋ฆฌ๋๋ ๋ง์ผํ๋ ์ด์ค ์ ํ์ ์ฌ์ฉํ์ฌ ์ฌ์ฉ์๊ฐ ์ถ๊ฐํ ์ ์๋ ๋ง์ผํ๋ ์ด์ค๋ฅผ ์ ํํ ์ ์์ต๋๋ค.
๋ฌธ์ ํด๊ฒฐ
/plugin ๋ช ๋ น์ด๋ฅผ ์ธ์ํ์ง ๋ชปํจ
"์ ์ ์๋ ๋ช
๋ น์ด" ๋๋ /plugin ๋ช
๋ น์ด๊ฐ ๋ํ๋์ง ์์ผ๋ฉด:
- ๋ฒ์ ํ์ธ:
claude --version์ ์คํํ์ฌ ์ค์น๋ ํญ๋ชฉ์ ํ์ธํฉ๋๋ค. - Claude Code ์
๋ฐ์ดํธ:
- Homebrew:
brew upgrade claude-code - npm:
npm update -g @anthropic-ai/claude-code - ๋ค์ดํฐ๋ธ ์ค์น ํ๋ก๊ทธ๋จ: ์ค์ ์์ ์ค์น ๋ช ๋ น์ด๋ฅผ ๋ค์ ์คํํฉ๋๋ค.
- Homebrew:
- Claude Code ์ฌ์์: ์
๋ฐ์ดํธ ํ ํฐ๋ฏธ๋์ ์ฌ์์ํ๊ณ
claude๋ฅผ ๋ค์ ์คํํฉ๋๋ค.
์ผ๋ฐ์ ์ธ ๋ฌธ์
- ๋ง์ผํ๋ ์ด์ค๊ฐ ๋ก๋๋์ง ์์: URL์ ์ก์ธ์คํ ์ ์๊ณ
.claude-plugin/marketplace.json์ด ๊ฒฝ๋ก์ ์๋์ง ํ์ธํฉ๋๋ค. - ํ๋ฌ๊ทธ์ธ ์ค์น ์คํจ: ํ๋ฌ๊ทธ์ธ ์์ค URL์ ์ก์ธ์คํ ์ ์๊ณ ์ ์ฅ์๊ฐ ๊ณต๊ฐ๋์ด ์๊ฑฐ๋(๋๋ ์ก์ธ์ค ๊ถํ์ด ์๋์ง) ํ์ธํฉ๋๋ค.
- ์ค์น ํ ํ์ผ์ ์ฐพ์ ์ ์์: ํ๋ฌ๊ทธ์ธ์ ์บ์์ ๋ณต์ฌ๋๋ฏ๋ก ํ๋ฌ๊ทธ์ธ ๋๋ ํ ๋ฆฌ ์ธ๋ถ์ ํ์ผ์ ์ฐธ์กฐํ๋ ๊ฒฝ๋ก๋ ์๋ํ์ง ์์ต๋๋ค.
- ํ๋ฌ๊ทธ์ธ skills๊ฐ ๋ํ๋์ง ์์:
rm -rf ~/.claude/plugins/cache๋ก ์บ์๋ฅผ ์ง์ฐ๊ณ , Claude Code๋ฅผ ์ฌ์์ํ ํ ํ๋ฌ๊ทธ์ธ์ ๋ค์ ์ค์นํฉ๋๋ค.
์์ธํ ๋ฌธ์ ํด๊ฒฐ ๋ฐ ์๋ฃจ์ ์ ๋ง์ผํ๋ ์ด์ค ๊ฐ์ด๋์ ๋ฌธ์ ํด๊ฒฐ์ ์ฐธ์กฐํ์ธ์. ๋๋ฒ๊น ๋๊ตฌ๋ ๋๋ฒ๊น ๋ฐ ๊ฐ๋ฐ ๋๊ตฌ๋ฅผ ์ฐธ์กฐํ์ธ์.
์ฝ๋ ์ธํ ๋ฆฌ์ ์ค ๋ฌธ์
- ์ธ์ด ์๋ฒ๊ฐ ์์๋์ง ์์: ๋ฐ์ด๋๋ฆฌ๊ฐ ์ค์น๋์ด ์๊ณ
$PATH์์ ์ฌ์ฉ ๊ฐ๋ฅํ์ง ํ์ธํฉ๋๋ค./pluginErrors ํญ์์ ์ธ๋ถ ์ ๋ณด๋ฅผ ํ์ธํฉ๋๋ค. - ๋์ ๋ฉ๋ชจ๋ฆฌ ์ฌ์ฉ๋:
rust-analyzer๋ฐpyright์ ๊ฐ์ ์ธ์ด ์๋ฒ๋ ๋๊ท๋ชจ ํ๋ก์ ํธ์์ ์๋นํ ๋ฉ๋ชจ๋ฆฌ๋ฅผ ์๋นํ ์ ์์ต๋๋ค. ๋ฉ๋ชจ๋ฆฌ ๋ฌธ์ ๊ฐ ๋ฐ์ํ๋ฉด/plugin disable <plugin-name>์ผ๋ก ํ๋ฌ๊ทธ์ธ์ ๋นํ์ฑํํ๊ณ ๋์ Claude์ ๊ธฐ๋ณธ ์ ๊ณต ๊ฒ์ ๋๊ตฌ๋ฅผ ์ฌ์ฉํฉ๋๋ค. - ๋ชจ๋ ธ๋ ํฌ์์ ๊ฑฐ์ง ์์ฑ ์ง๋จ: ์์ ๊ณต๊ฐ์ด ์ฌ๋ฐ๋ฅด๊ฒ ๊ตฌ์ฑ๋์ง ์์ผ๋ฉด ์ธ์ด ์๋ฒ๊ฐ ๋ด๋ถ ํจํค์ง์ ๋ํด ํด๊ฒฐ๋์ง ์์ import ์ค๋ฅ๋ฅผ ๋ณด๊ณ ํ ์ ์์ต๋๋ค. ์ด๋ Claude์ ์ฝ๋ ํธ์ง ๋ฅ๋ ฅ์ ์ํฅ์ ์ฃผ์ง ์์ต๋๋ค.
๋ค์ ๋จ๊ณ
- ์์ ์ ํ๋ฌ๊ทธ์ธ ๋น๋: ํ๋ฌ๊ทธ์ธ์ ์ฐธ์กฐํ์ฌ skills, agents ๋ฐ hooks๋ฅผ ๋ง๋ญ๋๋ค.
- ๋ง์ผํ๋ ์ด์ค ๋ง๋ค๊ธฐ: ํ๋ฌ๊ทธ์ธ ๋ง์ผํ๋ ์ด์ค ๋ง๋ค๊ธฐ๋ฅผ ์ฐธ์กฐํ์ฌ ํ ๋๋ ์ปค๋ฎค๋ํฐ์ ํ๋ฌ๊ทธ์ธ์ ๋ฐฐํฌํฉ๋๋ค.
- ๊ธฐ์ ์ฐธ์กฐ: ํ๋ฌ๊ทธ์ธ ์ฐธ์กฐ๋ฅผ ์ฐธ์กฐํ์ฌ ์์ ํ ์ฌ์์ ํ์ธํฉ๋๋ค.