Coding Agent 설정

OpenHands CLI 설정: API Key, Base URL, 모델

uv로 OpenHands CLI를 설치하고 BetterToken API Key와 Base URL을 설정한 뒤 환경 변수 기반 헤드리스 요청을 확인하세요.

환경 변수를 사용해 OpenHands CLI를 BetterToken에 연결하세요. GPT 모델을 사용한 macOS 테스트에서 OpenHands CLI 1.16.0은 /v1/responses를 통한 헤드리스 텍스트 요청과 파일 읽기 도구 호출을 완료했습니다.

주요 설정

필드	값
API Key	`LLM_API_KEY`에 설정한 BetterToken API Key
Base URL	`LLM_BASE_URL`의 `https://bettertoken.ai/v1`
모델	`LLM_MODEL`의 `openai/YOUR_MODEL_ID`
구성 재정의	`--override-with-envs`

공식 설치 가이드의 패키지 이름과 명령을 사용하세요.

uv tool install openhands --python 3.12
openhands --version

YOUR_API_KEY와 YOUR_MODEL_ID를 바꾸세요. LLM_MODEL의 openai/ 접두사는 유지하세요.

export LLM_MODEL="openai/YOUR_MODEL_ID"
export LLM_API_KEY="YOUR_API_KEY"
export LLM_BASE_URL="https://bettertoken.ai/v1"

OpenHands를 시작할 때 --override-with-envs를 전달하면 이 변수들이 저장된 설정을 덮어씁니다. 재정의는 해당 실행에만 적용되며 구성에 값을 저장하지 않습니다.

openhands --headless --json --override-with-envs -t "Reply with only: OK"

JSONL 출력의 최종 답변이 OK인지 확인하세요. 파일 접근을 따로 확인하려면 프로젝트에서 실행해 OpenHands에 알려진 파일을 읽도록 요청하고 도구 결과와 최종 답변을 모두 확인하세요.

LLM_MODEL을 openai/ 뒤에 다른 정확한 Model ID를 붙인 값으로 바꾸세요. --override-with-envs로 다시 실행하세요.

증상	확인할 내용
환경 설정이 적용되지 않음	명령에 `--override-with-envs`를 포함하세요.
인증 실패	OpenHands를 실행하는 터미널에서 `LLM_API_KEY`를 확인하세요.
엔드포인트가 잘못됨	`LLM_BASE_URL`에 `https://bettertoken.ai/v1`을 사용하고 `/responses` 또는 `/chat/completions`를 덧붙이지 마세요.
모델을 찾을 수 없음	`openai/` 접두사를 유지하고 나머지 `LLM_MODEL` 값을 모델 광장에서 정확히 복사하세요.

OpenHands CLI 1.16.0은 테스트한 텍스트 및 파일 읽기 요청을 /v1/responses로 보냈습니다. Base URL은 /v1로 유지하세요. 요청 경로는 클라이언트가 추가합니다.