스킬이 터미널까지 따라온다 · NOTES

무엇이 바뀌었나

확인 Claude Code 2.1.275(9월 17일) 변경 로그에 이렇게 적혀 있다 — claude.ai 계정에서 켜 둔 스킬과 플러그인을 그 계정으로 로그인한 터미널 세션에 동기화한다. 끄려면 syncClaudeAiSkills: false 또는 syncClaudeAiPlugins: false.

확인 공식 문서 쪽에 절차가 더 적혀 있다. /login 으로 로그인한 터미널 세션은 계정에서 켜 둔 스킬을 ~/.claude/skills/synced/ 아래로 내려받고, 10분쯤마다 변경을 확인해 세션을 다시 켜지 않고 추가·수정·삭제를 반영한다. 내려온 것은 /skills 목록에서 claude.ai sync 아래에 묶여 나온다.

항목	문서에 적힌 것
내려오는 자리	`~/.claude/skills/synced/`
확인 주기	10분쯤. 세션 재시작 없이 반영
목록에서 보기	`/skills` → claude.ai sync
부르는 이름	`/anthropic-skills:이름`. 겹치지 않으면 `/이름`
이름이 겹치면	내 스킬이 이긴다. 동기화된 쪽 우선순위가 가장 낮다
들어 있지 않은 것	셸 명령 실행, 로컬 파일 참조
인터넷이 끊기면	이미 받아 둔 것은 디스크에 남아 그대로 올라온다
끄는 법	사용자 설정에 `"syncClaudeAiSkills": false`

확인 끄는 쪽이 세다. 설정 문서에 syncClaudeAiSkills 는 어느 자리에서든 false 가 이기는 키로 올라 있다. 관리자 쪽 설정이 true 로 켜 두었어도 내 ~/.claude/settings.json 의 false 가 지켜진다. syncClaudeAiPlugins 도 같다.

추정 그래서 계정에 스킬을 여러 개 켜 둔 사람은 터미널 쪽 /skills 목록이 갑자기 길어질 것이다. 몇 개까지 내려오는지, 목록 순서가 어떻게 잡히는지는 문서에 없다. 세어 보는 쪽이 빠르다.

확인 못 함 플러그인 쪽(syncClaudeAiPlugins)이 /plugin 목록에 어떤 이름으로 뜨는지, 그리고 데스크톱 앱과 VS Code 확장에서도 같은 동기화가 도는지는 문서에서 찾지 못했다. 여기는 적지 않고 비워 둔다.

왜 중요한가

교육 과정 L1 · 05 에서 세 번 이상 시킨 일은 절차로 박아 둔다고 적었다. 그런데 박아 두는 자리가 두 군데였다 — 브라우저 쪽과 터미널 쪽. 같은 절차를 두 번 쓰고, 한쪽만 고치고, 나중에 어느 쪽이 맞는지 모르게 된다.

이번 변경은 그 자리를 한 군데로 모으는 쪽이다. L2 · 06 에서 한 이야기가 그대로 여기 붙는다 — 고칠 자리가 하나면 틀릴 자리도 하나다.

확인 다만 계정이 곧 스킬 목록이 된다는 뜻이기도 하다. claude.ai 쪽 자리는 Customize → Skills 이고, 스킬 자체는 무료 · Pro · Max · Team · Enterprise 모든 플랜에서 쓸 수 있다. 터미널 Claude Code 는 무료 플랜에서는 안 된다 — Pro 이상이 필요하다.

직접 해 보기 — 10분

버전을 본다. 이 기능은 2.1.275 부터다.
```
claude --version
```
낮게 나오면 claude update. Homebrew·WinGet 으로 깔았으면 brew upgrade claude-code 또는 winget upgrade Anthropic.ClaudeCode 를 직접 돌려야 한다.
브라우저 쪽을 먼저 정리한다. claude.ai → Customize → Skills. 여기 켜져 있는 것이 그대로 내려온다. 지금 안 쓰는 것은 여기서 끈다 — 내려온 뒤에 지우는 것보다 싸다.
터미널에서 세어 본다. 작업 폴더에서 claude 를 띄우고,
```
/skills
```
claude.ai sync 가 있는지, 그 아래가 몇 개인지 본다. 처음 여는 사람은 대개 예상보다 많다.

파일로 확인한다. 목록만 믿지 않고 디스크를 본다 (L2 · 04).

ls ~/.claude/skills/synced/

# Windows PowerShell
dir $env:USERPROFILE\.claude\skills\synced

싫으면 끈다. ~/.claude/settings.json 에 두 줄이면 된다.
```
{
  "syncClaudeAiSkills": false,
  "syncClaudeAiPlugins": false
}
```
고치기 전에 그 파일을 복사해 둔다 — L2 · 05.

자동으로 늘어나는 목록에는 값이 붙는다

확인 이번 주에 공개된 Plugin4Shell 이라는 취약점이 이 이야기 바로 옆에 있다. 코딩 에이전트 네 종(Claude Code · Codex · Gemini CLI · GitHub Copilot)이 스킬·플러그인을 처음 받을 때만 검사하고 그 뒤 업데이트는 다시 검사하지 않는 같은 구멍을 갖고 있었다. Claude Code 는 2.1.179, Codex 는 0.146.0 에서 고쳐졌다.

요점은 무섭다는 게 아니다. 자동으로 늘어나는 목록은 가끔 세어 봐야 한다는 것이다. 동기화된 스킬에는 셸 명령 실행이 들어 있지 않다고 문서에 적혀 있으니 이번 기능 자체가 위험하다는 뜻은 아니고, 내가 켠 적 없는 것이 목록에 있으면 그건 볼 일이라는 뜻이다 (STEP 18).

한 줄 정리

2.1.275 부터, claude.ai 에서 켠 스킬이 로그인한 터미널로 내려온다.
자리는 ~/.claude/skills/synced/, 확인은 /skills 의 claude.ai sync.
켜는 자리를 브라우저 한 군데로 모으고, 끄는 키는 syncClaudeAiSkills.

배경 영상 AI 잘 쓰는 사람들은 왜 까만창을 켤까? Codex · Claude Code · Gemini CLI 안될공학 · 2026-09-17 · 터미널을 왜 쓰는지부터 보고 싶으면 이쪽. 이번 동기화 기능은 다루지 않는다 이어 읽기 L1 · 05 반복을 스킬로 굳히기 — 내려온 스킬 말고 내가 만드는 스킬. 어디에 두고, 어떻게 부르는지. →

SOURCES

Claude Code changelog — 2.1.275 (2026-09-17) 항목
Claude Code Docs — Skills (synced 폴더 · 10분 주기 · /skills 의 claude.ai sync · 이름 겹칠 때 · 오프라인)
Claude Code Docs — Settings files and precedence (false 가 관리 설정보다 우선하는 키 목록)
Claude Code Docs — Advanced setup (claude --version · claude update · 필요한 플랜)
Use skills in Claude (Customize → Skills · 플랜)
Air — Plugin4Shell (제로 클릭 원격 실행 · 고쳐진 버전)
Help Net Security — Plugin4Shell (2026-09-18)
영상 — 안될공학, 「왜 까만창을 켤까」 (2026-09-17 · 배경)

켜 둔 스킬이 터미널까지 따라온다

무엇이 바뀌었나

왜 중요한가

직접 해 보기 — 10분

한 줄 정리