Claude Code 지원

환경별 지원 모델 ID로 Claude Code를 연결하세요. 텍스트 및 stream-json 파일 읽기를 확인했습니다.

지원 안내#

Motif 3, GLM 5.3, Kimi K3의 Claude Code 연동을 지원합니다. 아래 설정으로 Morfac API 키를 연결해 사용할 수 있습니다. 도구 실행과 정확한 출력은 계속 개선하고 있습니다.

이 안내는 Anthropic 호환 /v1/messages API를 사용하는 Motif 3, GLM 5.3, Kimi K3 연결을 다룹니다. 실제 응답 모델은 --model로 선택한 모델이며 Anthropic의 Claude 모델이 아닙니다. OpenAI 호환 Chat Completions 엔드포인트만으로 이 연결을 대체할 수는 없습니다.

항목	제공 범위
기본 텍스트 출력 / 파일 읽기	지원. Read 호출, 도구 결과 전달, 최종 답변 확인
CLI `--output-format stream-json`	Claude Code 2.1.306에서 지원. 출력 전용 모드에서는 `--verbose` 함께 사용
파일 수정 / 명령 실행	이번 Read 검증 범위 밖. 실제 파일 변경과 명령 결과를 별도로 확인
작업 완료 / 정확한 출력	도구 호출이 누락되거나 반복될 수 있으며, 줄 번호나 설명이 추가되는 문제를 개선 중

작업 완료 여부는 모델과 작업에 따라 달라집니다. HTTP 응답 스트리밍과 CLI의 stream-json 출력 옵션은 별개입니다. 다른 Claude Code 버전이나 기능의 호환성은 별도 확인이 필요합니다.

모델 연결하기#

확인한 CLI 버전은 2.1.306입니다. 콘솔에서 활성 API 키를 생성하거나 기존 키를 사용하세요. 키는 로컬 인증 저장소 또는 비공개 셸 세션의 MORFAC_API_KEY에 설정하세요. 소스 코드나 공유 명령 이력에 키를 남기지 마세요.

아래 표에서 모델을 선택하세요. 모델을 바꿀 때는 --model만 변경하며 API 주소와 키는 같습니다.

모델	모델 ID	실행 명령
Motif 3	`motif/motif-3`	`claude --bare --model motif/motif-3`
GLM 5.3	`z-ai/glm-5.3`	`claude --bare --model z-ai/glm-5.3`
Kimi K3	`moonshotai/kimi-k3`	`claude --bare --model moonshotai/kimi-k3`

이 목록은 지원하는 연결을 안내합니다. 현재 호출 가능 여부는 인증된 GET /v1/models의 callable과 blocking_reasons로 확인하세요. 목록에 있어도 일시적으로 호출할 수 없을 수 있습니다. 텍스트·stream-json에서 Read 왕복과 정확한 최종 출력을 확인했으며, 모델 간 일반 코딩 품질이 같다는 뜻은 아닙니다.

별도 터미널에서 현재 세션의 연결을 설정합니다.

export ANTHROPIC_BASE_URL="https://api.dev.morphfactory.io"
export ANTHROPIC_API_KEY="$MORFAC_API_KEY"
claude --bare --model motif/motif-3

ANTHROPIC_BASE_URL 끝에 /v1을 붙이지 마세요. --bare는 검증에 사용한 최소 CLI 경로입니다. 기존 설정과 인증 정보는 유지하세요. 이 예시는 설정 파일을 덮어쓰지 않습니다. 작업에 필요한 파일과 명령 권한만 선택하세요.

출력 전용 모드에서 줄 단위 JSON이 필요하면 다음과 같이 실행합니다.

claude --bare --model motif/motif-3 --verbose --output-format stream-json -p "Say hello briefly."

짧은 텍스트 요청으로 연결을 확인한 뒤, 민감하지 않은 파일의 실제 Read 동작을 확인하고 프로젝트 작업을 시작하세요. 요청에는 Morfac 크레딧이 사용됩니다. CLI의 게이트웨이 요구사항은 Claude Code 공식 안내를 참고하세요. 이 문서의 모델 연결은 Morfac이 제공합니다.

