Cline: OpenAI 호환으로 Claude와 GPT 사용하기

Cline은 VS Code용 오픈소스 coding agent입니다. Code By AI를 OpenAI 호환 공급자로 추가하면 하나의 키로 Claude와 GPT 모델을 실행할 수 있습니다.

Cline은 사이드 패널에서 파일, 터미널, 브라우저를 제어합니다. OpenAI Compatible 공급자는 base URL, API 키, 모델 ID만 요구하므로 같은 Code By AI 엔드포인트로 두 모델 패밀리를 모두 처리할 수 있습니다.

명령 하나로 설정할 수 있나요?

setup.sh는 Cline을 구성하지 않습니다. 공급자 설정은 VS Code 확장, CLI, 백그라운드 hub가 함께 쓰는 파일 하나에 있으며, Cline이 검증하지 못하는 항목이 하나라도 있으면 파일 전체를 빈 것으로 처리해 Cline 자체 로그인을 포함한 모든 공급자가 사라집니다. 아래 단계를 사용하세요.

1. Cline 설치하기

VS Code Marketplace에서 Cline을 설치하고 활동 표시줄에서 패널을 엽니다.

2. 공급자 설정 열기

Cline 패널의 톱니바퀴 아이콘을 클릭하고 API Configuration을 엽니다.

3. Code By AI 설정하기

• API Provider: OpenAI Compatible
• Base URL: https://www.codebyai.net/api/agent/v1
• API Key: API Keys에서 만든 sk-proj-...
• Model: gpt-5.6-terra

Verify를 클릭하거나 짧은 프롬프트를 보냅니다. Cline이 요구하는 것은 완전한 엔드포인트가 아니라 base URL이며, /chat/completions는 Cline이 붙입니다.

4. 모델 설정

Model Configuration을 열고 모델이 공개한 한도를 입력합니다.

• Context Window: 200000
• Max Output Tokens: 65536
• Computer Use: 도구 호출을 지원하는 모델에서는 켜 두어 Cline이 도구를 실행할 수 있게 합니다
• Image Support: 스크린샷이나 이미지를 보낼 때만 켭니다

이 값은 Cline의 모델별 설정입니다. 게이트웨이 한도와 맞추면 요청 실패나 응답 중단을 피할 수 있습니다.

5. Claude로 전환하기

Model을 claude-sonnet-5로 바꿉니다. base URL과 키는 그대로입니다. 게이트웨이가 claude-* ID를 Claude 채널로 전달하고 Claude 요금으로 과금하므로 공급자 하나로 두 패밀리를 모두 처리합니다. ID는 Model Plaza의 값을 사용하세요.

문제 해결

• 404 — Base URL에 /chat/completions가 붙어 있거나 /v1이 중복되었습니다. https://www.codebyai.net/api/agent/v1을 사용하세요.
• 401 / 잘못된 키 — 키 앞뒤에 공백이 있거나 삭제·만료되었습니다. API Keys 페이지에서 새 키를 만드세요.
• 잔액 부족 — Wallet 페이지에서 충전하세요.
• Agent가 도구를 호출하지 않음 — Model Configuration에서 도구 사용이 꺼져 있거나 선택한 ID가 지원하지 않습니다. Computer Use를 켜고 Model Plaza에서 agentic 모델을 고르세요.
• 응답이 중간에 끊김 — Max Output Tokens를 높이세요. 게이트웨이 모델은 요청당 최대 65,536 출력 토큰을 지원합니다.