Ujinify

초보자 가이드

  • 클로드 코드 설치 윈도우와 맥, 명령어를 어디에 입력하나

    클로드 코드 설치 윈도우와 맥, 명령어를 어디에 입력하나

    클로드 코드 설치 윈도우와 맥은 명령어가 다르다. 검색하면 윈도우와 맥의 명령어가 따로 나온다. 어떤 명령을 어디에 입력해야 하는지 모르면 여기서 막힌다. 이 글은 공식 설치 문서에 나온 명령을 운영체제별로 정리한다.

    설치 전에 확인할 것

    항목 요구 사항
    운영체제 macOS 13.0 이상, Windows 10(1809) 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine 3.19 이상
    메모리 4GB 이상
    인터넷 설치와 로그인에 필요
    계정 Pro, Max, Team, Enterprise, Console 계정. 무료 claude.ai 요금제에는 포함되지 않음

    클로드 코드 설치 맥과 리눅스에서 하는 법

    터미널을 열고 아래 명령을 입력한다. 맥은 터미널 앱, 리눅스는 기본 터미널에서 실행한다.

    curl -fsSL https://claude.ai/install.sh | bash

    설치가 끝나면 새 터미널 창을 열고 claude --version을 입력한다. 버전 번호가 나오면 설치가 된 것이다.

    클로드 코드 설치 확인 — claude --version 실행 결과 버전 2.1.289

    클로드 코드 입력창에서 claude --version을 실행한 결과다. 버전 번호 2.1.289가 나온다.

    클로드 코드 설치 윈도우에서 하는 법

    윈도우는 PowerShell과 CMD에 따라 명령이 다르다. 프롬프트 모양으로 구분할 수 있다. 프롬프트에 PS가 붙어 있으면 PowerShell이고, PS 없이 C:\만 보이면 CMD다.

    PowerShell에서는 아래 명령을 입력한다.

    irm https://claude.ai/install.ps1 | iex

    CMD에서는 아래 명령을 입력한다.

    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

    공식 문서에 따르면 PowerShell에서 CMD 명령을 입력하면 “&&” 오류가 나고, CMD에서 PowerShell 명령을 입력하면 “irm” 오류가 난다. 오류 메시지가 나오면 프롬프트 모양부터 확인하면 된다.

    윈도우에서 Git for Windows를 권하는 이유

    공식 문서는 윈도우에서 Git for Windows 설치를 권한다. 설치되어 있으면 클로드 코드가 Bash 도구를 쓸 수 있다. 설치하지 않으면 PowerShell을 대신 쓴다. WSL 환경에서는 Git for Windows가 필요하지 않다.

    명령 없이 VS Code 확장으로 설치하는 법

    명령을 입력하는 것이 어렵다면 VS Code 확장으로 설치할 수 있다. 나도 이 방법으로 설치했다. 확장 목록을 열고(맥은 Cmd+Shift+X, 윈도우는 Ctrl+Shift+X), “클로드 코드”를 검색해서 설치하면 된다.

    공식 문서에는 확장을 설치할 수 없는 편집기라면 CLI를 설치하고, 편집기 안의 터미널에서 claude를 실행하라고 나와 있다. 설치 후 확장 목록에 클로드 코드가 보이지 않으면 VS Code를 다시 시작하거나, 명령 팔레트에서 “Developer: Reload Window”를 실행하면 된다.

    설치가 안 될 때

    명령을 실행했는데 claude를 찾을 수 없다고 나오면 실행 경로(PATH) 문제일 수 있다. 공식 문서에는 “Fix your PATH” 항목이 따로 있다. 설치 오류가 “403”이나 “curl” 오류로 나오면 공식 문제 해결 페이지에서 증상별 해결 방법을 확인하면 된다.

    설치 후 claude doctor를 실행하면 설치 상태와 설정 파일의 문제를 읽기 전용으로 점검할 수 있다.

    클로드 코드 설치 진단 , claude doctor 실행 결과 설치 문제 없음

    클로드 코드 입력창에서 claude doctor를 실행한 결과다. “설치 문제는 발견되지 않았습니다”라고 나온다.

    맥에서는 Homebrew로도 설치할 수 있다

    공식 문서에는 Homebrew 설치 방법도 나온다. brew install --cask claude-code를 입력하면 된다. 공식 문서에 따르면 claude-code는 안정 채널이라 보통 일주일 정도 늦게 나오고, claude-code@latest는 새 버전이 나오면 바로 받는다.

    설치 후 업데이트는 자동으로 된다

    공식 문서에 따르면 네이티브 설치는 백그라운드에서 자동으로 업데이트되어 최신 버전을 유지한다. 업데이트를 직접 관리하고 싶으면 공식 문서의 자동 업데이트 설정 항목을 확인하면 된다.

    설치 명령과 요구 사항의 원문은 클로드 코드 공식 설치 문서에서 볼 수 있다. 설치와 관련해 다른 글도 있다. 올라마 연동, 왜 아직 안 깔았나 설치 전 계정 준비와 VS Code 확장 설치 과정은 클로드 코드 설치, 무료로는 안 되고 Pro와 확장 2가지가 필요했다에 정리했다.

    정리

    • 맥과 리눅스는 curl 명령 한 줄로 설치한다.
    • 윈도우는 PowerShell과 CMD에 따라 명령이 다르다.
    • 설치 후 claude --version으로 확인한다.
    • 무료 요금제로는 쓸 수 없다. Pro 이상이 필요하다.
  • 클로드 코드 설치, 무료로는 안 되고 Pro와 확장 2가지가 필요했다

    클로드 코드 설치, 무료로는 안 되고 Pro와 확장 2가지가 필요했다

    클로드 코드 설치 방법을 검색하면 바로 명령어부터 나온다. 나는 그 명령어가 무슨 뜻인지도 몰랐다. 먼저 결론부터 말한다. 무료 요금제로는 설치해도 쓸 수 없다. 클로드 코드는 프로나 맥스를 구매해야 쓸 수 있다.

    무료로는 안 된다. 나는 Pro를 샀다

    공식 문서에도 무료 claude.ai 요금제에는 클로드 코드가 포함되지 않는다고 나와 있다. 나는 이걸 모르고 설치부터 시작하려고 했다. 시간만 날리는 순서다. 그래서 Pro를 먼저 구매하고, 그다음에 설치했다.

    VS Code 확장으로 설치했다

    나는 VS 코드(Visual Studio Code, 코드를 쓰는 편집기)에 확장(extension, 편집기에 기능을 더하는 부품)을 설치했다. 방법은 간단하다. 확장 목록을 열고(맥은 Cmd+Shift+X, 윈도우는 Ctrl+Shift+X), “클로드 코드”를 검색해서 설치 버튼을 누르면 된다.

    클로드 코드 설치 — VS Code 확장 검색에서 앤트로픽이 만든 클로드 코드 항목

    확장 검색 결과에서 앤트로픽이 만든 클로드 코드 항목이다.

    로그인은 GitHub 계정으로 했다

    처음 로그인하자 Microsoft 계정 또는 GitHub 계정을 고르는 창이 나왔다. 계정이 없으면 Microsoft 계정을 무료로 새로 만들 수 있었다. 나는 GitHub 계정이 있어서 GitHub로 로그인했다.

    클로드 코드 설치 후 VS Code에서 열린 클로드 코드 패널

    설치 후 VS Code에서 클로드 코드 패널을 연 화면이다. 아무 작업도 하지 않은 빈 상태다.

    처음 입력한 건 “블로그 자동화”였다

    패널에 처음 입력한 건 “블로그 자동화”였다. 실제로 자동화 작업을 하고 싶었다. 그리고 어떤 방식으로 자동화가 되는지, 글이 어떤 스타일로 써지는지 궁금했다.

    Claude가 되물었고, 나는 여행 블로그라고 답했다

    “블로그 자동화”라고 입력하자 Claude가 어떤 블로그 자동화를 만들고 싶은지 되물었다. 나는 여행 블로그를 자동화하고 싶다고 답했다. Claude는 글에 넣을 이미지가 있는지 물었고, 나는 이미지를 제공했다.

    그 대화 뒤에 나는 “에이전트로 블로그 자동화를 만들어 달라”고 명령했다. 그렇게 Claude가 에이전트를 만들었다.

    초안은 Claude가 썼고, 거짓이 있는지는 내가 봤다

    주제는 내가 정했다. 그다음 Claude가 내가 준 이미지를 보고 초안을 썼다. 나는 그 초안을 읽으면서 고쳐야 할 부분과 거짓이 있는지 확인했다.

    이미지에서 기본 정보도 뽑아 달라고 했다. 맛집 이미지를 보여주면 메뉴, 위치, 가게 이름 같은 정보를 글에 넣도록 한 것이다.

    그런데 초안에는 거짓이 있었다. 내가 정보를 제대로 전달하지 못해서 Claude가 그렇게 쓴 것 같다. 그래서 나는 정확한 정보를 직접 보여줬다. 구글 지도에서 위치를 확인하고, 사람들이 남긴 리뷰를 찾고, 그 가게를 다룬 블로그 글이 있는지도 확인해서 보여줬다. Claude는 그 내용을 읽고 글을 다시 썼다.

    코드를 몰라서, 하나씩 물어보며 배웠다

    화면에 보이는 코드가 뭔지 아무것도 몰랐다. 그래서 기본적인 것부터 Claude에게 물어봤다. 한동안 그렇게 하다 보니 기본 코드를 스킬(skill, 클로드 코드가 특정 작업을 하는 방법을 저장해 두는 기능)로 만드는 방법까지 배우게 됐다.

    궁금하거나 배우고 싶은 코드는 스킬로 저장해 두고, 필요할 때마다 다시 열어보며 공부했다. 지금도 이 방법으로 코드를 배우고 있다.

    진짜 막힌 곳은 코드를 몰랐다는 것이다

    설치하고 쓰는 과정에서 화면에 코드가 나오는데, 그게 무슨 뜻인지 전혀 몰랐다. 명령어 한 줄을 실행해도 되는지 판단할 수 없었다. 그래서 나는 Claude에게 물어보면서 하나씩 진행했다.

    이 방식을 권한다. 낯선 코드가 나오면 실행하기 전에 복사해서 “이게 뭐 하는 코드야? 실행해도 되나?”라고 물어보면 된다. 모르는 채로 넘어가지 않는 것이 중요하다.

    설치가 됐는지 확인하는 법

    확장 목록에서 “클로드 코드”가 설치된 상태로 보이면 설치가 된 것이다. 설치했는데 보이지 않으면 VS Code를 다시 시작하거나, 명령 팔레트에서 “Developer: Reload Window”를 실행하면 된다. 공식 문서에 나온 방법이다.

    설치 전에 확인할 것

    클로드 코드 설치 전에 아래 네 가지를 확인해 두면 좋다.

    항목 요구 사항
    운영체제 macOS 13.0 이상, Windows 10(1809) 이상 또는 Windows Server 2019 이상, Ubuntu 20.04 이상, Debian 10 이상, Alpine 3.19 이상
    메모리 4GB 이상
    인터넷 설치와 로그인에 필요
    계정 Pro, Max, Team, Enterprise, Console 계정. 무료 claude.ai 요금제에는 포함되지 않음

    계정은 무료가 아니라 Pro 이상이 필요하다

    클로드 코드 설치와 사용에는 Pro, Max, Team, Enterprise, Console 계정이 필요하다고 공식 문서에 나와 있다. 무료 claude.ai 요금제는 포함되지 않는다. 문서에는 Amazon Bedrock, Google Cloud, Microsoft Foundry 같은 외부 제공자로 쓰는 방법도 나오지만, 나는 그 방법은 쓰지 않았다. 나는 Pro를 구매해서 로그인했다.

    VS Code에서 자주 막히는 곳

    공식 문서에는 VS Code 확장에서 생기는 문제가 항목별로 정리돼 있다. 확장이 설치되지 않을 때, 스파크 아이콘이 보이지 않을 때, macOS에서 Cmd+Esc가 동작하지 않을 때, 클로드 코드가 응답하지 않을 때다. 나는 이 항목을 전부 겪은 것은 아니다. 막히면 이 목록에서 내 증상과 맞는 항목을 먼저 찾아보는 것이 빠르다.

    더 읽을거리

    설치 명령과 요구 사항의 원문은 클로드 코드 공식 설치 문서에서 볼 수 있다. 설치와 관련해 다른 글도 있다. 올라마 연동, 왜 아직 안 깔았나 윈도우와 맥의 설치 명령어를 운영체제별로 정리한 글도 있다. 클로드 코드 설치, 윈도우와 맥 명령어 정리

    정리

    • 클로드 코드 설치 전에 Pro 이상 계정부터 준비한다.
    • 무료 요금제로는 설치해도 쓸 수 없다.
    • Pro 이상을 먼저 구매한다.
    • VS Code에서 확장으로 설치하고, GitHub 계정으로 로그인한다.
    • 코드가 막히면 실행하기 전에 물어본다.
  • 클로드 스킬 추천 3개, 릴스에서 본 것 직접 확인해봤다

    클로드 스킬 추천 3개, 릴스에서 본 것 직접 확인해봤다

    인스타 릴스에서 클로드 스킬 추천 영상을 봤다. 스크롤하다가 멈췄다. “천 시간 넘게 쓰면서 결국 이 세 개만 남았다”는 문구 때문이었다. 직접 확인해봤다.

    인스타에서 본 그 릴스, 정말 믿을 만할까?

    영상을 올린 계정은 mild.codes다. 프로필에 ‘AI로 생성한 프로필’이라고 본인이 적어뒀다. 실존 인물이 아닐 수 있다는 뜻이다. “천 시간 넘게 썼다”는 경험담은 검증할 방법이 없다. 이건 처음부터 명확히 해두고 싶었다.

    그래도 릴스에서 소개한 세 가지 스킬 자체는 확인이 가능했다. 스킬(skill, Claude Code에서 동작 방식을 바꿔주는 플러그인)은 실제로 설치 파일을 열어보거나, GitHub(코드를 공개적으로 올려두는 플랫폼)에서 저장소(repository, 코드를 저장하는 폴더)를 직접 보면 된다. 그렇게 했다.

    릴스가 주장한 건 세 가지였다. 슈퍼파워즈(Superpowers)는 앤트로픽이 만든 게 아니다. 카파시 스킬은 이름과 달리 카파시 본인이 만든 게 아니다. 스킬 크리에이터는 앤트로픽이 직접 만든 공식 플러그인이다. 하나씩 확인했다.

    첫 번째 스킬: 슈퍼파워즈, 개인 개발자 프로젝트

    이건 내가 이미 쓰고 있는 플러그인이다. 지금 이 블로그 파이프라인을 만들 때도 실제로 설치해서 돌리고 있다. 그래서 확인이 제일 빨랐다.

    로컬에 설치된 파일을 바로 열었다. plugin.json이라는 설정 파일에 저자 이름이 있다. ‘Jesse Vincent’라고 적혀 있었다. 앤트로픽 이메일이 아니다. 홈페이지는 github.com/obra/superpowers로 연결된다. GitHub 아이디가 obra인 개인 개발자가 만든 오픈소스 프로젝트다.

    클로드 스킬 추천 확인 화면 — 스크린샷 1

    아래 스크린샷은 GitHub 저장소 화면이다. 저장소 주인이 obra 계정이고, 오른쪽에 MIT 라이선스와 스타 수가 보인다. GitHub 페이지에서도 스타 29만 5천 개, MIT 라이선스로 확인됐다.

    릴스 주장이 맞다. 앤트로픽 공식이 아니다. 개인이 만들었다. 그렇다고 못 믿을 이유는 없다. 스타 수도 많고 실제로 잘 작동한다.

    두 번째 스킬: 카파시 스킬, 이름만 카파시일 뿐, 다른 사람이 정리한 원칙

    앤드리 카파시는 AI 연구자다. OpenAI 출신이고, X(트위터)에서 LLM 관련 글을 많이 올린다. 그래서 이름이 붙었다.

    실제 저장소는 multica-ai/andrej-karpathy-skills다. 예전 이름은 forrestchang/andrej-karpathy-skills였다. README에 뭐라고 적혀 있는지 봤다. “앤드리 카파시의 관찰에서 파생됨”이라고 나와 있다. 카파시가 직접 작성하거나 공식 배포한 파일이 아니다.

    구조는 이렇다. 카파시가 X에 LLM 코딩이 실패하는 패턴에 대해 글을 남겼다. 그걸 읽은 다른 개발자가 핵심 내용을 CLAUDE.md 파일로 정리해서 배포했다. 이름만 카파시다.

    클로드 스킬 추천 확인 화면 , 스크린샷 2

    위 스크린샷이 실제 GitHub 저장소 화면이다. README 첫 줄에 “derived from”이 보인다. 스타는 21만 6천 개가 넘는다.

    이 스킬의 내용은 4가지 원칙으로 정리된다. 코딩 전에 생각하기, 단순하게 가기, 필요한 곳만 고치기, 목표 기준으로 일하기. 여기서 이건 좀 웃겼다. 내가 이미 내 개인 CLAUDE.md 전역 설정 파일에 이 내용을 그대로 갖고 있었다. 이미 쓰고 있던 걸 릴스로 다시 마주친 거다.

    한 가지 주의할 것이 있다. 이 스킬을 다룬 블로그 글 여러 곳에서 “이 규칙으로 오류가 41%에서 11%로 줄었다”는 수치를 인용한다. 출처가 없다. 측정 방법도 없다. 그 숫자는 여기서 옮기지 않았다. 근거가 불분명한 수치를 그대로 퍼나르지 마라.

    세 번째 스킬: 스킬 크리에이터, 이것만 앤트로픽 공식이다

    이건 확실히 공식이다. GitHub 저장소가 anthropics/claude-plugins-official이다. anthropics가 앤트로픽 공식 계정이다. 저장소 안에 plugins/skill-creator 폴더로 들어 있다.

    용도는 세 가지다. 새 스킬을 만드는 것, 기존 스킬을 개선하는 것, 스킬을 적용했을 때와 안 했을 때 결과를 비교해서 성능을 측정하는 것. 저장소 README에 그렇게 적혀 있다.

    클로드 스킬 추천 확인 화면 , 스크린샷 3

    위 스크린샷이 anthropics 공식 저장소 화면이다. 계정 이름과 폴더 구조가 보인다.

    단, 나는 아직 설치해서 써본 적 없다. 공식이라는 건 확인했다. 직접 써본 후기는 아직 없다. 이건 솔직히 말해두는 게 맞다.

    네 번째 확인: 다른 릴스, 리버스 엔지니어링 도구

    며칠 뒤 또 다른 릴스를 봤다. 계정은 @ai.dingco, 제목은 “클로드 코드 고수들이 쓰는 무료 오픈소스 3개”였다. 똑같이 하나씩 열어봤다.

    셋 중 둘(graphify, agent-reach)은 이미 쓰고 있던 거였다. 새로 설치한 건 하나, REA(Reverse Engineer Anything)다. 저장소는 morluto/rea, 스타는 38만 5천 개가 넘는다. MIT 라이선스.

    용도는 소스 코드가 없는 앱 — 네이티브 바이너리, 일렉트론 앱, .NET, 웹사이트 — 을 Ghidra나 IDA 같은 역분석 도구에 연결해서 동작 원리를 설명해주는 거다. 스킬 하나가 아니라 5개로 쪼개져 설치됐다. 핵심은 reverse-engineer-anything, 나머지 넷은 보조 스킬이다.

    여기서 걸리는 게 하나 있었다. 보안 검증을 돌렸더니 핵심 스킬이 Gen과 Snyk 두 스캐너 모두에서 Med Risk가 나왔다. 지금까지 설치한 것 중 제일 높은 등급이다. 쓸 땐 상용 앱을 그대로 베끼거나 재배포하는 용도가 아니라 디버깅·학습용으로만 쓰기로 했다.

    다섯 번째 확인: PPT 도구 릴스, 5개 중 2개만

    그 다음 주엔 @ssumae.ai가 올린 “클로드로 PPT 만들 때 쓰는 무료 도구 5개” 영상을 봤다. 이번엔 5개 중 2개만 설치했다.

    하나는 ppt-master(hugohe3/ppt-master, 스타 6만 8천+)다. 보안 검증 결과는 Safe, 경고 0건. 표나 차트, 전환 효과까지 들어간 진짜 .pptx 파일이 필요할 때 쓴다.

    다른 하나는 frontend-slides(zarazhangrui/frontend-slides, 스타 3만 1천+)다. 이건 Snyk에서 Med Risk가 나왔다. 실제 파워포인트 파일이 아니라 블로그에 바로 캡처해서 넣을 포스터·이미지 스타일 설명도를 만들 때 쓴다.

    나머지 셋은 안 깔았다. document-skills는 이미 anthropic-skills:pptx로 똑같은 걸 갖고 있었고, Slidev랑 PowerPoint MCP는 용도가 겹치거나 애매해서 패스했다.

    클로드 스킬 추천, 초보자가 먼저 설치할 것

    여섯 가지를 비교하면 이렇다.

    스킬 이름 만든 곳 GitHub 스타 특징
    슈퍼파워즈 (Superpowers) 개인 개발자 (Jesse Vincent) 29만 5천+ 실제로 써봤고 잘 작동함
    카파시 스킬 (Karpathy Skill) 제3자 개발자 (카파시 아님) 21만 6천+ CLAUDE.md 원칙 정리본
    스킬 크리에이터 (Skill Creator) 앤트로픽 공식 – 스킬 제작·측정 용도
    REA (Reverse Engineer Anything) 개인 개발자 (morluto) 38만 5천+ 소스 없는 앱 역분석, 보안 등급 Med Risk
    PPT Master 개인 개발자 (hugohe3) 6만 8천+ 진짜 .pptx 파일 생성, 보안 등급 Safe
    Frontend Slides 개인 개발자 (zarazhangrui) 3만 1천+ 이미지형 설명도 제작, 보안 등급 Med Risk

    Claude Code가 처음이라면 순서가 있다. 카파시 스킬부터 보는 게 낫다. 설치 전에 4원칙 내용 자체를 읽어보는 걸 권한다. Claude Code에게 어떤 방식으로 일하라고 지시할지 감이 없는 상태에서 플러그인만 깔면 아무 의미가 없다.

    REA는 보안 등급이 Med Risk라 아무 때나 쓰는 도구는 아니다. 역분석이 실제로 필요한 상황이 생겼을 때 설치해도 늦지 않다.

    스킬 크리에이터는 나중에 써볼 생각이다. 스킬을 직접 만들거나 성능을 비교하려면 일단 Claude Code 자체에 먼저 익숙해져야 한다. 초보자가 제일 먼저 설치할 플러그인은 아니다.

    릴스 자체는 저자 정보가 불분명하다. 그래도 사실 확인 결과는 나쁘지 않았다. 세 번 다 소개된 도구는 실제로 존재했고, 설명한 용도도 저장소 설명과 맞았다. 다음에는 스킬 크리에이터를 실제로 설치하고 써봐야겠다고 생각 중이다. 후기가 생기면 따로 쓴다.

    같은 주제로 이어서 읽으면 좋은 글: 클로드 스킬 3개 비교, 나는 last30days만 쓰기로 했다

    이 글에서 확인한 저장소는 여섯 곳이다. 슈퍼파워즈, 카파시 스킬, 앤트로픽 공식 플러그인, REA, PPT Master, Frontend Slides다.

  • 워드프레스 SEO 플러그인 충돌 피하는 법, 켜야 할 것과 꺼야 할 것

    워드프레스 SEO 플러그인 충돌 피하는 법, 켜야 할 것과 꺼야 할 것

    워드프레스 새로 만들면 플러그인 목록 바로 확인하는 사람이 얼마나 될까. 나는 안 했다. 그냥 랭크매스 설치하고 활성화했다가 워드프레스 SEO 플러그인 충돌을 직접 겪었다. 그게 실수였다.

    호스팅사가 몰래 깔아주는 SEO 플러그인, 확인하는 법

    호스팅어(Hostinger)에서 워드프레스를 새로 만들면 플러그인이 이미 몇 개 깔려 있다. 기본 번들이다. 문제는 그 안에 All in One SEO가 활성화된 채로 포함돼 있다는 거다.

    처음엔 몰랐다. 랭크매스를 쓰기로 마음먹고 설치부터 했다. 설치 자체는 문제없이 됐다. 그런데 활성화하고 나서 플러그인 목록을 열어봤더니 — All in One SEO가 이미 켜져 있었다. 두 개가 동시에 활성 상태였다.

    확인 방법은 간단하다. 워드프레스 관리자 화면에서 플러그인 → 설치된 플러그인으로 들어간다. 목록 상단에 ‘전체 | 활성 | 비활성’ 탭이 보인다. 활성 탭을 클릭해서 지금 켜진 플러그인만 따로 보는 게 제일 확실하다. 전체 목록에서 눈으로 훑는 건 놓치기 쉽다.

    워드프레스 새로 설치할 때 SEO 플러그인 충돌 피하는 법 , 켜야 할 것, 꺼야 할 것 스크린샷 1

    위 화면처럼 활성 플러그인 목록을 확인하면 워드프레스 SEO 플러그인 충돌 여부를 바로 알 수 있다. 자세한 확인 방법은 워드프레스 공식 플러그인 관리 문서에도 나온다. 여기서 두 개 이상 보이면 즉시 하나를 꺼야 한다.

    호스팅어뿐 아니라 다른 호스팅사도 비슷하게 기본 플러그인을 깔아두는 경우가 있다. 새 워드프레스를 만들었다면 플러그인 목록 확인이 첫 번째 할 일이다.

    SEO 플러그인을 두 개 켜면 안 되는 이유 (메타박스, 스키마 마크업 충돌)

    워드프레스 SEO 플러그인 충돌이 실제로 왜 문제인지 구체적으로 알아야 경각심이 생긴다.

    첫 번째 문제는 메타박스(Meta Box, 글 편집 화면 아래쪽에 뜨는 SEO 입력 칸) 중복이다. 글을 쓰다 보면 편집 화면 아래에 SEO 제목, 설명, 키워드를 입력하는 칸이 뜬다. SEO 플러그인이 두 개면 이 칸이 두 세트가 된다. 어느 쪽 설정이 실제로 적용되는지 알 수 없다. 헷갈린다. 별로다.

    두 번째 문제가 더 심각하다. 스키마 마크업(Schema Markup, 구글이 검색 결과에 별점·날짜 같은 정보를 표시할 때 읽는 구조화 데이터) 충돌이다. 두 플러그인이 각자 스키마 마크업을 만들어낸다. 구글 입장에서는 같은 페이지에 두 개의 서로 다른 구조 데이터가 존재하는 셈이다. 어느 걸 믿어야 할지 모른다. 검색 엔진 최적화(SEO)가 목적인데 오히려 역효과다.

    워드프레스 SEO 플러그인 충돌을 막으려면 SEO 플러그인은 하나만 켜야 한다. 예외는 없다.

    All in One SEO 비활성화할 때 자주 실패하는 이유

    비활성화 버튼을 눌렀다. 그런데 안 꺼졌다. 이건 좀 웃겼다.

    나중에 이유를 알았다. All in One SEO를 비활성화하려고 버튼을 클릭한 순간, 화면에 설문 팝업이 떴다. 플러그인을 끄기 전에 이유를 물어보는 팝업이다. 그 팝업이 클릭을 가로채고 있었던 거다. 버튼을 눌렀다고 생각했는데 팝업 영역을 누른 셈이었다.

    팝업이 떠 있으면 반드시 팝업을 먼저 처리해야 한다. 닫든 제출하든 상관없다. 그다음에 비활성화 버튼을 다시 눌러야 실제로 꺼진다.

    비활성화 후 확인도 직접 해야 한다. 플러그인 목록 상단에 이런 식으로 표시된다.

    • 전체 (13) | 활성 (9) | 비활성 (4)

    비활성화 전후로 활성 숫자가 하나 줄었는지 확인하는 게 제일 확실하다. 숫자가 안 줄었으면 비활성화가 실제로 안 된 거다. 다시 해야 한다.

    워드프레스 새로 설치할 때 SEO 플러그인 충돌 피하는 법 , 켜야 할 것, 꺼야 할 것 스크린샷 2

    비활성화가 제대로 됐으면 플러그인 목록에서 이 플러그인의 링크가 ‘비활성화’가 아니라 ‘활성화’로 바뀌어 있다. 위 화면이 그 상태다 , All in One SEO 옆에 ‘활성화’ 링크가 뜬다는 건 지금 꺼져 있다는 뜻이다.

    호스팅어 기본 플러그인 중 뭘 켜두고 뭘 꺼야 할까?

    호스팅어 기본 번들 플러그인을 전부 쓸 필요는 없다. 실제로 정리해봤다.

    플러그인 이름 처리 이유
    All in One SEO 비활성화 랭크매스를 메인으로 쓰므로 충돌 방지를 위해 꺼야 함
    Hostinger Reach 비활성화 SEO·콘텐츠 작업에 불필요
    Hostinger Tools 비활성화 SEO·콘텐츠 작업에 불필요
    호스팅어 간편한 온보딩 비활성화 초기 설정 이후 불필요
    LiteSpeed Cache 유지 캐시(Cache, 페이지를 미리 저장해 속도를 높이는 기능)로 사이트 속도 향상에 기여
    Site Kit by Google 유지 구글 서치콘솔·애널리틱스 연동에 계속 필요

    정리하면 호스팅어 번들 중 실제로 쓸 것은 LiteSpeed Cache와 Site Kit by Google 두 개다. 나머지는 꺼도 된다.

    충돌 없이 안전하게 설치해도 되는 플러그인 5가지

    SEO 플러그인처럼 서로 충돌하는 플러그인이 있는 반면, 그냥 설치하면 되는 것들도 있다. 직접 설치해서 쓰고 있는 5개다.

    • WP File Manager (비트 파일 관리자) , 워드프레스 관리자 화면에서 직접 서버 파일을 관리할 수 있다. FTP(File Transfer Protocol, 파일을 서버에 올리고 내리는 프로토콜) 없이도 파일을 수정할 수 있어서 편하다.
    • Converter for Media , 업로드하는 이미지를 WebP(웹피, 구글이 만든 이미지 형식으로 용량이 작아 로딩이 빠름) 형식으로 자동 변환해준다. 따로 손댈 게 없다.
    • Head & Footer Code , 헤더와 푸터에 직접 코드를 삽입할 수 있다. 구글 태그 같은 걸 넣을 때 쓴다.
    • Instant Indexing , 글을 발행하면 구글에 즉시 색인 요청을 자동으로 보내준다.
    • 럭키WP 목차 , 글 안에 목차를 자동으로 만들어준다. 긴 글일수록 유용하다.

    이 5개는 SEO 플러그인처럼 같은 기능을 두 개가 동시에 담당하는 구조가 아니다. 설치하고 활성화하면 된다.

    플러그인 활성화 후 반드시 해야 할 확인 작업

    플러그인 설치하고 활성화했다고 끝이 아니다. 확인이 남아 있다.

    워드프레스 새로 설치할 때 SEO 플러그인 충돌 피하는 법 , 켜야 할 것, 꺼야 할 것 스크린샷 3

    반대로 랭크매스는 옆에 ‘비활성화’ 링크가 뜬다 , 이건 지금 켜져 있다는 뜻이다. 이렇게 SEO 플러그인 중 딱 하나만 ‘비활성화’ 링크가 보이는 상태가 맞는 상태다.

    확인 순서는 이렇다.

    • 활성 탭을 클릭해서 현재 켜진 플러그인 목록만 본다.
    • SEO 플러그인이 하나인지 반드시 확인한다. 두 개 이상이면 하나를 당장 꺼야 한다.
    • 비활성화한 플러그인은 비활성 탭에서 숫자가 늘었는지 확인한다.
    • 새로 설치한 플러그인이 활성 탭에 정상 표시되는지 본다.

    이걸 한 번만 제대로 해두면 나중에 ‘왜 SEO 설정이 안 먹히지?’ 같은 상황을 방지할 수 있다.

    워드프레스 SEO 플러그인 충돌 문제를 해결했으니 이제 랭크매스 초기 설정을 해야 한다. 설치만 하면 자동으로 최적화되는 게 아니다. 랭크매스 설정 마법사에서 직접 사이트 정보를 입력해야 제대로 작동한다. 포커스 키워드가 REST로 안 먹힐 때 직접 넣는 방법은 이전 글에 정리해뒀다.

    같은 워드프레스 주제로 이어서 읽으면 좋은 글: WPCode로 보안 헤더 추가하다 코드가 깨진 이유, 대표 이미지가 잘리는 이유 , 템플릿 비율 3:2→16:9 차이, 워드프레스 SEO 버그 5개, curl로 찾은 공통 원인.

  • Claude Code 스킬 정리 후기, 죽은 폴더를 가리키던 스킬 1개와 메모리 4개

    Claude Code 스킬 정리 후기, 죽은 폴더를 가리키던 스킬 1개와 메모리 4개

    블로그 예약 발행 작업을 다 끝내고 나서 문득 이런 생각이 들었다. 계속 추가만 했지, 한 번도 정리를 안 했다는 걸. 그래서 Claude Code 스킬 정리를 처음으로 해봤다.

    Claude Code 스킬 정리를 해야겠다고 생각한 이유

    Claude Code에는 스킬(skill)과 메모리(memory)라는 개념이 있다. 스킬은 “블로그 포스팅해줘”처럼 특정 말을 하면 자동으로 실행되는 루틴이다. 메모리는 Claude가 작업할 때 참고하는 기록 파일들이다. 둘 다 쓸수록 쌓인다.

    나는 작업할 때마다 스킬을 추가하고, 메모리를 저장하고, 그걸 다시 꺼내 쓰는 방식으로 Claude를 활용해왔다. 근데 돌이켜보니 한 번도 뒤를 돌아본 적이 없었다. 쌓기만 했다.

    그래서 물어봤다. “지금 메모리랑 스킬 중에 삭제해도 무관한 거 있어?”

    오래 안 쓴 것을 찾는 대신 ‘없는 것’을 찾기로 한 결정

    처음 접근은 단순했다. 마지막으로 쓴 날짜 순으로 정렬해서 오래된 것부터 지우면 될 거라고 생각했다.

    근데 그게 안 됐다.

    세션(session, 한 번의 작업 대화 기록) 기록이 3주치밖에 남아 있지 않았고, 그 안에서 스킬이 실제로 호출된 횟수는 전부 합쳐서 20번이었다. 이 데이터를 기준으로 “안 쓴 것”을 추리면 멀쩡하게 살아 있는 스킬까지 다 걸린다. 판단 기준으로 쓸 수가 없었다.

    그래서 기준을 바꿨다. Claude Code 스킬 정리의 기준을 “오래 안 쓴 것”이 아니라 “없는 걸 가리키는 것”으로 잡았다. 존재하지 않는 폴더나 폐기된 프로젝트를 참조하고 있는 항목을 찾는 거다. 이건 기간 데이터가 없어도 확인할 수 있다.

    가장 자주 쓰는 말에 걸린 죽은 스킬 발견

    첫 번째로 나온 게 blog-automation이라는 스킬이었다.

    이 스킬의 트리거(trigger, 스킬을 작동시키는 특정 말이나 조건)는 “블로그 포스팅해줘”, “포스트 만들어줘” 같은 말이었다. 내가 가장 자주 쓰는 말이다. 그런데 이 스킬이 라우팅하는 대상이 blog-generator 폴더였고, 그 폴더는 이미 삭제된 지 오래였다. ai-blog-generator도 마찬가지였다. 폐기된 프로젝트였다.

    즉, “블로그 포스팅해줘”라고 하면 없는 폴더로 cd(폴더 이동 명령어) 하는 명령이 나올 수 있는 상태였다.

    언제부터 이랬는지는 모른다. 이 스킬을 만든 건 4월이고, 프로젝트가 폐기됐다고 기록해둔 건 8월 말이다. 그사이 어디쯤에서 깨졌을 텐데 정확한 시점을 알 방법이 없다. 깨진 걸 아무도 기록하지 않았으니까.

    조금 놀랐다. 그리고 열받았다. “왜 지금까지 나한테 말을 안 해줬을까”라는 생각이 먼저 들었는데, 내가 물어본 적이 없으니 말을 안 한 거다. 틀린 말도 아니다. 그게 더 답답했다.

    지금까지 Claude와 함께 만든 것들이 — 서브에이전트 7개로 만든 블로그 파이프라인 같은 것들이 , 이 스킬을 거쳐갔다면, 쏟아부은 노력에 구멍이 있었던 거다. 멀쩡히 작동하는 것처럼 보였을 뿐이고.

    메모리 파일에서 나온 4개의 좀비 참조들

    좀비 참조란 이미 삭제되거나 폐기된 대상을 가리키는 기록을 말한다. 실제로 없는데 있다고 믿고 있는 항목들이다.

    메모리 쪽에서는 네 개가 나왔다.

    • 폐기한 tech-blog-generator의 스킬 자동 업데이트 규칙
    • 폐기한 블로그의 글자 수 기준
    • 삭제된 blog-generator의 에이전트 구성 문서
    • 색인에 아예 등록되지 않은 고아 파일 하나

    전부 존재하지 않는 것을 가리키고 있었다.

    그중 세 번째가 특히 웃겼다. 삭제된 blog-generator의 에이전트 구성 문서는 그날 만든 거였다. 몇 시간 전에 세션 정리하면서 저장한 문서인데, 그 프로젝트가 이미 폐기됐다는 걸 모르고 저장한 거다. 만든 지 반나절도 안 된 메모리가 벌써 죽어 있었다.

    쌓이는 속도보다 썩는 속도가 더 빠를 수 있다는 걸 이때 처음 실감했다.

    Claude Code 스킬 정리 후 blog-automation 스킬 삭제, 메모리 57개→53개, MEMORY.md 끊긴 링크 0건을 터미널에서 직접 확인한 화면

    정리를 다 끝내고 나서 직접 확인한 화면이다. blog-automation은 더 이상 없고, 메모리는 53개로 줄었고, MEMORY.md 안에서 실제 파일을 못 찾는 링크는 하나도 없다.

    Claude Code 스킬 정리 결과와, 지우지 않은 것들

    정리 결과는 이렇다.

    항목 정리 전 정리 후
    메모리 파일 57개 53개
    색인 파일 줄 수 125줄 113줄
    스킬 blog-automation 포함 blog-automation 삭제

    고아 파일 하나는 지우지 않았다. 내용 자체는 쓸 만했기 때문에, 이미 있던 자율 처리 규칙 안으로 합쳤다. 내용은 버리지 않고 위치만 바꾼 거다.

    요즘 안 쓰는 스킬도 몇 개 더 있었는데, 그것들은 건드리지 않았다. 이유는 단순하다. 프로젝트 폴더가 다 살아 있었다. 깨진 게 아니라 지금 당장 안 하는 일일 뿐이다. “오래 안 썼다”는 이유 하나로 지우는 건 근거가 약하다. 지우지 않았다.

    앞으로 이런 문제를 줄이려면 어떻게 해야 할까

    Claude Code 스킬 정리를 매번 내가 물어봐서 하는 게 아니라, 이런 참조 오류를 수시로 체크해서 먼저 알려주는 Claude를 만들고 싶다. 근데 내 마음대로 안 된다. 그게 답답하다.

    한편으로는 나 자신이 문제였다는 것도 안다. 원하는 결과가 나오면 거기서 멈추는 습관. 더 이상 손대지 않으려 하는 것. 정리 같은 건 생각도 안 하는 것. 이번에 발견한 구멍은 그 습관이 만든 거다.

    당장 할 수 있는 건 하나다. 프로젝트를 폐기할 때 관련된 스킬과 메모리를 같이 정리하는 것. 지금은 추가할 때만 신경 쓰고 삭제할 때는 아무것도 안 한다. 그러니까 blog-automation처럼 언제 죽었는지도 모르는 스킬이 생기는 거다.

    폴더를 지울 때 그 폴더를 참조하는 스킬과 메모리도 같이 확인해야 한다. Claude Code 스킬 정리는 그때 같이 끝내는 게 맞다. 순서가 그래야 한다. 추가할 때 꼼꼼한 것보다, 삭제할 때 꼼꼼한 게 더 중요하다는 걸 이번에 배웠다.

    다음번에 또 이런 걸 발견하면, 그때도 내가 물어봐서 찾을 거다. 그게 지금은 좀 불만이지만, 적어도 묻는 습관은 들었다.

    CLAUDE.md 쪽에서 비슷하게 발견한 중복 지침은 CLAUDE.md 정리하다 발견한 중복 지침에 정리했다.