---
read_when:
    - OpenCode Go 카탈로그를 사용하려는 경우
    - Go에서 호스팅되는 모델의 런타임 모델 참조가 필요합니다
summary: 공유 OpenCode 설정으로 OpenCode Go 카탈로그 사용하기
title: OpenCode Go
x-i18n:
    generated_at: "2026-07-12T01:12:29Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: df647721e8966fd4fad3178550b071a2eb827148fe765bda53b3d7c97ceaadc2
    source_path: providers/opencode-go.md
    workflow: 16
---

OpenCode Go는 [OpenCode](/ko/providers/opencode) 내부의 Go 카탈로그입니다. Zen 카탈로그와
`OPENCODE_API_KEY` 자격 증명을 공유하지만, 업스트림 모델별 라우팅이 올바르게
유지되도록 자체 런타임 제공자 ID(`opencode-go`)를 사용합니다.

| 속성             | 값                                                 |
| ---------------- | -------------------------------------------------- |
| 런타임 제공자    | `opencode-go`                                      |
| 인증             | `OPENCODE_API_KEY` (별칭: `OPENCODE_ZEN_API_KEY`) |
| 상위 설정        | [OpenCode](/ko/providers/opencode)                    |

## 시작하기

<Tabs>
  <Tab title="대화형">
    <Steps>
      <Step title="온보딩 실행">
        ```bash
        openclaw onboard --auth-choice opencode-go
        ```
      </Step>
      <Step title="Go 모델을 기본값으로 설정">
        ```bash
        openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.6"
        ```
      </Step>
      <Step title="모델 사용 가능 여부 확인">
        ```bash
        openclaw models list --provider opencode-go
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="비대화형">
    <Steps>
      <Step title="키를 직접 전달">
        ```bash
        openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"
        ```
      </Step>
      <Step title="모델 사용 가능 여부 확인">
        ```bash
        openclaw models list --provider opencode-go
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 구성 예시

```json5
{
  env: { OPENCODE_API_KEY: "YOUR_API_KEY_HERE" }, // pragma: allowlist secret
  agents: { defaults: { model: { primary: "opencode-go/kimi-k2.6" } } },
}
```

## 기본 제공 카탈로그

현재 모델 목록을 확인하려면 `openclaw models list --provider opencode-go`를 실행하세요.
번들에 포함된 항목:

| 모델 참조                       | 이름              | 컨텍스트 | 최대 출력 | 이미지 입력 |
| ------------------------------- | ----------------- | -------- | --------- | ----------- |
| `opencode-go/deepseek-v4-pro`   | DeepSeek V4 Pro   | 1M       | 384K      | 아니요      |
| `opencode-go/deepseek-v4-flash` | DeepSeek V4 Flash | 1M       | 384K      | 아니요      |
| `opencode-go/glm-5`             | GLM-5             | 202,752  | 32,768    | 아니요      |
| `opencode-go/glm-5.1`           | GLM-5.1           | 202,752  | 32,768    | 아니요      |
| `opencode-go/glm-5.2`           | GLM-5.2           | 1M       | 131,072   | 아니요      |
| `opencode-go/hy3-preview`       | HY3 Preview       | 262,144  | 32,768    | 아니요      |
| `opencode-go/kimi-k2.5`         | Kimi K2.5         | 262,144  | 65,536    | 예          |
| `opencode-go/kimi-k2.6`         | Kimi K2.6         | 262,144  | 65,536    | 예          |
| `opencode-go/kimi-k2.7-code`    | Kimi K2.7 Code    | 262,144  | 262,144   | 예          |
| `opencode-go/mimo-v2.5`         | MiMo V2.5         | 1M       | 128,000   | 예          |
| `opencode-go/mimo-v2.5-pro`     | MiMo V2.5 Pro     | 1,048,576 | 128,000  | 아니요      |
| `opencode-go/minimax-m2.5`      | MiniMax M2.5      | 204,800  | 65,536    | 아니요      |
| `opencode-go/minimax-m2.7`      | MiniMax M2.7      | 204,800  | 131,072   | 아니요      |
| `opencode-go/minimax-m3`        | MiniMax M3        | 204,800  | 131,072   | 아니요      |
| `opencode-go/qwen3.5-plus`      | Qwen3.5 Plus      | 262,144  | 65,536    | 예          |
| `opencode-go/qwen3.6-plus`      | Qwen3.6 Plus      | 262,144  | 65,536    | 예          |
| `opencode-go/qwen3.7-max`       | Qwen3.7 Max       | 1M       | 65,536    | 아니요      |
| `opencode-go/qwen3.7-plus`      | Qwen3.7 Plus      | 1M       | 65,536    | 예          |

## 고급 구성

<AccordionGroup>
  <Accordion title="라우팅 동작">
    OpenClaw는 모든 `opencode-go/...` 모델 참조를 자동으로 라우팅합니다. 추가
    제공자 구성은 필요하지 않습니다.
  </Accordion>

  <Accordion title="런타임 참조 규칙">
    런타임 참조는 명시적으로 유지됩니다. Zen에는 `opencode/...`, Go에는
    `opencode-go/...`를 사용합니다. 이를 통해 두 카탈로그 모두에서 업스트림 모델별 라우팅이 올바르게 유지됩니다.
  </Accordion>

  <Accordion title="공유 자격 증명">
    하나의 `OPENCODE_API_KEY`로 Zen 및 Go 카탈로그를 모두 사용할 수 있습니다. 설정 중
    키를 입력하면 두 런타임 제공자의 자격 증명이 모두 저장됩니다.
  </Accordion>
</AccordionGroup>

<Tip>
공유 온보딩 개요와 전체 Zen + Go 카탈로그 참조는 [OpenCode](/ko/providers/opencode)를
참조하세요.
</Tip>

## 관련 항목

<CardGroup cols={2}>
  <Card title="OpenCode(상위)" href="/ko/providers/opencode" icon="server">
    공유 온보딩, 카탈로그 개요 및 고급 참고 사항입니다.
  </Card>
  <Card title="모델 선택" href="/ko/concepts/model-providers" icon="layers">
    제공자 및 모델 참조 선택과 장애 조치 동작을 설명합니다.
  </Card>
</CardGroup>