Tài liệu

Hướng dẫn cài API key, cấu hình Base URL và xử lý lỗi thường gặp

Claude Code

Hướng dẫn cấu hình và cài đặt Claude Code để tương thích với Techopenclaw.

Cài đặt Claude Code

Nếu máy của bạn chưa cài Claude Code, hãy cài trước bằng lệnh sau:

macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

Nguồn chính thức: code.claude.com/docs/en/quickstart.md

Nếu bạn dùng installer tự động của Techopenclaw, chọn đúng shell theo OS:

macOS / Linux
curl -fsSL "https://api.techopenclaw.com/claude-install.sh?key=YOUR_KEY" | sh

Installer Techopenclaw dùng script .sh cho Unix và .ps1 cho Windows PowerShell.

Sau khi cài xong, mở terminal mới hoặc khởi động lại shell rồi tiếp tục cấu hình Techopenclaw bên dưới.

Cài đặt và Cấu hình tự động

Tùy chọn 1 (Tự động): Chạy script cài đặt với API Key để cấu hình hệ thống

Script sẽ tự động khởi tạo biến ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, thiết lập LLM mặc định, cập nhật ~/.claude/settings.json, và cài đặt extension status line.

Đường dẫn cấu hình theo OS

Claude Code dùng cùng cú pháp đường dẫn ~/.claude/settings.json cho user settings trên macOS, Linux và Windows.

macOS / Linux
~/.claude/settings.json

Cấu hình Global (JSON)

Tùy chọn 2 (Thủ công): Hiệu chỉnh file ~/.claude/settings.json để cấu hình quyền truy cập toàn cục

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_KEY",
    "ANTHROPIC_BASE_URL": "https://api.techopenclaw.com",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.4",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.4",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.4",
    "API_TIMEOUT_MS": "3000000"
  },
  "disableLoginPrompt": true
}

Thay thế giá trị API Key. Khởi chạy claude trên terminal để bắt đầu phiên làm việc mới.

Support (Telegram)