Token Plan (Team Edition)
Credits 기반 사용, 지정된 사용자 계정, 기존 Claude Code 워크플로 내에서 알리바바 호스팅 모델을 활용하려는 팀에 가장 적합합니다.
도구 + 모델 연계
Claude Code과 알리바바 코딩 계획 및 크레딧 계획 (Token Plan)
자연어 프로그래밍, 코드 수정, 디버깅 및 리포지토리 탐색에 일반적으로 사용되는 터미널 코딩 어시스턴트입니다.
Claude Code는 알리바바의 Anthropic 호환 엔드포인트를 통해 알리바바에서 호스팅하는 모델을 사용할 수 있습니다. 핵심은 인증 토큰, 기본 URL 및 모든 기본 모델 별칭이 동일한 알리바바 요금제를 가리켜야 한다는 점입니다.
올바른 액세스 경로 선택
올바른 액세스 경로 선택
팀이 이미 Claude Code 환경에서 작업 중이라면 이 도구가 명확히 적합합니다. Anthropic 호환 엔드포인트를 구성하고, 로컬 온보딩 플래그를 완료한 후, 저장소 작업을 시작하기 전에 `/status` 엔드포인트를 검증하세요.
추천개별 사용자에게는 Coding Plan, 지정된 팀 또는 지속적인 에이전트 사용에는 Token Plan
Coding Plan
고정된 월간 요청 한도 내에서 Claude Code를 대화형으로 사용하는 개별 개발자에게 가장 적합합니다.
Pay-as-you-go Model Studio API
Claude Code가 백엔드, 자동화 또는 서비스의 개발 인터페이스에 불과하고, 해당 시스템이 Model Studio를 직접 호출할 경우 반드시 필요합니다.
안전한 구성 패턴
Claude Code를 알리바바의 Anthropic 호환 엔드포인트로 연결하기
예시는 의도적으로 마스킹되어 있습니다. 플레이스홀더는 사용자의 기기에서만 교체하고, 실제 API 키를 Nfero에 붙여넣지 마세요.
시작하기 전에
- Claude Code에서 지원하는 최신 Node.js 릴리스를 설치하고 `claude --version` 명령어로 버전을 확인합니다.
- Windows에서는 알리바바 설정 안내서에 설명된 대로 WSL 또는 Git Bash를 사용하세요.
- Claude Code가 Anthropic 로그인 검증을 시도하지 않도록 `~/.claude.json` 파일 내 `hasCompletedOnboarding` 값을 `true`로 설정합니다.
- 전용 요금제 키를 확보하고, 이를 셸 기록, 저장소, 스크린샷, 공유 설정 파일 등에 노출되지 않도록 주의하세요.
안전한 구성 패턴
- 프로토콜
- Anthropic-compatible
- 구성 경로
~/.claude/settings.json
- 아래의 Token Plan 엔드포인트를 사용하거나, Coding Plan의 경우 `https://coding-intl.dashscope.aliyuncs.com/apps/anthropic`으로 대체합니다.
- 기본 및 기본 별칭에 대해 선택된 요금제에서 지원하는 모델을 사용합니다.
- 가리기 처리된 자리표시자만 로컬 파일에서 교체한 후, 새 터미널을 열고 최소한의 프롬프트를 테스트합니다.
- `/status` 명령어를 실행하고 기본 URL이 `api.anthropic.com`이 아니라 Alibaba Model Studio임을 확인합니다.
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_TOKEN_PLAN_API_KEY",
"ANTHROPIC_BASE_URL": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic",
"ANTHROPIC_MODEL": "qwen3.7-plus",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-plus",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
"CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.7-plus"
}
}연결 확인
- 새 터미널을 열고 `claude "hello"` 명령어를 실행합니다.
- `/status` 명령어를 실행한 후 `ANTHROPIC_BASE_URL`, 모델, 인증 경로를 확인합니다.
- 파일 또는 터미널 작업을 허용하기 전에 읽기 전용 저장소 요약을 요청합니다.
- 첫 번째 세션 후 요금제 사용량을 확인하여 요청이 의도한 구독에서 차감되고 있는지 확인합니다.
모델 연계
추천 시작 모델
이 도구을 사용하여 각 모델과 함께 대화형 코딩, 추론, 검토 및 문서 작업을 수행하세요. 생산 환경에서 최종 모델 가용성과 정확한 계획 지원은 Alibaba Cloud에서 확인하십시오.
Qwenqwen3.7-plus
텍스트 생성추론시각적 이해
최적의 조합 각도
알리바바의 현재 Coding Plan 예시이자 강력한 일반 코딩/추론 기본 모델입니다.
Qwenqwen3.7-max
텍스트 생성추론
최적의 조합 각도
어려운 추론 작업 및 대규모 코드베이스에 적합한 플래그십 Token Plan 선택입니다.
Qwenqwen3.6-flash
텍스트 생성추론시각적 이해
최적의 조합 각도
Token Plan 내 경량 하위 작업을 위한 저비용 기본 모델로 유용합니다.
자주 발생하는 문제
자주 발생하는 문제
증상
Anthropic 서비스 또는 api.anthropic.com에 연결할 수 없음
가능한 원인
Alibaba 환경 변수가 누락되었거나, 터미널에서 새로 고침되지 않았거나, 온보딩 절차가 완료되지 않았습니다.
해결 방법
`hasCompletedOnboarding` 값을 설정하고, `settings.json` 파일을 확인한 후 새 터미널을 열어 `/status` 명령어로 Alibaba URL을 검증합니다.
증상
401 오류 또는 유효하지 않은 액세스 토큰
가능한 원인
요금제 키와 Anthropic 호환 기본 URL이 동일한 구독에 속하지 않습니다.
해결 방법
전용 키는 Token Plan 또는 Coding Plan Anthropic 엔드포인트 중 하나와만 쌍을 이루어야 하며, 두 엔드포인트를 혼용해서는 안 됩니다.
증상
모델을 찾을 수 없음
가능한 원인
Claude Code의 주요 모델, Haiku, Sonnet, Opus 또는 서브에이전트 별칭 중 하나가 선택된 요금제의 허용 목록에 없는 모델을 가리킵니다.
해결 방법
모든 별칭을 정확히 지원되는 모델 ID로 설정한 후 Claude Code를 재시작합니다.
증상
컨텍스트 길이 오류 또는 예상치 못하게 높은 사용량
가능한 원인
Claude Code는 하나의 작업 중에 여러 파일을 스캔하고 여러 번의 모델 호출을 수행할 수 있습니다.
해결 방법
가능한 한 최소한의 관련 프로젝트 디렉터리에서 열고, 관련 없는 파일은 제외하며, 필요 시 작업을 분할하고 새 세션을 시작합니다.
주요 제한 사항
- 전용 API 키와 기본 URL은 반드시 동일한 알리바바 청구 요금제에서 가져와야 합니다. Coding Plan, Token Plan, 일반 Model Studio 자격 증명은 상호 교환 불가능합니다.
- 요금제 키는 지정된 사용자의 대화형 코딩 또는 에이전트 도구 전용입니다. 이를 공유하거나 저장소에 커밋하거나 스크린샷에 노출해서는 안 됩니다.
- 자동화된 스크립트, 배치 작업, 애플리케이션 백엔드, 공용 서비스 또는 기타 비대화형 API 워크로드에는 Coding Plan 또는 Token Plan 키를 사용해서는 안 됩니다. 이러한 워크로드에는 pay-as-you-go Model Studio API 접근 권한을 사용해야 합니다.
- 모델 가용성은 정확한 문자열 허용 목록(allowlist)이며, 언제든지 변경될 수 있습니다. 작동 중인 설정을 수정하기 전에 현재 Alibaba Cloud Token Plan 문서에서 모델 ID를 반드시 확인하세요.