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. API-ключ вида sk-apv-… из Dashboard → Keys
  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