Claude Code로 구축하기

스텁에서 시작하기

프로젝트는 간단합니다: 날씨를 가져오는 TypeScript 파일입니다. 여기에는 두 개의 스텁이 포함되어 있습니다:

• getWeather — 도시를 입력받아 온도와 기상 상태를 반환합니다.
• run — 도구 실행기(tool runner)와 Claude TypeScript SDK를 사용해야 하는 함수입니다.

도구 실행기는 도구 호출과 에이전트 루프를 대신 처리해 주는 부분이므로, 직접 연결할 필요가 없습니다.

Claude API 스킬

Claude Code에는 Claude API라는 내장 스킬이 포함되어 있습니다. /claude-api로 직접 호출할 수도 있고, TypeScript SDK를 사용하는 것을 감지하면 Claude Code가 자동으로 호출합니다.

프롬프트 하나로 작동하는 코드

터미널에서 프로젝트 폴더를 열고 Claude Code를 실행하세요.

그 다음에는 프롬프트 하나만 있으면 됩니다. 좋은 프롬프트는 세 가지를 합니다:

• 변경하고자 하는 파일을 명시합니다.
• 사용하고자 하는 패턴을 명시합니다.
• 기대하는 최종 상태를 명시합니다.

그러면 Claude Code는 타입에 맞춰 getWeather와 run을 채우고, 파일 하단에 호출을 추가하고, 스크립트를 실행하고, 출력 결과를 보고합니다. 오류가 발생하면 오류 메시지를 읽고 코드를 즉시 수정합니다.



Claude Code가 만들어낸 결과

이번 실행에서 Claude Code는 입력을 파싱하고 도시 타입에 따라 출력을 반환하는 Zod 도구를 만들었습니다. 또한 우리가 요청한 도구 실행기와 run 함수를 만들고, 에이전트 루프의 최종 결과를 출력했습니다.



기억해야 할 패턴

Claude API를 대상으로 작성하는 대부분의 코드는 익숙한 형태를 가지고 있습니다:

1. 도구를 정의합니다.
2. 실행기에 전달합니다.
3. 결과를 반환합니다.

매번 이것을 기억해서 타이핑할 필요는 없습니다. 대신 파일을 스텁으로 만들고, Claude Code에 넘긴 다음, 차이점(diff)만 검토하세요.

요약

• Claude Code는 터미널 안에서 파일을 편집하고 명령을 실행하는 에이전트입니다.
• 내장된 Claude API 스킬은 Claude Code가 TypeScript SDK를 감지하면 자동으로 로드되며, /claude-api로 직접 호출할 수도 있습니다.
• 파일, 패턴, 최종 상태를 명시하는 프롬프트를 주면 — 코드를 작성하고, 실행하고, 오류를 즉시 수정합니다.
• Claude API 코드는 익숙한 형태를 따릅니다: 도구를 정의하고, 실행기에 전달하고, 결과를 반환합니다. 스텁으로 만들고, 위임하고, 차이점을 검토하세요.