Strata 서버는 OpenAI와 Anthropic의 표준 API 프로토콜을 지원하므로, 대부분의 최신 코딩 에이전트를 별도의 복잡한 설정 없이 바로 연결할 수 있습니다. 특히 strata connect 명령어를 사용하면 도구별 설정 파일을 자동으로 생성해 줄 뿐만 아니라, 실제 프롬프트와 도구 호출을 보내 연결 상태를 즉시 점검할 수 있어 매우 편리합니다.

지원하는 도구와 식별자

도구	strata connect 식별자
Claude Code	claude-code
Codex CLI	codex
OpenCode	opencode
oh-my-pi	omp
pi.dev	pi
Hermes Agent	hermes
OpenClaw	openclaw
앱 내장 DeepSeek Harness	deepseek-harness

인수 없이 strata connect만 실행하면 목록과 현재 서버 정보를 보여줍니다. 목록의 연결 레지스트리는 저장소의 strata_cli/launch/harness.py에 정의되어 있습니다.

설정 적용부터 연결 확인까지

strata connect opencode           # 주소·키·모델·컨텍스트가 채워진 파일 내용과 환경변수 출력
strata connect opencode --write   # 확인 후 파일에 기록(덮어쓰는 내용은 백업)
strata connect opencode --check   # 그 앱이 보내는 방식으로 프롬프트 1개 + 도구 호출 1개 전송
strata connect opencode --check --output json

--check 옵션은 해당 도구가 실제로 사용하는 요청 형식을 그대로 흉내 내어 보내기 때문에, 단순히 설정값이 맞는지를 넘어 실제로 서버가 응답하는지 확인할 수 있는 가장 확실한 방법입니다. JSON 출력(--output json)을 사용하면 파일 경로와 환경 변수, 그리고 항목별 점검 결과(ok 여부 및 상세 내용)를 정밀하게 확인할 수 있으며, 모든 체크 항목을 통과해야 최종적으로 ok: true 판정을 받습니다.

모니터의 Connect 화면

strata launch 뒤 열리는 모니터의 7번(Connect) 뷰에서도 같은 작업을 할 수 있습니다. 주소와 키(숨김, k로 표시)가 보이고, 앱별로:

• c 설정 복사
• w 백업 후 쓰기
• h 점검 — 그 앱의 방식으로 프롬프트와 도구 호출을 한 번씩 보내기

리스트는 두 열로 구분됩니다. Vendor tested는 그 앱 제작자가 설정을 테스트해 본 앱 버전, This server는 h 점검 후 이 서버에 대한 Not checked / Passed / Failed입니다. 출력된 설정이나 과거 테스트 버전이 현재 환경의 성공을 보증하지는 않으니, 실제 사용 전 h(또는 --check)를 한 번 돌려 두는 편이 안전합니다.

플래그와 JSON 출력

플래그	동작
--url URL, --key KEY, --key-env NAME	서버 주소·키. 기본은 실행 중인 launch, 없으면 http://127.0.0.1:8080
--model NAME, --context SIZE	서버가 보고하는 모델명과 시작 컨텍스트. 기본은 실행 중 launch 값, 그다음 32k
--preset NAME	저장된 프리셋에서 주소·키·모델 가져오기
--yes, --show-key	--write 전 확인 생략, 마스킹되지 않은 실제 키 출력

서버를 여러 개 띄웠거나 프리셋 단위로 관리한다면 --preset/--url로 대상을 명시하세요.

도구별 알려진 제한

각 설정은 Strata 서버 32K 컨텍스트 기준으로 테스트됐고, 알려진 제한은 평문으로 출력됩니다. 문서에 예로 나와 있는 것들:

• Claude Code: CLAUDE_CODE_MAX_CONTEXT_TOKENS가 필요
• OpenCode: limit.input 설정이 필요
• Hermes: 설정한 방식대로 하지 않으면 64K 미만의 컨텍스트 윈도우를 거부
• OpenClaw: Node 24.16 이상 필요

API 키 규칙

• 로컬 기본(127.0.0.1)에서는 키 없이도 서버가 뜨지만, 바깥(LAN, Cloudflare 터널, Tailscale)에서는 키를 강력히 권장합니다. 키 없이 시작하면 "포트에 도달할 수 있는 사람은 모델과 도구를 쓸 수 있다"는 경고가 나가고, --no-api-key는 화면 없이 같은 동작을 합니다(Cloudflare 터널에서는 경고가 더 강해짐).
• strata launch --show-key로 실행 중인 서버의 키를 확인할 수 있고, strata connect의 --show-key는 실제 키를 출력합니다(기본은 마스킹).
• 앱에 넘기는 설정에는 주소와 키가 함께 기록됩니다. CI·스크립트에서 쓰려면 --api-key-env NAME으로 키를 환경변수 참조만 남기는 편이 낫습니다.

연결이 확인됐다면, 직접 요청을 다루는 HTTP API 편과 실전 예제 편에서 같은 서버를 다른 각도로 다룹니다.