Coding Agent
읽기 안내
소속 목차: 채널 관리. 검색 키워드: Coding Agent, Codex, Claude Code, Grok Build, OpenCode, WorkBuddy, 豆包, 千问, CLI, Skill.
- 전체 설치 방법, 명령, 사용 시나리오: CLI 사용 설명서.
- 채팅 플랫폼 채널의 연결과 연동 알아보기: 채널 개요 및 연동.
Feishu, Slack 등 채팅 플랫폼에서 Agentic Engine을 사용하는 것 외에도, 자신의 컴퓨터에 있는 Coding Agent와 데스크톱 AI 어시스턴트에서도 Agentic Engine을 사용할 수 있습니다. 예를 들어 Codex, Claude Code, Grok Build, OpenCode, WorkBuddy, 豆包工作, 千问办公 등이 있습니다. 이러한 Agent는 Agentic Engine CLI(ae-cli)로 Agentic Engine 환경에 연결하여, 계정 권한 범위 안에서 데이터 조회, 대시보드 구성, 트래킹 관리, 운영 및 데이터 개발 작업의 후속 관리를 수행합니다.
채팅 채널과의 차이점: Feishu, Slack 등의 채널은 관리자가 시스템 관리에서 채널 인스턴스를 생성한 뒤 사용자가 계정을 연동해야 합니다. Coding Agent는 채널 관리에서 인스턴스를 생성할 필요가 없으며, 사용자마다 자신의 컴퓨터에 CLI를 설치하고 자신의 계정으로 권한을 부여하면 됩니다.
사용 요건
- Agent가 사용자의 컴퓨터에서 터미널 명령을 실행할 수 있어야 합니다. CLI는 Agent가 로컬 터미널에서 호출합니다.
- 로컬에 Node.js 20 이상이 설치되어 있어야 합니다.
- Agentic Engine 주소를 알고 있고, 계정에 대상 프로젝트 접근 권한이 있어야 합니다.
지원 Agent
관련 Skills는 오픈 소스 skills 설치 프로그램으로 설치합니다. 설치 프로그램은 로컬에 설치된 Coding Agent를 자동으로 식별하여 각 Agent의 디렉터리에 Skills를 설치합니다. 아래 표는 자주 쓰는 Agent의 설치 프로그램 내 이름과 전역 Skills 디렉터리입니다:
| Agent | 설치 프로그램 내 이름 | 전역 Skills 디렉터리 |
|---|---|---|
| Codex | codex | ~/.codex/skills/ |
| Claude Code | claude-code | ~/.claude/skills/ |
| Grok Build | grok | ~/.grok/skills/ |
| OpenCode | opencode | ~/.config/opencode/skills/ |
| Cursor | cursor | ~/.cursor/skills/ |
| Trae、Trae CN | trae、trae-cn | ~/.trae/skills/、~/.trae-cn/skills/ |
일부 Agent에만 설치하려면 -a로 지정합니다:
npx -y skills add ThinkingAIAgenticEngine/ae-cli -g -y -a codex -a claude-code
WorkBuddy, 豆包工作, 千问办公 등 데스크톱 Agent는 설치 프로그램의 목록에 없습니다. 터미널 명령을 실행할 수 있다면 아래 단계에 따라 CLI를 설치할 수 있습니다. Skills를 자동으로 로드하지 못한다면 작업을 시작할 때 "ae-cli로 처리해 주세요. 먼저 ae-cli --help를 실행해서 사용할 수 있는 명령을 확인해 주세요"라고 알려 주십시오.
연동 단계
CLI 및 Skills 설치
사용할 Agent에 아래 문장을 보내고, 문장 속 주소를 사용자의 Agentic Engine 주소로 바꿉니다:
https://raw.githubusercontent.com/ThinkingAIAgenticEngine/ae-cli/main/cli-installation-guide.md 문서를 읽고 안내에 따라 Agentic Engine CLI(ae-cli)를 설치하거나 업그레이드해 주세요. 제 Agentic Engine 주소는 https://your-ae-host.example.com 입니다. ae-cli와 관련 Skills만 설치하고 현재 프로젝트는 수정하지 마세요. 로그인 권한 부여가 필요하거나 관리자 권한이 필요하면 멈추고 알려 주세요.
터미널에서 수동으로 설치할 수도 있습니다:
npm install -g @thinkingai/ae-cli
npx -y skills add ThinkingAIAgenticEngine/ae-cli -g -y
로그인 및 권한 부여
Agent가 권한 부여 링크를 보내 줍니다. 수동으로 설치한 경우 다음을 실행합니다:
ae-cli auth login --host https://your-ae-host.example.com
ae-cli auth status --host https://your-ae-host.example.com
브라우저에서 인증 코드를 대조하고 권한 부여를 승인한 뒤, 로그인 상태의 authenticated가 true이면 완료된 것입니다. 자격 증명은 Agentic Engine 주소별로 로컬에 저장됩니다. 같은 컴퓨터에서 다른 Agent로 바꿔 사용할 때는 먼저 로그인 상태를 한 번 확인하고, 로그인되어 있지 않을 때만 다시 권한을 부여합니다.
다시 로드 및 확인
설치가 끝나면 Agent를 닫았다가 다시 열거나 새 작업을 시작하여 Skills를 로드하게 합니다. 그런 다음 아래 문장을 보냅니다:
Agentic Engine CLI를 사용할 수 있는지 확인해 주세요. 현재 버전, 로그인 상태, Agentic Engine 주소를 확인한 다음, 제가 접근할 수 있는 프로젝트 중 처음 5개를 나열하고 프로젝트 이름과 프로젝트 ID만 반환해 주세요. 지금은 보기만 하고 어떤 내용도 수정하지 마세요.
프로젝트 목록이 반환되면 연동이 완료된 것입니다. 이제 CLI 사용 설명서의 시나리오에 따라 질문할 수 있습니다.
사용 팁
- 작업 하나마다 프로젝트, 대상, 기간, 그리고 어디까지 진행해도 되는지를 분명히 말합니다. 예: "읽기만 하고 수정하지 마세요", "먼저 방안을 주시고, 제가 확인한 뒤에 실행해 주세요".
- Agent가 결론에 사용한 이벤트, 산출 기준, 기간, 필터 조건을 함께 적게 하면 결과를 검증하기 쉽습니다.
- 팀원은 각자 자신의 계정으로 권한을 부여하고, Token을 공유하지 않습니다.
- 정기적으로 실행해야 하는 작업은 먼저 수동으로 한 번 끝까지 실행해 본 뒤, Agent 자체의 예약 기능이나 Agentic Engine의 자동화를 사용합니다.
자주 묻는 질문
Agent가 질문을 일반 채팅으로 처리하면 어떻게 하나요?
대개 Skills가 로드되지 않은 경우입니다. Skills가 설치되어 있는지 확인한 뒤 Agent를 재시작합니다. 그래도 안 되면 질문에 "ae-cli로 처리해 주세요"라고 직접 적습니다.
명령이 없거나 버전이 일치하지 않는다는 메시지가 나오면 어떻게 하나요?
ae-cli update --host <주소>를 실행하여 환경 요구에 맞게 CLI와 Skills 버전을 동기화한 다음 Agent를 재시작합니다.
회사 컴퓨터에서 npm 패키지를 전역으로 설치할 수 없으면 어떻게 하나요?
nvm, fnm 또는 Volta로 사용자 디렉터리에 Node.js를 설치하고, sudo npm install -g는 사용하지 마십시오. 그래도 회사 정책으로 제한된다면 IT 관리자에게 문의하십시오.
Coding Agent와 플랫폼의 Agent는 무엇이 다른가요?
플랫폼의 Agent는 Agentic Engine의 워크스페이스, 대화, 채팅 채널에서 사용하며, 설정 방법은 Agent를 참고하십시오. Coding Agent는 사용자의 컴퓨터에서 실행되고 CLI로 Agentic Engine에 접근하며, 로컬 파일, 코드 저장소, 기타 도구(예: lark-cli)와 함께 사용할 수 있습니다.