Claude for Sheets 설치하기

다음 단계를 따라 Claude for Sheets를 쉽게 활성화할 수 있습니다:

  1. Claude API 키 받기: 개발자 API 키가 없으면 Claude for Sheets를 사용할 수 없습니다. API 키를 얻는 방법에 대한 자세한 내용은 Claude 액세스 받기를 참조하세요.
  2. Claude for Sheets 확장 프로그램 설치
    1. 여기를 클릭하여 Claude for Sheets 확장 프로그램에 액세스하거나 애드온 마켓플레이스에서 Claude for Sheets를 검색하세요.
    2. 파란색 설치 버튼을 클릭하고 권한을 수락하세요.
  3. API 키 연결: 확장 프로그램 > Claude for Sheets™ > Anthropic API 키 입력에서 API 키를 입력하세요. “Anthropic API 키 입력” 옵션이 나타날 때까지 기다리거나 새로 고침해야 할 수 있습니다.

녹색 ‘확인됨’ 체크 표시 ✅가 나타나면 Claude가 Google Sheet 내에서 활성화되어 사용할 준비가 된 것입니다.

새 Google Sheet를 만들 때마다 API 키를 다시 입력해야 합니다.

권한

설치 중에 Claude for Sheets 확장 프로그램은 제대로 작동하는 데 필요한 다양한 권한을 요청합니다. Claude를 Sheets에서 실행하는 데 필요한 권한이 광범위하지만, 사용자가 Claude에 실행하도록 요청한 특정 데이터 조각만 처리한다는 점을 안심하시기 바랍니다. 이 데이터는 절대 우리의 생성 모델을 훈련하는 데 사용되지 않습니다.

확장 프로그램 권한은 다음과 같습니다:

  • 이 애플리케이션이 설치된 스프레드시트 보기 및 관리 - 프롬프트를 실행하고 결과를 반환하는 데 필요
  • 외부 서비스에 연결 - Anthropic의 API 엔드포인트를 호출하는 데 필요
  • 사용자가 없을 때 이 애플리케이션 실행 허용 - 사용자 개입 없이 셀 재계산을 실행하는 데 필요
  • Google 애플리케이션 내 프롬프트 및 사이드바에서 타사 웹 콘텐츠 표시 및 실행 - 사이드바 및 설치 후 프롬프트를 표시하는 데 필요

셀 재계산

Claude for Sheets 확장 메뉴 내 재계산 옵션에서 선택하여 #ERROR!, ⚠ DEFERRED ⚠ 또는 ⚠ THROTTLED ⚠ 셀을 수동으로 재계산할 수 있습니다.


Claude for Sheets 사용 방법

Claude 함수

Claude for Sheets를 사용하여 Claude를 호출하는 데 사용할 수 있는 두 가지 주요 함수가 있습니다:

1. CLAUDE()

=CLAUDE(prompt, model, params...)

CLAUDE()는 Claude for Sheets를 사용하여 Claude를 호출하는 가장 간단한 방법입니다. 이 함수를 사용하려면 추가 서식 없이 일반 텍스트 프롬프트만 있으면 됩니다. 대부분의 경우 사용하게 될 함수입니다. 이는 Slackbot Claude 인터페이스 및 Console의 “Chat” 모드와 동일합니다.

