Cline
Cline에서 AGTCloud를 설정하고 사용합니다.
Cline은 IDE에서 실행되는 코딩 에이전트로, 프로젝트 파일을 읽고 명령을 실행하며 허가를 받은 뒤 코드를 수정할 수 있습니다. OpenAI Compatible Provider를 설정하면 Cline에서 AGTCloud의 Chat Completions 호환 진입점을 사용할 수 있습니다.
이 튜토리얼은 Cline IDE 확장을 설명합니다. 모델마다 도구 호출, 이미지 입력, Computer Use 및 컨텍스트 길이의 지원 범위가 다를 수 있으므로 현재 API Key에 표시되며 Chat Completions와 도구 호출을 지원하는 모델을 선택합니다.
준비 사항
시작하기 전에 다음 사항을 확인합니다.
- 지원되는 VS Code 호환 편집기 또는 JetBrains IDE를 설치합니다.
- AGTCloud에 가입하고 로그인합니다.
- API Keys 페이지에서 토큰을 생성합니다.
- 모델 목록에서 현재 토큰으로 사용할 수 있고 Chat Completions를 지원하는 모델 ID를 복사합니다.
- 민감한 코드가 없는 테스트 프로젝트를 준비합니다.
Cline 설치
사용하는 IDE에 맞는 설치 방식을 선택합니다. Cline은 CLI, SDK 및 Kanban 등의 형태도 제공하지만 이 튜토리얼에서는 다루지 않습니다.
VS Code, Cursor, Windsurf, VSCodium 등의 편집기에 적용됩니다.
- 확장 마켓플레이스를 열거나
Ctrl/Cmd + Shift + X를 누릅니다. Cline을 검색합니다.- Cline 공식 확장을 선택하고 설치를 클릭합니다.
- 활동 표시줄의 Cline 아이콘을 클릭하거나 명령 팔레트에서
Cline: Open In New Tab을 실행합니다.
Windsurf와 VSCodium은 Open VSX를 사용하며 설치 과정은 대체로 같습니다.
첫 실행에서 Cline 승인 또는 초기화 안내가 표시되면 현재 버전의 화면에 따라 완료합니다. 다른 설치 방식은 Cline 공식 설치 문서를 확인합니다.
AGTCloud 설정
API Configuration 열기
Cline 패널에서 설정 아이콘을 클릭하고 API Configuration으로 이동합니다. 설정 진입점의 위치는 IDE와 Cline 버전에 따라 조금 다를 수 있습니다.
호환 Provider 선택
API Provider에서 OpenAI Compatible을 선택합니다. 내장 OpenAI Provider를 선택하지 않습니다.
연결 정보 입력
| Cline 필드 | 입력 내용 |
|---|---|
API Provider | OpenAI Compatible |
Base URL | https://api.agtcloud.cn/v1 |
OpenAI Compatible API Key | your-api-key |
Model ID 또는 Model | MODEL_ID |
Custom Headers | 기본적으로 비워 둡니다 |
your-api-key와 MODEL_ID를 자신의 토큰 및 모델 ID로 교체합니다.
검증 및 저장
현재 버전에 Verify 버튼이 있으면 연결을 먼저 검증합니다. 검증을 통과한 뒤 Done 또는 현재 화면의 저장 버튼을 클릭하여 설정을 완료합니다.
Base URL에는 /v1이 포함되어야 합니다
Cline의 OpenAI Compatible Provider에는 전체 API Base URL을 입력해야 합니다. https://api.agtcloud.cn/v1를 사용하고 API Origin만 입력하거나 /v1을 더 추가하여 /v1/v1로 만들지 않습니다.
모델 선택 및 설정
MODEL_ID는 교체해야 하는 자리표시자이며 실제 모델 이름이 아닙니다. 모델 목록에서 현재 API Key에 표시되며 Chat Completions와 도구 호출을 지원하는 모델 ID를 복사합니다.
Cline의 Model Configuration에는 Context Window, Max Output Tokens, Image Support, Computer Use, Input Price 및 Output Price 등의 고급 옵션이 있을 수 있습니다. 첫 연결에서는 기본값을 유지하고 대상 모델의 실제 제한과 기능을 파악한 뒤에만 조정하는 것이 좋습니다.
고급 설정이 모델 기능을 제공하지는 않습니다
Cline에서 이미지 또는 Computer Use 지원을 선택해도 해당 기능이 없는 모델에 새 기능이 생기지 않습니다. 가격 필드는 주로 Cline의 로컬 사용량 추정에 쓰이며 AGTCloud의 최종 청구 결과를 나타내지 않습니다.
실행 및 연결 검증
테스트 프로젝트 열기
민감한 코드가 없는 프로젝트를 사용하고 안전하게 읽을 수 있는 README.md가 있는지 확인합니다.
자동 승인 비활성 상태 유지
첫 검증에서 Auto Approve를 활성화하지 않습니다. Cline이 파일 읽기, 명령 실행 또는 코드 수정을 준비할 때 작업 내용을 먼저 확인한 뒤 허용 여부를 결정합니다.
결과 확인
Cline이 파일을 읽고 정상적으로 요약을 반환하며 승인하지 않은 수정이 없으면 기본 연결이 설정된 것입니다. 이 단계에서는 정상적인 API 사용량이 발생합니다.
자주 묻는 질문
| 증상 | 우선 확인할 항목 | 조치 |
|---|---|---|
| Cline 확장이 표시되지 않음 | 설치 출처, IDE 호환성 및 재시작 상태 | Cline 공식 확장을 설치했는지 확인하고 IDE를 다시 불러오거나 다시 시작합니다 |
Verify 연결 실패 | 네트워크 및 Base URL | 로컬에서 AGTCloud에 접근할 수 있는지 확인하고 전체 https://api.agtcloud.cn/v1를 사용합니다 |
401 반환 | API Key 내용 및 토큰 상태 | 유효한 API Key를 다시 복사하고 불필요한 공백이 없는지 확인합니다 |
403 반환 | 토큰 권한, 모델 권한 및 계정 상태 | 콘솔에서 토큰 상태와 현재 계정의 모델 사용 가능 범위를 확인합니다 |
404 반환 | Base URL, 중복 /v1 및 모델 ID | /v1/v1이 되지 않았는지 확인하고 전체 모델 ID를 다시 복사합니다 |
| Model Not Found 표시 | 현재 Key에 표시되는 모델 및 프로토콜 지원 | 현재 API Key에 표시되며 Chat Completions를 지원하는 모델을 선택합니다 |
| 대화는 정상이지만 도구 실패 | 도구 호출 기능 및 고급 설정 | 도구 호출 지원 모델로 바꾸고 컨텍스트와 출력 상한 설정을 확인합니다 |
| 이미지 또는 Computer Use 실패 | 모델의 실제 기능 | Cline 옵션에만 의존하지 않고 대상 모델의 실제 지원 범위를 기준으로 합니다 |
| 비정상 결과 또는 연결 중단 | 네트워크 프록시, 모델 매개변수 및 컨텍스트 제한 | 고급 설정을 기본값으로 복원한 뒤 프록시, 방화벽 및 모델 컨텍스트 제한을 확인합니다 |
원인을 찾기 어려우면 요청 시각, 모델 ID, HTTP 상태 및 민감 정보를 제거한 오류 내용을 기록하고 오류 및 문제 해결을 확인합니다. 전체 API Key를 제출하지 않습니다.
보안 권장 사항
- API Key를 프로젝트 파일, Git 저장소, 스크린샷, 로그 또는 공유 설정에 기록하지 않습니다.
- 운영 자격 증명, 비공개 데이터 또는 미공개 소스 코드가 있는 프로젝트에서 첫 검증을 수행하지 않습니다.
- 처음 사용할 때는 Auto Approve를 비활성 상태로 유지하고 각 작업을 확인한 뒤 실행을 허용합니다.
- 여러 사람이 사용하는 장치에서는 사용 후 Cline에 저장한 API Key를 제거합니다.