명령줄 및 에이전트 도구
사용 시나리오, 프로토콜 및 권한 범위에 맞는 AGTCloud 개발 도구를 선택합니다.
AGTCloud는 명령줄 에이전트, IDE 확장, 데스크톱 클라이언트 및 설정 관리 도구에 연동할 수 있습니다. 도구를 선택할 때는 먼저 작업 방식과 프로토콜을 확인한 다음 접근할 수 있는 파일, 명령 및 외부 서비스를 평가합니다.
이 페이지는 튜토리얼을 빠르게 선택하기 위한 것으로, 각 도구의 설치 및 설정 단계를 반복하지 않습니다. 해당 튜토리얼로 이동한 후에는 설명된 Base URL, 인증 및 모델 요구 사항에 따라 연동합니다.
에이전트 도구는 로컬 작업을 실행할 수 있습니다
일부 도구는 파일을 읽고 수정하거나 Shell 명령을 실행하거나 네트워크에 접근할 수 있습니다. 처음 연동할 때는 민감한 데이터가 없는 테스트 디렉터리를 사용하고 자동 승인을 비활성화한 뒤 읽기 전용 작업부터 검증합니다.
도구별 선택
| 도구 | 사용 형태 | AGTCloud 연동 프로토콜 | 적합한 경우 |
|---|---|---|---|
| Claude Code | 터미널 코딩 에이전트 | Anthropic Messages | 기존 Claude Code 워크플로를 사용하면서 Messages와 Content Blocks 구조를 유지하려는 경우 |
| Codex | CLI 및 데스크톱 App | OpenAI Responses | Responses, Typed Items 또는 Codex 프로젝트 워크플로를 사용하는 경우 |
| Gemini CLI | 터미널 에이전트 | Gemini Generate Content | Gemini Contents와 Parts 구조를 이미 사용하는 경우 |
| Cline | IDE 확장 | OpenAI Chat Completions | VS Code 호환 편집기 또는 JetBrains에서 에이전트 작업을 검토하려는 경우 |
| Cherry Studio | 데스크톱 채팅 클라이언트 | OpenAI Chat Completions | 그래픽 인터페이스를 통한 다중 모델 대화와 기본 연결 검증이 필요한 경우 |
| OpenClaw | 자체 호스팅 Gateway, TUI 및 Control UI | OpenAI Chat Completions | 로컬 Gateway와 확장 가능한 개인 에이전트 실행 환경이 필요한 경우 |
| CC-Switch | 로컬 설정 관리 도구 | Anthropic Messages, OpenAI Responses | Claude Code와 Codex의 Provider 설정을 저장하고 전환해야 하는 경우 |
| Hermes Agent | 터미널 에이전트 | OpenAI Chat Completions | Custom Endpoint, 터미널 세션 및 도구 호출 워크플로가 필요한 경우 |
프로토콜 이름이 모델 공급업체를 뜻하지는 않습니다. 같은 모델이 여러 프로토콜 진입점을 제공할 수 있지만, 도구 호출, 멀티모달, 추론 및 컨텍스트 기능은 여전히 현재 모델이 실제로 지원하는 범위를 기준으로 합니다.
작업별 선택
| 목표 | 우선 확인할 도구 | 선택 이유 |
|---|---|---|
| 터미널에서 코드 분석 및 수정 수행 | Claude Code, Codex, Gemini CLI | 세 도구 모두 완전한 터미널 워크플로를 제공하지만 사용하는 프로토콜 구조가 다릅니다 |
| IDE에서 파일 및 명령 작업을 단계별로 검토 | Cline | 작업 계획, 파일 변경 및 승인 과정이 편집기에 모여 있습니다 |
| 그래픽 인터페이스로 일반 모델 대화 진행 | Cherry Studio | 공급업체와 모델을 설정한 뒤 채팅 화면에서 연결을 검증할 수 있습니다 |
| 로컬 자체 호스팅 에이전트 실행 | OpenClaw, Hermes Agent | Gateway 또는 CLI 에이전트 실행 방식을 제공하며 더 엄격한 호스트 권한 제어가 필요합니다 |
| 여러 Claude Code 또는 Codex 설정 관리 | CC-Switch | 로컬에서 Provider를 저장하고 전환하는 데 적합하며 실제 요청을 보내는 클라이언트를 대체하지 않습니다 |
| 외부 도구 및 데이터 소스 연결 | MCP 연동 및 보안 | MCP는 클라이언트와 도구 서비스 사이의 프로토콜이며 모델 API와 같지 않습니다 |
연동 전 확인
1. 사용 형태 확인
터미널, IDE, 데스크톱 채팅 또는 자체 호스팅 Gateway 중 필요한 형태를 결정합니다. 도구 이름만으로 선택하지 말고 팀의 승인 및 권한 관리 방식에 맞는지 먼저 확인합니다.
2. 프로토콜 확인
모델 ID를 모델 목록에서 복사하고 현재 API Key로 사용할 수 있으며 튜토리얼에서 요구하는 Chat Completions, Responses, Anthropic Messages 또는 Gemini Generate Content 진입점을 지원하는지 확인합니다.
3. 독립된 자격 증명 준비
API Key를 API Keys 페이지에서 식별하고 비활성화하기 쉽게 생성합니다. 실제 Key를 저장소, 스크린샷, 로그 또는 공유 설정에 기록하지 않습니다.
4. 권한 설명 확인
도구가 접근할 수 있는 디렉터리, 명령, 네트워크 및 외부 서비스를 확인합니다. 기본적으로 자동 승인을 비활성화하고 현재 작업에 필요한 최소 범위만 허용합니다.
단계별 검증
| 단계 | 권장 작업 | 통과 기준 |
|---|---|---|
| 기본 연결 | 도구를 호출하지 않고 고정된 짧은 텍스트만 응답 | 내용이 반환되며 Provider, Base URL 및 모델이 예상과 일치합니다 |
| 파일 읽기 전용 | 테스트 디렉터리의 README.md를 읽고 요약 | 파일을 쓰거나 승인하지 않은 명령을 실행하지 않습니다 |
| 통제된 도구 사용 | 되돌릴 수 있고 영향 범위가 명확한 작업 하나 실행 | 클라이언트가 작업 내용을 표시하고 승인을 받으며 결과가 예상과 일치합니다 |
| 프로젝트 작업 | 버전 관리로 보호된 실제 프로젝트 처리 | 변경을 검토하고 되돌릴 수 있으며 프로젝트의 기존 검사를 통과합니다 |
클라이언트가 정상적으로 시작되었다고 연동이 완료된 것으로 판단하지 않습니다. 최소한 실제 요청이 예상한 Provider, 모델 및 프로토콜을 사용하는지 확인하고 도구가 승인 범위를 벗어나지 않았는지 검사합니다.
도구 선택 관련 자주 묻는 질문
| 문제 | 권장 조치 |
|---|---|
| 도구로 대화는 가능하지만 도구 호출이 불가능함 | 먼저 대상 모델과 프로토콜의 도구 호출 지원 여부를 확인한 뒤 클라이언트 버전 및 도구 권한을 검사합니다 |
| 같은 모델이 도구마다 다르게 동작함 | 프로토콜, 시스템 프롬프트, 도구 Schema, 컨텍스트 및 클라이언트 기본 매개변수를 비교합니다 |
| 설정이 올바르지만 다른 Provider로 요청함 | 클라이언트를 완전히 다시 시작하고 사용자 수준 설정, 환경 변수 및 현재 활성화된 Provider를 검사합니다 |
Base URL에서 404 반환 | 해당 튜토리얼에 따라 API Origin, /v1 Base URL 또는 클라이언트의 자동 경로 조합 중 어떤 방식을 사용하는지 확인합니다 |
| 자동 승인을 허용해도 되는지 불확실함 | 비활성 상태를 유지하고 작업, 디렉터리 및 명령의 경계가 명확해졌을 때만 개별적으로 허용합니다 |
| 데이터베이스, 파일 시스템 또는 업무 서비스를 연결해야 함 | 먼저 MCP 연동 및 보안을 읽고 서비스 출처 및 권한을 확인합니다 |
보안 권장 사항
- 도구의 공식 채널에서 설치 패키지나 명령을 받아 사용하고 업그레이드 전에 버전 설명을 읽습니다.
- 도구마다 별도로 비활성화하고 감사하기 쉬운 API Key를 사용합니다.
- 파일을 수정하는 작업은 버전 관리 또는 백업으로 보호된 환경에서 실행합니다.
- 암호, 고객 자료, 운영 데이터 또는 불필요한 민감 정보를 모델에 제출하지 않습니다.
- 도구 로그, 세션 내보내기 및 오류 보고서에 Key, 경로 또는 업무 데이터가 포함되어 있는지 검사합니다.
- 도구 사용을 중단한 후에는 저장된 자격 증명을 삭제하고 불필요한 권한을 철회합니다.
도구를 선택했다면 CC-Switch 연동 튜토리얼부터 읽거나 위 표에서 해당 도구를 직접 선택합니다. 인터페이스 필드와 응답 구조는 API Reference를 기준으로 합니다.