정책
정책은 OpenCode가 이름이 지정된 리소스에 대해 작업을 수행할 수 있는지를 제어합니다. 이 OpenCode 2 기능은 실험적 기능이며 opencode.json의 experimental.policies 배열로 설정합니다.
정책은 권한과 별개입니다. 권한은 세션 중에 도구가 할 수 있는 일을 제어하고, 정책은 OpenCode가 LLM provider 같은 리소스를 사용할 수 있는지를 제어합니다.
각 정책 구문에는 세 개의 필드가 있습니다.
effect-"allow"또는"deny"입니다.action- 제어할 작업입니다.resource- 구문이 적용될 리소스 ID 또는 와일드카드 패턴입니다.
예를 들어, openai provider 사용을 거부하려면 다음과 같이 설정합니다.
{
"$schema": "https://opencode.ai/config.json",
"experimental": {
"policies": [
{
"effect": "deny",
"action": "provider.use",
"resource": "openai"
}
]
}
}정책으로 거부된 provider는 자격 증명이 있거나 다른 설정이 올바르더라도 model 선택이나 사용에 쓸 수 없습니다.
OpenCode는 현재 하나의 정책 작업을 지원합니다.
| 작업 | 리소스 | 설명 |
|---|---|---|
provider.use | provider ID (예: openai) | LLM provider 사용을 허용하거나 거부합니다. |
향후 더 많은 정책 작업이 추가될 수 있습니다.
resource 필드는 와일드카드 매칭을 지원합니다. *는 0개 이상의 문자와 일치하고 ?는 문자 하나와 일치합니다.
{
"$schema": "https://opencode.ai/config.json",
"experimental": {
"policies": [
{
"effect": "deny",
"action": "provider.use",
"resource": "company-*"
}
]
}
}이 설정은 company-us, company-eu 같은 provider를 거부합니다.
여러 구문이 일치하면 마지막으로 일치한 구문이 적용됩니다. 넓은 범위의 규칙을 먼저 두고, 그 뒤에 더 구체적인 예외를 두세요.
예를 들어, Anthropic만 허용하려면 다음과 같이 설정합니다.
{
"$schema": "https://opencode.ai/config.json",
"experimental": {
"policies": [
{
"effect": "deny",
"action": "provider.use",
"resource": "*"
},
{
"effect": "allow",
"action": "provider.use",
"resource": "anthropic"
}
]
}
}provider와 일치하는 정책이 없으면 해당 provider 사용은 기본적으로 허용됩니다.
정책은 전역 config와 프로젝트 config 모두에 설정할 수 있습니다. 두 위치의 정책이 같은 provider와 일치하면 전역 정책이 프로젝트 정책보다 우선합니다. 이를 통해 전역으로 거부한 provider를 저장소에서 다시 활성화하지 못하게 합니다.
OpenCode 2에서 provider 접근을 제어할 때는 이전의 disabled_providers, enabled_providers 설정 대신 정책을 사용하세요. OpenCode 1에서는 이 provider 목록을 계속 사용하세요.
disabled_providers를 대체하려면 다음과 같이 설정합니다.
{
"experimental": {
"policies": [
{ "effect": "deny", "action": "provider.use", "resource": "openai" },
{ "effect": "deny", "action": "provider.use", "resource": "google" }
]
}
}enabled_providers를 대체하려면 먼저 모든 provider를 거부한 다음 선택한 provider를 허용하세요.
{
"experimental": {
"policies": [
{ "effect": "deny", "action": "provider.use", "resource": "*" },
{ "effect": "allow", "action": "provider.use", "resource": "anthropic" },
{ "effect": "allow", "action": "provider.use", "resource": "openai" }
]
}
}