Installation

Complete guide for installing and configuring Claudible on your system.

Quick Install (Recommended)

The fastest way to get started:

macOS / Linux

curl -fsSL "https://claudible.io/install.sh?key=YOUR_KEY" | sh

View script source

Windows (PowerShell as Admin)

irm "https://claudible.io/install.ps1?key=YOUR_KEY" | iex

View script source

This will:

  • Set ANTHROPIC_BASE_URL environment variable
  • Set ANTHROPIC_AUTH_TOKEN environment variable
  • Configure ~/.claude/settings.json with default models
  • Install statusline script for real-time balance tracking

Manual Configuration

If you prefer manual setup:

Step 1: Set Environment Variables

macOS / Linux

Add to ~/.bashrc or ~/.zshrc:

export ANTHROPIC_BASE_URL="https://claudible.io"
export ANTHROPIC_AUTH_TOKEN="YOUR_KEY"

Windows (PowerShell)

Add to your PowerShell profile ($PROFILE):

$env:ANTHROPIC_BASE_URL = "https://claudible.io"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_KEY"

Or set permanently via System Environment Variables.

Step 2: Configure settings.json

Create or edit ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claudible.io",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_KEY",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  },
  "disableLoginPrompt": true
}

Check /v1/models for the latest available model names.

Step 3: Restart Terminal

Source your shell profile or restart terminal:

source ~/.bashrc

Or for zsh:

source ~/.zshrc

Verify Installation

Check that the configuration is correct:

echo $ANTHROPIC_BASE_URL

Should print: https://claudible.io

Start Claude Code:

claude

Codex CLI

You can also use OpenAI Codex CLI with Claudible. The install script sets up Codex CLI with your Claudible API key, model catalog, and configuration. Requires Node.js 22+.

macOS / Linux

curl -fsSL "https://claudible.io/codex-install.sh?key=YOUR_KEY" | sh

View script source

Windows (PowerShell)

irm "https://claudible.io/codex-install.ps1?key=YOUR_KEY" | iex

View script source

This will:

  • Install @openai/codex globally via npm
  • Write ~/.codex/config.toml pointing to Claudible endpoint
  • Write ~/.codex/models.json with Claude model catalog
  • Create placeholder ~/.codex/auth.json (API key is in config.toml)

See Codex CLI documentation for more details.

Uninstall

curl -fsSL "https://claudible.io/uninstall.sh" | sh

Cài đặt

Hướng dẫn đầy đủ cài đặt và cấu hình Claudible trên hệ thống của bạn.

Cài đặt nhanh (Khuyến nghị)

Cách nhanh nhất để bắt đầu:

macOS / Linux

curl -fsSL "https://claudible.io/install.sh?key=YOUR_KEY" | sh

Xem mã nguồn script

Windows (PowerShell với quyền Admin)

irm "https://claudible.io/install.ps1?key=YOUR_KEY" | iex

Xem mã nguồn script

Script sẽ:

  • Thiết lập biến môi trường ANTHROPIC_BASE_URL
  • Thiết lập biến môi trường ANTHROPIC_AUTH_TOKEN
  • Cấu hình ~/.claude/settings.json với model mặc định
  • Cài đặt statusline script để theo dõi balance realtime

Cấu hình thủ công

Nếu bạn muốn thiết lập thủ công:

Bước 1: Thiết lập biến môi trường

macOS / Linux

Thêm vào ~/.bashrc hoặc ~/.zshrc:

export ANTHROPIC_BASE_URL="https://claudible.io"
export ANTHROPIC_AUTH_TOKEN="YOUR_KEY"

Windows (PowerShell)

Thêm vào PowerShell profile ($PROFILE):

$env:ANTHROPIC_BASE_URL = "https://claudible.io"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_KEY"

Hoặc thiết lập vĩnh viễn qua System Environment Variables.

Bước 2: Cấu hình settings.json

Tạo hoặc sửa ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://claudible.io",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_KEY",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  },
  "disableLoginPrompt": true
}

Kiểm tra /v1/models để biết tên model mới nhất.

Bước 3: Khởi động lại Terminal

Source lại shell profile hoặc khởi động lại terminal:

source ~/.bashrc

Hoặc cho zsh:

source ~/.zshrc

Kiểm tra cài đặt

Kiểm tra cấu hình đúng:

echo $ANTHROPIC_BASE_URL

Kết quả: https://claudible.io

Chạy Claude Code:

claude

Codex CLI

Bạn cũng có thể dùng OpenAI Codex CLI với Claudible. Script cài đặt sẽ thiết lập Codex CLI với API key, danh sách model và cấu hình. Yêu cầu Node.js 22+.

macOS / Linux

curl -fsSL "https://claudible.io/codex-install.sh?key=YOUR_KEY" | sh

Xem mã nguồn script

Windows (PowerShell)

irm "https://claudible.io/codex-install.ps1?key=YOUR_KEY" | iex

Xem mã nguồn script

Script sẽ:

  • Cài đặt @openai/codex toàn cục qua npm
  • Tạo ~/.codex/config.toml trỏ đến endpoint Claudible
  • Tạo ~/.codex/models.json với danh sách model Claude
  • Tạo placeholder ~/.codex/auth.json (API key nằm trong config.toml)

Xem tài liệu Codex CLI để biết thêm chi tiết.

Gỡ cài đặt

curl -fsSL "https://claudible.io/uninstall.sh" | sh
Discord Contact Us