이 글에서 가장 먼저 확인할 것은 무엇인가요?

실행 프로그램과 확장

최종 업데이트 2026-10-30

Strata를 코딩 에이전트에 연결하기: OpenAI·Anthropic·Codex API

Strata는 OpenAI·Anthropic 호환 API를 localhost에서 제공해 코딩 도구의 요청을 로컬 모델에 전달해요.

Strata는 OpenAI Chat Completions와 Anthropic Messages, Strata 0.1.39부터 OpenAI Responses API¹를 제공해요. 기본 서버는 127.0.0.1:8080에서 요청을 받아 Qwen3.8-Flash-Next 답을 반환해요. 같은 PC의 코딩 에이전트는 API 종류에 맞는 base URL을 사용하고, Codex CLI²는 /v1/responses를 통해 연결할 수 있어요. 먼저 /health와 /v1/models를 확인한 뒤 짧은 실제 POST 요청을 보내요. 네트워크 공개를 위해 host를 0.0.0.0으로 바꾸지 말고 loopback에서만 점검하세요.

실행 조건과 핵심 내용

기본 주소는 http://127.0.0.1:8080이며 Chat Completions·Anthropic Messages·Responses API를 경로별로 제공해요.
Responses API는 Strata 0.1.39부터 지원하며 Codex CLI는 이 경로를 사용해요.
먼저 localhost 상태·모델 목록을 읽고 실제 짧은 요청을 보내 응답을 확인해요.

Strata의 로컬 API가 받는 요청과 결과

Strata는 로컬 PC에서 Qwen3.8-Flash-Next를 실행하고 API 요청을 답변으로 돌려주는 서버예요. 코딩 에이전트가 보내는 대화 메시지와 도구 정의가 입력이고, 모델이 작성한 텍스트와 지원되는 형식의 도구 호출³이 응답이에요. 파일을 분석하는 에이전트 자체를 설치하는 것은 아니며, 이미 사용하는 클라이언트에서 모델 서버 주소를 지정해 연결합니다.

같은 컴퓨터 안에서 연결할 때는 http://127.0.0.1:8080을 사용해요. Chat Completions는 /v1/chat/completions, Anthropic Messages는 /v1/messages, Responses API는 /v1/responses예요. 기본 주소는 loopback이라 다른 컴퓨터에서 접속할 수 없고, 테스트 중에 서버를 외부 네트워크로 노출하지 않아도 돼요.

같은 프로젝트의 설치 가이드대로 서버를 먼저 준비하고, 코딩 도구가 지원하는 API 형식을 고르세요. Responses API는 Strata 0.1.39부터 제공되므로 구버전에서는 Chat Completions가 필요한 클라이언트를 사용하세요.

검은 타워형 PC와 모니터, 옆에 놓인 RAM 모듈 — Strata는 로컬 서버에서 모델 답변을 코딩 도구에 전달해요.

먼저 localhost에서 상태와 모델 목록을 확인해요

서버 창에서 준비 완료를 확인한 뒤 터미널에서 curl http://127.0.0.1:8080/health를 실행해요. 상태가 응답하면 다음으로 curl http://127.0.0.1:8080/v1/models를 보내 현재 로드된 모델 ID를 확인합니다. API 키를 서버 설정에 추가했다면 두 요청에도 Authorization: Bearer <키> 헤더가 필요해요.

모델 목록이 비어 있거나 연결 오류가 나면 Strata 실행 창이 계속 열려 있는지, 포트가 설정에서 바뀌지 않았는지 확인하세요. 이미 다른 프로그램이 8080을 사용한다면 Strata 실행 설정에 지정한 포트를 기준으로 요청 주소를 맞춰야 해요. 모델이 로드되지 않았다면 먼저 브라우저 채팅에서 짧은 질문을 보내 setup이 완료됐는지 확인합니다.

상태·모델 목록 API

책상 위의 그래픽카드, RAM 모듈과 NVMe SSD — 먼저 localhost의 상태와 모델 목록이 응답하는지 확인해요.

실제 Chat Completions 요청을 한 번 보내요

모델 목록이 응답하면 아래 요청으로 로컬 모델에 짧은 질문을 보내요. model에는 /v1/models에서 확인한 ID를 넣고, 대화 메시지는 messages에 담습니다. 정상 응답 JSON의 choices[0].message.content에 모델의 답이 보여요.

Chat Completions 요청

curl http://127.0.0.1:8080/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{"model":"strata","messages":[{"role":"user","content":"이 서버가 답하면 Strata 연결이 된 거예요."}],"max_tokens":128}'

`model` 값은 `/v1/models` 응답에 나온 ID로 바꿔요.

Chat Completions 요청 예시

클라이언트별로 API 주소와 모델 이름을 맞춰요

OpenAI 호환 클라이언트는 base URL을 http://127.0.0.1:8080/v1로 설정해요. Strata는 임의의 요청 모델명을 처리하지만, 클라이언트가 모델명을 미리 검사하는 경우 목록에 나온 ID를 지정하세요. Claude Code는 Anthropic 형식의 /v1/messages를 사용하므로 ANTHROPIC_BASE_URL=http://127.0.0.1:8080을 설정해요. 클라이언트가 인식하는 ANTHROPIC_MODEL 이름도 필요할 수 있지만, 이는 요청을 그 주소로 보내기 위한 클라이언트 설정이에요.

Codex CLI는 Strata 0.1.39부터 Responses API(/v1/responses)를 사용할 수 있어요. 이 API는 stateless라서 매 요청에 대화 입력 전체를 포함해야 하고, previous_response_id를 이용한 서버 측 대화 저장은 지원하지 않아요. Responses API 지원이 없거나 호환이 맞지 않으면 Chat Completions를 지원하는 다른 클라이언트를 선택하세요.

API 응답은 연결이 됐다는 확인이에요. 코딩 에이전트가 파일을 읽고 수정하거나 명령을 실행하려면 클라이언트가 해당 도구를 제공하고 사용자가 권한을 허용해야 해요. 처음에는 읽기 전용 작업이나 작은 테스트 저장소에서 도구 호출과 결과를 살펴보세요.

개방형 PC 작업대에 장착된 그래픽카드 두 장 — API 경로는 사용하는 클라이언트가 지원하는 형식에 맞춰요.

용어 각주

API — 프로그램의 기능을 다른 코드에서 호출하기 위한 약속된 인터페이스입니다.
본문으로 돌아가기
CLI — Command-Line Interface의 약자입니다. 터미널에 명령어를 입력해 프로그램을 조작하는 방식입니다.
본문으로 돌아가기
도구 호출 — 모델이 파일 읽기·검색·명령 실행 같은 외부 기능의 이름과 인자를 요청하는 형식입니다. 요청을 실제로 실행할지는 에이전트 런타임과 권한 설정이 결정합니다.
본문으로 돌아가기

자주 묻는 질문

이 글에서 가장 먼저 확인할 것은 무엇인가요?: Strata는 OpenAI Chat Completions와 Anthropic Messages, Strata 0.1.39부터 OpenAI Responses API를 제공해요. 기본 서버는 `127.0.0.1:8080`에서 요청을 받아 Qwen3.8-Flash-Next 답을 반환해요. 같은 PC의 코딩 에이전트는 API 종류에 맞는 base URL을 사용하고, Codex CLI는 `/v1/responses`를 통해 연결할 수 있어요. 먼저 `/health`와 `/v1/models`를 확인한 뒤 짧은 실제 POST 요청을 보내요. 네트워크 공개를 위해 host를 `0.0.0.0`으로 바꾸지 말고 loopback에서만 점검하세요.