AI in IDE logoAI in IDE

사용자 지정 베이스 URL로 OpenCode에서 Claude 사용하기

설정 블록 하나로 OpenCode의 내장 Anthropic 프로바이더를 AI in IDE로 연결해, Anthropic 계정 없이 Claude Opus 5.5, Sonnet 5.5, Haiku 4.5를 실행합니다.

2026-11-06에 OpenCode 1.2.27로 테스트했습니다. 아래 설정으로 opencode run이 claude-sonnet-5-5와 claude-haiku-4-5-20251001의 응답을 받았습니다.

빠른 설정

  1. API 키 만들기. API Keys를 열어 키를 만들고 AWSQ 또는 CCMAX 채널을 선택합니다. Codex나 Gemini 키는 Claude 엔드포인트에서 거부됩니다.
  2. 키 내보내기. ~/.zshrc 또는 ~/.bashrc에 export AIINIDE_API_KEY="YOUR_DASHBOARD_API_KEY"를 추가하고 새 터미널을 엽니다.
  3. 프로바이더 재정의 작성. 모든 프로젝트에 적용하려면 ~/.config/opencode/opencode.json에, 한 프로젝트에만 적용하려면 프로젝트 루트의 opencode.json에 다음을 넣습니다.
1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "provider": {
4
    "anthropic": {
5
      "options": {
6
        "baseURL": "https://api.aiinide.com/v1",
7
        "apiKey": "{env:AIINIDE_API_KEY}"
8
      }
9
    }
10
  },
11
  "model": "anthropic/claude-sonnet-5-5"
12
}
  1. 확인. opencode run "Reply with exactly: OK"를 실행합니다. 헤더에 claude-sonnet-5-5가 표시되고 응답은 OK입니다. 요청은 Usage에 나타납니다.

베이스 URL은 /v1로 끝나야 합니다

OpenCode의 Anthropic 프로바이더는 /messages를 붙이므로 https://api.aiinide.com/v1이 필요합니다. 호스트 이름만 넣으면 /messages를 호출해 Error: Not Found로 실패합니다. Claude Code는 반대입니다. /v1/messages를 붙이므로 호스트 이름만 넣어야 합니다. 한 도구의 값을 다른 도구에 그대로 복사하지 마세요.

지원 모델

OpenCode의 모델 ID채널적합한 용도
anthropic/claude-opus-5-5AWSQ, CCMAX어려운 리팩터링, 긴 에이전트 실행
anthropic/claude-sonnet-5-5AWSQ, CCMAX일상 코딩
anthropic/claude-haiku-4-5-20251001AWSQ, CCMAX빠른 수정, 저렴한 확인

기본 모델을 바꾸려면 설정의 model을 변경합니다. GET /v1/models의 정확한 ID를 사용하세요. 요율과 채널 배수는 모델과 요금에 있습니다.

자주 묻는 질문

OpenCode에서 AI in IDE를 쓰려면 어떤 베이스 URL이 필요한가요?

https://api.aiinide.com/v1입니다. OpenCode가 여기에 /messages를 붙이며, 호스트 이름만 쓰면 Not Found가 반환됩니다.

/connect를 실행해야 하나요?

아닙니다. apiKey 옵션이 AIINIDE_API_KEY에서 키를 읽으므로 auth.json에는 아무것도 저장되지 않습니다. 예전 Anthropic 키가 그곳에 저장되어 있는지 보려면 opencode auth list를 실행하세요.

다른 프로바이더의 OpenCode 동작도 바뀌나요?

아닙니다. anthropic 프로바이더만 경로가 바뀝니다. OpenAI, Google 등 다른 프로바이더는 각자의 엔드포인트와 키를 그대로 씁니다.

키를 프로젝트 저장소 밖에 둘 수 있나요?

됩니다. 키는 환경 변수에 두고 {env:AIINIDE_API_KEY}로 참조하세요. 이 참조만 들어 있는 프로젝트 opencode.json은 커밋해도 안전합니다.

관련 페이지

사용자 지정 베이스 URL로 OpenCode에서 Claude 사용하기 | AI in IDE