이 페이지는 영어 문서의 번역입니다. 명령, 식별자, 예제는 그대로입니다. 런타임 7.24.4 · SDK 2.6.7. 영어 원문

ACP (Agent Client Protocol) 정상 경로

상태: 활성
범위: IDE 호스트를 위한 문서화된 정상 경로
최종 검토: 2026-07-12 담당: AX Code 런타임

AX Code는 ACP 서버를 제공하므로, IDE(예를 들어 Zed)가 별도의 전송 계층 없이 에이전트를 호스트할 수 있습니다.

요구 사항

• 지원되는 CLI 설치(PATH의 ax-code)
• 구성된 공급자(ax-code providers login 또는 환경 키)

서버 시작

# Current directory as workspace
ax-code acp

# Explicit workspace
ax-code acp --dir /path/to/project

초기화, 세션, 프롬프트(stdio)

ACP는 stdio 위의 JSON-RPC입니다. 최소 정상 경로는 다음과 같습니다.

# One-shot style example (hosts normally keep the process open)
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1,"clientCapabilities":{}}}' \
  | ax-code acp

일반적인 호스트 순서입니다.

1. initialize — 프로토콜 버전과 에이전트 능력을 협상합니다
2. session/new — cwd를 프로젝트 루트로 두고 세션을 만듭니다
3. session/prompt — 사용자 텍스트를 보냅니다. 에이전트가 도구를 실행하고 중지 이유를 반환합니다
4. session/load — 호스트가 알고 있는 세션 id를 재개합니다

Zed 예시

{
  "agent_servers": {
    "AX Code": {
      "command": "ax-code",
      "args": ["acp"]
    }
  }
}

현재 동작하는 기능

세부 사항과 제한은 packages/ax-code/src/acp/README.md에 있습니다.

선택적 대화형 질문

AX_CODE_ENABLE_QUESTION_TOOL=1 ax-code acp

호스트 UI가 질문 프롬프트에 답할 수 있을 때만 켭니다.