CLAUDE() 프롬프트 예시
프롬프트함수 형식
한 문장으로, 파란색의 장점은 무엇인가요?=CLAUDE(“한 문장으로, 파란색의 장점은 무엇인가요?“)
한 문장으로, 파란색의 장점은 무엇인가요? 답변을 <answer> 태그로 출력하세요.[With parameters]=CLAUDE(“한 문장으로, 파란색의 장점은 무엇인가요? 답변을 태그로 출력하세요.”,“claude-3-opus-20240229”,“temperature”, 0.2,“max_tokens”, 50,“stop_sequences”, ”[""""]”,“api_key”, “sk-ant-api03-j1W…“)

2. CLAUDEMESSAGES()

=CLAUDEMESSAGES(prompt, model, params...)

CLAUDEMESSAGES()를 사용하여 Messages API를 사용하는 것처럼 일련의 User:Assistant: 메시지를 Claude에 보낼 수 있습니다. 이는 대화를 시뮬레이션하거나 Claude의 응답을 미리 채우려는 경우에 특히 유용합니다.

각 역할(User: 또는 Assistant:)은 단일 줄 바꿈으로 시작해야 합니다. 셀에 줄 바꿈을 입력하려면 다음 키 조합을 사용하세요:

  • Mac: Cmd + Enter
  • Windows: Alt + Enter
미리 채워진 어시스턴트 응답이 있는 CLAUDEMESSAGES() 프롬프트 예시
프롬프트함수 형식
User: 한 문장으로, 파란색의 장점은 무엇인가요?Assistant: 파란색은 다음과 같은 이유로 좋습니다=CLAUDEMESSAGES(“User: 한 문장으로, 파란색의 장점은 무엇인가요?Assistant: 파란색은 다음과 같은 이유로 좋습니다”)
시스템 프롬프트가 있는 CLAUDEMESSAGES() 호출 예시

시스템 프롬프트를 사용하려면 다른 선택적 함수 매개변수를 설정하는 것처럼 설정하세요. (먼저 모델 이름을 설정해야 합니다.)

=CLAUDEMESSAGES("User: 저에게 할 말이 있나요? Assistant:", "claude-2.0", "system", "당신은 모든 사용자 질문에 응답하여 울음소리를 내는 것을 좋아하는 소입니다.")

3. [레거시] CLAUDEFREE()

=CLAUDEFREE(prompt, model, params...)

CLAUDEFREE()를 사용하면 레거시 Text Completions API를 사용하는 것처럼 Claude를 호출할 수 있습니다. 이 함수를 사용하려면 Text Completions 프롬프트에서와 같이 프롬프트를 \n\nHuman:\n\nAssistant: 사이에 수동으로 넣어야 합니다. 셀에 프롬프트를 작성할 때 \n\n을 실제 줄 바꿈 두 개로 바꾸세요.

CLAUDEFREE의 특수 “Human:”/“Assistant:” 형식에 대한 자세한 내용은 Text Completions API 문서를 참조하세요.

CLAUDEFREE() 프롬프트 예시
프롬프트함수 형식
Human: 한 문장으로, 파란색의 장점은 무엇인가요?Assistant:=CLAUDEFREE(“Human: 한 문장으로, 파란색의 장점은 무엇인가요?Assistant:“)

참고: 이 전체 여러 줄 문자열은 프롬프트 매개변수에 들어가야 합니다. Human: 앞에 줄 바꿈이 두 개 있는 것도 주목하세요.

선택적 함수 매개변수

API 매개변수를 지정하려면 인수-값 쌍을 나열하면 됩니다. 예를 들어 max_tokens를 3으로 설정하려면 다음과 같이 할 수 있습니다: =CLAUDE("[your prompt]", "claude-instant-1.2", "max_tokens", 3).

여러 매개변수를 설정할 수 있습니다. 각 인수와 값 쌍을 쉼표로 구분하여 차례로 나열하기만 하면 됩니다. 처음 두 매개변수는 항상 프롬프트와 모델(사용 가능한 모델)이어야 합니다. 모델을 설정하지 않고 선택적 매개변수를 설정할 수는 없습니다.

예를 들어 다음은 유효한 CLAUDE 함수입니다: =CLAUDE("[your prompt]", "claude-instant-1.2", "system", "[system prompt]", "max_tokens", 3, "temperature", 0.5)

가장 중요하게 여길 수 있는 인수-값 매개변수는 다음과 같습니다:

  • max_tokens - 모델이 강제로 중지되기 전에 출력하는 총 토큰 수입니다. 예/아니오 또는 객관식 답변의 경우 1-2를 원할 것입니다. 각 모델의 최대 완성 길이는 모델 비교 표를 참조하세요.
  • temperature - 결과에 주입되는 무작위성의 양입니다. 객관식 또는 분석 작업의 경우 0에 가깝게 설정하고 싶을 것입니다. 아이디어 생성을 위해서는 1로 설정하고 싶을 것입니다.
  • system - =CLAUDEMESSAGES() 및 =CLAUDE()를 사용할 때 Claude에 컨텍스트와 지침을 제공할 수 있는 시스템 프롬프트를 지정하는 데 사용됩니다.
  • stop_sequences - 모델이 만나면 텍스트 생성을 중지하게 만드는 문자열의 JSON 배열입니다. Google Sheets™의 이스케이프 규칙으로 인해 문자열 내의 큰따옴표는 큰따옴표를 두 번 사용하여 이스케이프해야 합니다.
  • api_key - Claude를 호출할 특정 API 키를 지정하는 데 사용됩니다

Claude for Sheets 가이드 및 예시

프롬프트 엔지니어링 대화형 튜토리얼

API 버전 참고

프롬프트 엔지니어링 대화형 튜토리얼 및 [프롬프팅 예시 워크벤치](https://docs.google.com/spreadsheets/d/1sUrBWO0u1-ZuQ8m5gt3-1N5PLR6r%5F%5FUsRsB7WeySDQA/edit?u sp=sharing)와 같이 이 섹션 내에 링크된 모든 Claude for Sheets 스프레드시트는 현재 Text Completions API를 호출하는 레거시 CLAUDEFREE() 함수를 사용합니다. 이들은 곧 CLAUDEMESSAGES()와 Messages API를 활용하도록 업데이트될 예정입니다.

Claude for Sheets 애드온을 활용하는 심층적인 프롬프트 엔지니어링 대화형 튜토리얼을 통해 초급부터 고급까지의 프롬프트 엔지니어링 기술을 배우거나 복습하세요.

Claude for Sheets의 나머지 부분과 마찬가지로 튜토리얼과 상호 작용하려면 API 키가 필요합니다.

Claude for Sheets 프롬프팅 예시

예시 프롬프트, 프롬프팅 구조 및 Claude 기반 스프레드시트는 Claude for Sheets 프롬프팅 예시 워크벤치를 참조하세요. 여기에서 다음과 같은 작업에 대한 예시를 찾을 수 있습니다:

  • 장문 문서 Q&A
  • 정보 추출
  • PII 제거
  • FAQ를 사용한 고객 지원 챗봇
  • 학업 튜터
  • 프롬프트 체이닝
  • 함수 호출
  • 그 외 다수!

Claude for Sheets 워크북 템플릿

Claude for Sheets 워크북 템플릿의 사본을 만들어 자신만의 Claude for Sheets 작업을 시작하세요!


문제 해결

NAME? 오류: 알 수 없는 함수: ‘claude’.

  1. 현재 시트에서 사용할 수 있도록 확장 프로그램을 활성화했는지 확인하세요
    1. 확장 프로그램 > 애드온 > _애드온 관리_로 이동하세요
    2. Claude for Sheets 확장 프로그램의 오른쪽 상단 모서리에 있는 세 개의 점 메뉴를 클릭하고 “이 문서에서 사용”이 선택되어 있는지 확인하세요
  2. 페이지를 새로 고침하세요

API 키를 입력할 수 없음

  1. 20초 정도 기다린 후 다시 확인하세요
  2. 페이지를 새로 고침하고 다시 20초 정도 기다리세요
  3. 확장 프로그램을 제거했다가 다시 설치하세요

추가 정보

이 확장 프로그램에 대한 자세한 내용은 Claude for Sheets Google Workspace Marketplace 개요 페이지를 참조하세요.