Z Code에서 Wokey API 사용하기

1. 1

   모델 설정 열기

   채팅 입력창의 모델 이름 → Manage Models를 클릭하거나 Settings → Model Settings로 이동하세요.

2. 2

   공급자 추가

   Add Provider를 클릭하고 이름을 Wokey로 지정하세요. Anthropic 형식은 Base URL을 https://api.wokey.ai로, OpenAI 형식은 https://api.wokey.ai/v1로 설정하세요. API Key에 Wokey API 키를 붙여 넣으세요.

3. 3

   모델 추가 및 활성화

   공급자 아래에서 Add Model을 클릭하고 claude-opus-5-5 같은 모델 ID를 입력한 뒤 활성화 스위치를 켜세요.

4. 4

   모델 전환

   채팅 입력창으로 돌아가 모델 목록에서 추가한 모델을 고르고 짧은 메시지를 보내 확인하세요.

Provider name: Wokey
API format: Anthropic
Base URL: https://api.wokey.ai
API Key: YOUR_API_KEY
Model ID: claude-opus-5-5

설정 위치: Settings → Model Settings(파일 ~/.zcode/v2/config.json)

Z Code는 기본적으로 Anthropic Messages 형식을 사용합니다. 이 요청이 200을 반환하면 API 키와 Base URL이 올바른 것입니다. 보내기 전에 YOUR_API_KEY를 내 키로 바꾸세요.

curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Z Code의 Base URL은 /v1로 끝나야 하나요?

연결에 사용하는 API 형식에 따라 다릅니다. Anthropic이면 /v1 없이 https://api.wokey.ai를, OpenAI이면 https://api.wokey.ai/v1을 사용하세요.

터미널에서 export한 환경 변수가 적용되지 않는 이유는 무엇인가요?

터미널 환경 변수와 Z Code 데스크톱 앱의 모델 설정은 서로 별개이며 동기화되지 않습니다. Base URL과 API 키는 Settings → Model Settings의 공급자에 입력하세요.

공급자를 추가했는데 모델을 선택할 수 없는 이유는 무엇인가요?

각 공급자에서 Add Model로 모델 ID를 입력하고 해당 모델의 활성화 스위치를 켜야 채팅창의 모델 목록에 나타납니다.

출력이 잘리거나 컨텍스트가 부족하면 어떻게 하나요?

모델의 Advanced를 열고 Max output tokens와 context window를 모델 페이지의 값에 맞게 조정하세요. 새로 추가한 모델의 컨텍스트 윈도우는 기본값이 200000입니다.

Z Code는 이 설정을 어디에 저장하나요?

~/.zcode/v2/config.json에 저장합니다. 컴퓨터를 옮기거나 다시 설치하기 전에 이 파일을 백업하세요. API 키가 들어 있으므로 공유하지 마세요.