Trên trangURL gốc

← Tất cả ứng dụng · Mục Kết nối trên /docs

Anthropic + OpenAICấu hình tay

API CLI

Còn gọi: wizard · api-cli doctor · api-cli

API CLI: 설정 도구를 설치하고 앱 연결을 확인합니다.

Hướng dẫn đã xuất bản · Phiên bản ứng dụng: chưa xác minh

Ví dụ chat, ping, invoke hoặc tạo nội dung có thể gửi yêu cầu thật và phát sinh phí. Kiểm tra model, số dư, đơn giá và mức tối thiểu trước khi chạy; GET /v1/models chỉ kiểm tra xác thực và danh mục. Đặt biến môi trường an toàn

URL gốc phải dán

SDK OpenAI thường dùng URL kết thúc bằng /v1; SDK Anthropic dùng URL gốc. Tránh thêm /v1 hai lần. Giao thức tương thích không bảo đảm mọi tính năng của nhà cung cấp.

Xem ghi chú / theo protocol

App này có ngoại lệ — đọc mục Ghi chú bên dưới trước khi dán.

Chuẩn bị

  1. Node.js ≥ 18 (LTS 권장)
  2. Dashboard → Keys에서 발급한 sk-apv-… 형식의 API 키
  3. 홈 디렉터리 쓰기 권한 (~/.apivn 생성 및 앱 설정 수정에 필요)

Model khuyến nghị: claude-fable-5

Cách nhanh — lệnh / cấu hình

# 권장 — Win / macOS / Linux에서 동일
npm install -g API CLI@latest

# 마법사 열기 — 요청 시 API 키 붙여 넣기
api-cli

# 또는 특정 앱 설정
api-cli configure claude -m claude-fable-5
api-cli configure codex -m gpt-5.6-sol
api-cli configure openclaw
api-cli configure cline

Bỏ file / điền Settings ở đâu

Filemacos
~/.apivn/config.json
API CLI가 생성한 파일 (chmod 0600). 저장된 API 키와 base URL을 포함합니다.
이 파일을 Git에 커밋하지 마세요.
Filelinux
~/.apivn/config.json
macOS와 같습니다. 확인: ls -la ~/.apivn/config.json
Filewindows
%USERPROFILE%\.apivn\config.json
PowerShell: notepad $env:USERPROFILE\.apivn\config.json
설정을 정확히 이해한 경우에만 수정 — api-cli auth login / api-cli -k '…' 권장.

Kiểm tra đã chạy đúng

  1. `api-cli doctor`를 실행하세요. 설치된 도구가 APIVN를 가리키는 것으로 표시되어야 합니다.
  2. Dashboard → 사용량을 여세요. 테스트 채팅 명령을 실행하면 차감 내역이 표시되어야 합니다.
  3. `api-cli info`로 현재 사용 중인 base URL을 확인합니다.

Khắc phục sự cố

Triệu chứngNguyên nhânCách xử lý
npm install -g에서 EACCES / 권한 오류 발생전역 npm prefix에 쓸 권한이 없습니다.nvm/fnm을 사용하거나 사용자 단위 npm prefix를 설정하세요. 위험을 이해하지 못했다면 sudo는 피하세요.
doctor가 도구가 설정되지 않았다고 보고함앱이 설치되지 않았거나 이전 설정이 아직 수정되지 않았습니다.`api-cli configure <tool> -k '…'` 또는 `api-cli doctor --fix`.

Ghi chú

  • Base URL Anthropic: https://apivn.dev — OpenAI: https://apivn.dev/v1. API CLI tự chọn theo từng tool.
  • Repo: https://apivn.dev

Liên quan

Claude Code · Codex CLI · OpenClaw · Cline

Support