클로드 코드 solana-dev 스킬, 지갑 연결부터 오류 진단까지

오른쪽에 놓인 투명한 하드웨어 지갑 내부의 회로와 거래 토큰을 표현한 이미지

지갑을 연결했는데도 서명과 전송 단계에서 막힌 적 있으신가요?

화면을 만드는 일, 블록체인에 올릴 프로그램 작성, 테스트는 서로 다른 문제처럼 느껴집니다. solana-dev 스킬은 이 과정을 한 흐름으로 다루도록 설계됐습니다.

핵심 내용

solana-dev는 솔라나 기반 앱의 화면 구성부터 지갑 연결, 거래 작성·서명·전송 과정까지 요청할 때 쓰는 Claude Code 스킬입니다.
블록체인에 올릴 프로그램 작성과 구조 설계, 앱에서 사용할 코드 생성, 로컬 테스트와 보안 점검도 범위에 포함합니다.
최신 문서를 찾거나 개념을 설명하고 오류를 진단할 수 있도록 솔라나 MCP 서버 연동도 포함합니다.
도구 버전 충돌, GLIBC 오류, 의존성 충돌, Anchor와 Solana CLI 업그레이드 문제까지 다룹니다.

🧩 solana-dev 한눈에 보기

누적 설치 76,800회 · GitHub 별 562개
저장소: solana-foundation/solana-dev-skill
보안 감사 3종 모두 통과 (skills.sh 기준)

터미널에 붙여 넣으면 설치됩니다.

npx skills add https://github.com/solana-foundation/solana-dev-skill --skill solana-dev

어디서 가장 막힐까

솔라나 앱은 화면만 고친다고 끝나지 않습니다. 사용자 지갑을 연결하고, 거래 내용을 만든 뒤 서명을 받고 전송 결과까지 보여 주는 흐름이 이어져야 하죠.

solana-dev는 React 또는 Next.js 화면 작업부터 지갑 연결, 거래 작성·전송·확인 화면까지 요청 범위에 둡니다. 새 코드에는 거래 형식 v1과 더 큰 거래까지 다루도록 안내합니다.

코드를 전부 이해하지 못해도 괜찮습니다. 우선 원하는 사용자 흐름부터 말하면 됩니다. 지갑을 연결한 뒤 무엇을 보여 줄지, 서명이 끝난 다음에는 어떤 상태를 표시할지 함께 요청하는 식이죠.

💡 꿀팁 · 처음에는 기능 하나만 정하고, 지갑 연결 뒤 사용자가 보게 될 화면 순서를 함께 적어 보세요.

코드 밖 문제도 다룰까

개발하다 보면 코드보다 도구 버전이 맞지 않아 멈추는 경우가 있습니다. 설치 중 오류가 나거나 라이브러리끼리 충돌하면, 어디부터 확인해야 할지 막막하거든요.

이 스킬은 개발 도구 설치, 버전 불일치, GLIBC 오류, 의존성 충돌까지 범위에 넣습니다. Anchor와 Solana CLI 버전을 올리거나 버전 사이를 옮겨야 하는 상황도 다룹니다. 흔한 오류와 호환 관계를 참고하는 방식도 포함돼 있습니다.

솔라나 MCP 서버와 연결해 현재 문서를 검색하고, 개념 설명이나 오류 진단에 활용하도록 구성됐습니다. 기억에만 기대지 않고 문서를 확인하며 문제를 좁혀 가야 할 때 잘 맞습니다.

💡 꿀팁 · 오류를 물을 때는 오류 문구와 사용 중인 도구 버전을 한 요청에 함께 넣으세요.

무엇이라고 시킬까

처음부터 큰 서비스를 맡기기보다 지금 막힌 작업을 한 문장으로 구체적으로 적는 편이 좋습니다. 이 스킬은 화면과 지갑 흐름은 물론 블록체인 프로그램, 테스트, 보안 점검 요청까지 대상으로 둡니다.

기존 코드가 오래된 방식으로 작성됐다면 이전 작업도 요청할 수 있습니다. web3.js v1 코드를 web3.js v3 또는 Kit 방식으로 바꾸는 범위도 명시돼 있습니다.

테스트가 빠졌다면 로컬에서 확인하는 방법까지 함께 요구해 보세요. 단위 테스트에는 LiteSVM과 Mollusk, 여러 부분을 함께 확인하는 테스트에는 Surfpool을 다루고, 더 강한 테스트 도구도 범위에 포함합니다.

💡 꿀팁 · 아래 문장 중 하나를 복사한 뒤 프로젝트 폴더와 현재 오류 상황만 덧붙여 요청해 보세요.

그래서 나에게 무엇이 달라질까

솔라나 앱 작업은 화면, 지갑, 거래, 테스트가 맞물려 있어 한 부분에서 막히면 전체 작업이 멈출 수 있습니다. solana-dev를 두면 Claude Code에 현재 단계와 문제를 더 구체적으로 맡길 수 있습니다. 1인 개발자라면 도구 버전 문제와 테스트 범위까지 한 흐름 안에서 물어볼 출발점이 생깁니다.

내일 바로 써먹기

Claude Code에 “Solana 앱의 지갑 연결과 서명 흐름을 solana-dev 스킬 기준으로 만들어 줘”라고 요청해 보세요.
현재 프로젝트에서 쓰는 Solana 관련 도구와 라이브러리 버전을 모아 호환 문제를 점검해 달라고 요청하세요.
“이 Solana 거래 전송 흐름에 필요한 로컬 테스트 항목을 정리하고 테스트 코드를 제안해 줘”라고 입력해 보세요.

용어사전

Solana · 앱이 거래 기록과 프로그램을 올릴 수 있는 블록체인 환경입니다.
dApp · 블록체인과 연결해 동작하는 앱을 뜻합니다. 일반 웹 화면과 블록체인 기능이 함께 들어갈 수 있습니다.
Anchor · 솔라나에서 블록체인 프로그램을 만들 때 쓰는 개발 도구입니다.
MCP · AI가 외부 도구나 자료에 연결해 정보를 찾고 작업을 돕도록 하는 연결 방식입니다.
RPC · 앱이 블록체인에 거래를 보내거나 정보를 읽을 때 쓰는 통신 창구입니다.
GLIBC · 일부 개발 도구가 실행될 때 필요한 시스템 구성 요소입니다. 맞지 않으면 실행 오류가 날 수 있습니다.

출처

원문: skills.sh · https://skills.sh/solana-foundation/solana-dev-skill/solana-dev

함께 읽으면 좋은 글

오늘 글이 재미있으셨다면, 제 공간에도 한 번 놀러 와 주세요 🙂

제 인포크 링크 둘러보기