OpenCode

Fast-Token에서 OpenCode 서드파티 API 구성

OpenCode는 API 연동을 높은 수준으로 커스터마이즈할 수 있는 오픈소스 AI 코딩 어시스턴트입니다. 서드파티 API를 구성하면 성능이 더 강하거나 가성비가 좋은 모델(DeepSeek, SiliconFlow 등)을 자유롭게 선택할 수 있습니다.

1단계: API 핵심 정보 준비

구성 전에 다음을 준비하세요.

1. API Key: 인증 키. Fast-Token 플랫폼
2. Base URL: 엔드포인트 주소(예: https://fast-token.com/v1).
3. Model ID: 모델 이름(예: deepseek-ai/DeepSeek-V3).

2단계: 설정 화면 열기

1. OpenCode를 실행합니다.
2. 왼쪽 하단 설정(톱니바퀴) -> Settings를 클릭합니다.
3. 검색창에 OpenCode 또는 AI Provider를 입력합니다.
4. Provider 선택 상자를 OpenAI Compatible(또는 Custom)으로 설정합니다.

3단계: 매개변수 입력

1. Base URL 설정

OpenAI Compatible: Base URL에 서드파티 프록시 주소를 입력합니다.

주의: 주소는 /v1로 끝나야 하며 /chat/completions는 포함하지 마세요.

2. API Key 연결

OpenAI Compatible: API Key에 키를 붙여넣습니다.

3. 모델 목록 정의

Custom Models 또는 Model Map을 찾습니다.

• Add Item을 클릭합니다.
• UI에 표시할 이름을 입력합니다(예: DeepSeek).
• API 제공업체의 실제 모델 ID를 입력합니다(예: deepseek-chat).

4단계: 활성화 및 테스트

1. OpenCode Chat 창(보통 사이드바의 로봇 아이콘)을 엽니다.
2. 하단 모델 전환기에서 방금 추가한 Custom Model을 선택합니다.
3. 연결을 확인하기 위해 명령을 보냅니다(예: 퀵소트를 작성해 줘).

고급: 환경 변수(개발자용)

터미널이나 시스템 환경으로 관리하는 경우, OpenCode는 .env 파일 또는 시스템 환경 변수도 읽습니다. 다음을 설정할 수 있습니다.

• OPENAI_API_BASE: 서드파티 URL
• OPENAI_API_KEY: 키

문제 해결

오류 메시지	가능한 원인	해결 방법
Model Not Found	모델 ID 불일치	제공업체 콘솔의 모델 목록을 확인하고 ID가 완전히 일치하는지 확인하세요.
Invalid API Key	키 만료 또는 복사 오류	키를 다시 생성하고 불필요한 줄바꿈이 없는지 확인하세요.
Network Error	인증서 또는 프록시 문제	국내 릴레이를 사용하는 경우 특정 네트워크 프록시를 켜거나 끌 필요가 있는지 확인하세요.
Stream Mode Error	스트리밍 미지원	설정에서 Enable Streaming을 끄고 시도해 보세요(대부분의 최신 API는 지원합니다).

팁: OpenCode는 오픈소스 모델과 잘 맞습니다. 로컬에서 LM Studio 또는 LocalAI를 실행 중이라면 Base URL을 http://localhost:xxxx/v1로 지정하면 완전 오프라인 코드 지원이 가능합니다.