파일 읽기 요청 예시#

작업할 파일, 사용할 도구, 최종 답변의 형식을 함께 지정하세요. 아래 경로는 예시이므로 본인의 프로젝트 파일로 바꿔 주세요.

사례 1: 파일을 실제로 읽게 하기

“파일을 확인해 줘” 대신 먼저 할 행동을 구체적으로 요청하세요.

text

Your first action must be to call the Read tool on ./sample.txt.
Do not guess the file contents or simulate a tool call in text.
If Read fails, report the error instead of inventing contents.

답변에 파일 내용이 보이는지만 확인하지 말고, Claude Code에 실제 Read 실행과 도구 결과가 표시됐는지도 확인하세요.

사례 2: 줄번호 없이 파일 내용만 받기

이 예시는 한 줄짜리 파일을 읽는 경우입니다.

“한 줄만 출력해 줘”라는 지시에도 Read 화면의 줄번호나 설명이 최종 답변에 붙을 수 있습니다. 제외할 요소까지 명시하세요.

text

Your first action must be to call the Read tool on ./sample.txt.
After Read succeeds, copy the file's single line exactly as your entire final answer.
The line numbers shown by Read are display metadata: omit them.
Do not add quotes, Markdown, a prefix, or an explanation.
If Read fails, report the error instead of inventing contents.

예를 들어 파일의 한 줄이 MORFAC_READ_OK라면 최종 답변도 MORFAC_READ_OK만이어야 합니다. 줄번호나 “파일 내용:”이 붙으면 형식이 일치하지 않은 것입니다.

이 요청 방식도 성공을 보장하지는 않습니다. 같은 파일을 반복해서 읽거나 형식이 계속 다르면 작업을 멈추고 실제 도구 결과와 최종 답변을 비교하세요. 자동 처리에 사용할 출력은 애플리케이션에서도 기대 형식과 일치하는지 확인하세요.

연결 문제 확인#

인증 오류

콘솔에서 API 키가 활성 상태인지 확인하세요.

주소 / 모델 오류

API 주소는 https://api.dev.morphfactory.io입니다. 주소 끝에 /v1을 추가하지 마세요.

모델 ID는 motif/motif-3, z-ai/glm-5.3, moonshotai/kimi-k3 중 하나를 정확히 사용하세요. 커스텀 모델의 context window 경고만으로 API 실패를 의미하지는 않습니다. 실제 응답과 모델 카탈로그의 context 한도를 확인하세요.

공급자 요청 제한 / 일시적인 호출 불가

공급자의 429는 요청 제한이며, 503은 게이트웨이에 준비된 경로가 없을 때도 발생할 수 있습니다. 현재 모델 상태를 확인하고 요청 ID를 보관하세요. Retry-After가 있으면 기다리고 즉시 반복 요청하지 마세요. 이 오류만으로 키 오류나 크레딧 부족이라고 판단하지 않습니다.

출력 모드 오류

이 연결은 확인한 CLI 버전의 --output-format stream-json을 수락합니다. 출력 전용 모드에서는 --verbose를 함께 사용하세요. 문제가 생기면 CLI 버전과 오류를 확인하고, 기본 텍스트 출력으로 연결 오류와 출력 모드 오류를 나누어 확인하세요.

파일 수정 / 테스트 확인

실제 파일 변경과 테스트 결과를 직접 확인하세요. 최종 답변만으로 작업 완료를 판단하지 마세요.

파일은 버전 관리하고, 작업에 필요한 파일과 명령만 허용하세요.

문의할 때

Claude Code 버전, 오류 문구, 발생 시각을 알려주세요. 요청 ID가 있으면 함께 보내주세요.

API 키, 인증 헤더, 비밀번호, 프로젝트의 비공개 내용은 제외해 주세요.

다른 연결 방법#

빠른 시작으로 Chat Completions를 직접 호출하거나 다른 도구 가이드를 선택할 수 있습니다.