전체 가이드 / 코딩 어시스턴트

OpenCode에서 XHuoAPI 사용하기

OpenCode는 터미널 UI, 데스크톱 앱, IDE 확장을 갖춘 오픈소스 코딩 에이전트로, OpenAI Chat Completions 호환 엔드포인트에 연결할 수 있습니다. XHuoAPI가 이 엔드포인트를 제공하므로 설정 파일에 provider 하나만 추가하면 됩니다. OpenCode 2.1.2로 실제로 파일을 만들게 했고, 아래 설정은 테스트에 쓴 그대로입니다.

시작하기 전에

콘솔에서 가입하고 API 토큰을 만듭니다. 가입에는 이메일만 필요하고 전화번호는 필요하지 않습니다.
토큰을 만들 때 티어를 선택합니다. 신규 계정의 기본값은 Standard입니다. 티어는 가격과 안정성, 사용 가능한 모델을 결정합니다. 자세한 내용은 가격 페이지를 참조하세요.

먼저 확인

도구를 설정하기 전에 curl로 키와 모델이 작동하는지 확인하세요. '설정했는데 반응이 없다'는 경우의 절반은 여기서 걸러집니다.

curl https://api.xhuoapi.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v3.2","messages":[{"role":"user","content":"ping"}]}'

설정 단계

OpenCode 2를 설치합니다. OpenCode 1과 2는 모두 opencode 명령을 쓰므로 함께 설치할 수 없고, 1은 설정 형식이 다릅니다(아래 팁 참고).

npm install -g @opencode/cli
opencode --version

API 키를 환경 변수에 넣습니다. 이름은 자유롭게 정하고, 다음 단계 설정의 env에 같은 이름을 씁니다.

export XHUOAPI_API_KEY=YOUR_XHUOAPI_KEY

프로젝트 디렉터리에 opencode.jsonc를 만들고 아래 provider를 넣습니다. package는 OpenAI 호환 패키지, baseURL은 /v1까지, models의 키는 가격 페이지 표기 그대로의 모델 ID입니다.

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "xhuoapi": {
      "name": "XHuoAPI",
      "env": ["XHUOAPI_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://api.xhuoapi.ai/v1" },
      "models": {
        "glm-5.3": { "name": "GLM-5.3" },
        "deepseek-v4.1-flash-none": { "name": "DeepSeek V4.1 Flash" },
        "qwen3.8-max": { "name": "Qwen3.8-Max" }
      }
    }
  }
}

모델은 provider/모델 ID 형식으로 지정합니다. 프로젝트 디렉터리에서 opencode를 실행하면 대화형 화면, opencode run으로 일회성 작업을 실행할 수 있습니다.

opencode run -m xhuoapi/glm-5.3 "Create hello.py that prints hello"
opencode

주의 사항

테스트 결과(2026-10-22, OpenCode 2.1.2, hello.py를 만들게 하는 작업): glm-5.3(20초), deepseek-v4.1-flash-none(8초), qwen3.8-max(8초), deepseek-v4-flash(18초), deepseek-v3.2(22초)는 모두 첫 시도에 통과했고, kimi-k3은 3번 중 2번 통과했습니다. 실패한 회차는 파일을 만들었다고 답했지만 실제로는 쓰기 도구를 호출하지 않았습니다.

OpenCode 1 형식: 최상위 키는 provider(단수)이고 "npm": "@ai-sdk/openai-compatible"을 쓰며 주소는 options.baseURL에 넣습니다. 키는 /connect → Other로 저장하거나 options에 "apiKey": "{env:XHUOAPI_API_KEY}"를 씁니다. 테스트는 OpenCode 2만 했습니다.

스크립트에서 opencode run을 쓸 때 --auto를 붙이면 명시적으로 거부되지 않은 권한 요청을 자동 승인합니다. 붙이지 않으면 파일 쓰기와 명령 실행이 확인을 기다리며 멈춥니다. --auto는 샌드박스가 아니므로 신뢰하는 디렉터리에서만 쓰세요.

OpenCode 2는 기본적으로 로컬 백그라운드 서비스에 연결합니다. 설정을 바꿨는데 반영되지 않거나 서비스에 문제가 있으면 --standalone을 붙여 전용 서버로 실행하세요(테스트도 이렇게 했습니다).

모델 ID는 가격 페이지의 표기와 정확히 일치해야 합니다(DeepSeek V4 Pro가 아니라 deepseek-v4-pro). 대소문자와 하이픈도 구분됩니다.

자주 사용하는 모델

이런 도구에서 자주 선택되는 모델입니다. 모델 이름을 클릭하면 티어별 가격을 볼 수 있습니다. 전체 목록은 가격 페이지에 있습니다.

glm-5.3 deepseek-v4.1-flash-none qwen3.8-max

Claude Code / Codex CLI / fx / OpenCode에서 동작하는 중국 모델(테스트 결과) →

단계는 해당 도구의 현재 공식 문서를 기준으로 정리했습니다. 업데이트 후 UI가 바뀔 수 있습니다. 다른 점이 있으면 알려 주세요.