> ## Documentation Index > Fetch the complete documentation index at: https://docs.harogo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Claude Code > Hướng dẫn này giúp bạn bắt đầu dùng Claude Code với Harogo chỉ trong vài phút. > [!NOTE] > > **Hướng dẫn này chỉ dùng mô hình Claude.** Claude Code có thể chạy các mô hình Claude (Claude Opus 5.5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Fable 5.1, Claude Haiku 5.5) cùng các mô hình không bị giới hạn ứng dụng (GLM, Qwen, Kimi, MiniMax, DeepSeek). Mô hình GPT không dùng được trong Claude Code — xem [Codex](https://docs.harogo.ai/vi/codex.md). ### 1. Cài đặt Claude Code #### Cài đặt cục bộ ```shellscript macOS theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` ```shellscript Windows theme={null} irm https://claude.ai/install.ps1 | iex ``` #### Cài đặt qua npm Yêu cầu [Node.js 18 trở lên](https://nodejs.org/en/download/) ```shellscript theme={null} npm install -g @anthropic-ai/claude-code ``` ### 2. Cấu hình Harogo API Để kết nối với dịch vụ mô hình của Harogo qua API tương thích Anthropic, hãy đặt các biến môi trường sau. 1. Đặt `ANTHROPIC_BASE_URL` là `https://api.harogo.ai/` 2. Đặt `ANTHROPIC_AUTH_TOKEN` là API key bạn lấy từ [nền tảng Harogo](https://console.harogo.ai/keys) 3. Đặt `ANTHROPIC_MODEL` là một mô hình Claude được Harogo hỗ trợ, ví dụ `claude-sonnet-5`. > [tab] macOS > > 1. Chạy lệnh sau trong terminal để kiểm tra shell mặc định. > > ```shellscript theme={null} > echo $SHELL > ``` > > 2. Đặt biến môi trường tùy theo loại shell của bạn: > > ```shellscript Zsh theme={null} > # Thay bằng key thật lấy từ nền tảng Harogo của bạn > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.zshrc > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc > ``` > > ```shellscript Bash theme={null} > # Thay bằng key thật lấy từ nền tảng Harogo của bạn > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.bash_profile > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile > ``` > > 3. Chạy lệnh sau trong terminal để áp dụng biến môi trường. > > ```shellscript Zsh theme={null} > source ~/.zshrc > ``` > > ```shellscript Bash theme={null} > source ~/.bash_profile > ``` > > 4. Mở một terminal mới và chạy các lệnh sau để xác nhận biến môi trường đã có hiệu lực. > > ```shellscript theme={null} > echo $ANTHROPIC_BASE_URL > test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" > echo $ANTHROPIC_MODEL > ``` > [tab] Windows > > Trên Windows, bạn có thể đặt base URL và [API key](https://console.harogo.ai/keys) của Harogo làm biến môi trường bằng CMD hoặc PowerShell. > > > [tab] CMD > > > > 1. Chạy lệnh sau trong CMD để đặt biến môi trường. > > > > ```shellscript theme={null} > > REM Thay bằng key thật lấy từ nền tảng Harogo của bạn > > setx ANTHROPIC_AUTH_TOKEN "" > > setx ANTHROPIC_BASE_URL "https://api.harogo.ai" > > setx ANTHROPIC_MODEL "claude-sonnet-5" > > ``` > > > > 2. Mở một cửa sổ CMD mới và chạy các lệnh sau để xác nhận biến môi trường đã có hiệu lực. > > > > ```shellscript theme={null} > > if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set > > echo %ANTHROPIC_BASE_URL% > > echo %ANTHROPIC_MODEL% > > ``` > > > [tab] PowerShell > > > > 1. Chạy lệnh sau trong PowerShell để đặt biến môi trường. > > > > ```shellscript theme={null} > > # Thay bằng key thật lấy từ nền tảng Harogo của bạn > > [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User) > > ``` > > > > 2. Mở một cửa sổ PowerShell mới và chạy các lệnh sau để xác nhận biến môi trường đã có hiệu lực. > > > > ```shellscript theme={null} > > if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" } > > echo $env:ANTHROPIC_BASE_URL > > echo $env:ANTHROPIC_MODEL > > ``` > [!NOTE] > > Nếu bạn định quản lý Claude Code qua CC Switch, không nên đặt thêm các giá trị toàn cục `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` hoặc `ANTHROPIC_MODEL`. Biến môi trường ở cấp hệ thống hoặc cấp người dùng có thể ghi đè cấu hình nhà cung cấp do CC Switch ghi ra, khiến giao diện vẫn hiển thị đúng nhà cung cấp đang chọn trong khi Claude Code thực tế vẫn chạy bằng key hoặc mô hình cũ. ### 3. Kiểm tra cấu hình Sau khi thiết lập biến môi trường hoặc CC Switch, hãy gửi trước một yêu cầu tối giản để xác nhận key, mô hình và endpoint tương thích Anthropic đều hoạt động, rồi mới bắt đầu một phiên làm việc dài. ```bash macOS/Linux theme={null} curl https://api.harogo.ai/v1/messages \ -H "content-type: application/json" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \ -d '{ "model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "1+1, output only the answer"}] }' ``` ```powershell Windows theme={null} curl.exe https://api.harogo.ai/v1/messages ` -H "content-type: application/json" ` -H "anthropic-version: 2023-06-01" ` -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" ` -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}" ``` ### 4. Bắt đầu dùng Claude Code Sau khi cấu hình xong, hãy chuyển đến thư mục làm việc và chạy lệnh `claude` trong terminal để bắt đầu. ```bash theme={null} $ cd /path/your-project > claude ``` Nếu khi khởi động bạn thấy `Not logged in · Please run /login`, hoặc bị chuyển vào luồng đăng nhập của Anthropic, thường là do Claude Code chưa nhận được cấu hình Harogo hợp lệ, hoặc chưa hoàn tất bước hướng dẫn ban đầu (onboarding). Trước tiên, hãy xác nhận yêu cầu tối giản ở bước trước trả về `2`, và kiểm tra xem `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` hoặc `ANTHROPIC_MODEL` có đang bị các biến môi trường toàn cục cũ ghi đè hay không. Sau khi đã xác nhận key hoạt động, nếu vẫn bị chuyển đến luồng đăng nhập, bạn có thể bỏ qua bước hướng dẫn ban đầu theo các bước dưới đây: ![Terminal hiển thị lời nhắc đăng nhập hoặc tiếp tục khi khởi động Claude Code lần đầu](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/cc-7.avif?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=80bd9b41f8af28fa7679659117d6266c) 1. Tìm tệp `.claude.json` trong thư mục home của bạn: * macOS / Linux: `~/.claude.json` * Windows: `C:\Users\%USERNAME%\.claude.json` 2. Đặt trường `hasCompletedOnboarding` thành `true` ```json theme={null} { "hasCompletedOnboarding": true } ``` 3. Lưu tệp, rồi chạy lại `claude` trong terminal. #### (Tùy chọn) Các cách cấu hình mô hình khác Claude Code hỗ trợ các cách cấu hình mô hình sau, **xếp theo mức ưu tiên từ cao xuống thấp** — thiết lập có mức ưu tiên cao hơn sẽ ghi đè thiết lập có mức ưu tiên thấp hơn. 1. **Trong cuộc hội thoại:** chạy lệnh `/model ` để chuyển mô hình. Phù hợp khi cần chuyển nhanh một lần. ```text theme={null} /model claude-sonnet-5 ``` 2. **Khi khởi động Claude Code:** chạy `claude --model ` để chỉ định mô hình. Phù hợp cho một phiên làm việc. ```text theme={null} claude --model claude-sonnet-5 ``` 3. **Đặt biến môi trường:** cấu hình các cấp mô hình khác nhau theo độ phức tạp của tác vụ, Claude Code sẽ tự chọn mô hình phù hợp cho từng tác vụ. Áp dụng toàn cục. ```shellscript theme={null} export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5" export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5" ``` Trong đó: * `ANTHROPIC_DEFAULT_OPUS_MODEL`: dùng cho suy luận phức tạp, thiết kế kiến trúc và các tác vụ khó khác. * `ANTHROPIC_DEFAULT_SONNET_MODEL`: dùng cho viết mã, triển khai tính năng và các tác vụ hằng ngày khác. * `ANTHROPIC_DEFAULT_HAIKU_MODEL`: dùng cho kiểm tra cú pháp, tìm kiếm tệp và các tác vụ đơn giản khác. 4. **Đặt cố định trong settings.json:** ghi cấu hình mô hình vào tệp cấu hình người dùng của Claude Code (ví dụ `~/.claude/settings.json`, hoặc `C:\Users\%USERNAME%\.claude\settings.json` trên Windows) hoặc vào tệp cấu hình cấp dự án, để thiết lập cố định ở cấp người dùng hoặc cấp dự án. ## Cấu hình qua CC Switch 1. Mở CC Switch, chọn **Claude Code** ở bên trái, rồi nhấp "Thêm nhà cung cấp" (Add Provider). ![Lối vào Thêm nhà cung cấp trên màn hình chính của CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/1.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=3a0a45652c18bbabd158f7e3a17a8dce) 2. Trong danh sách cài đặt sẵn, chọn nhà cung cấp "Cấu hình tùy chỉnh" (Custom Configuration). ![Chọn Custom Configuration trong danh sách cấu hình sẵn của nhà cung cấp trên CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.51.01.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=2d63af589968a3f94173587919cbf9a2) 3. Điền tên nhà cung cấp, API key, endpoint ([https://api.harogo.ai](https://api.harogo.ai)) và các thông tin khác. Điền xong, nhấp "Thêm" (Add). ![Nhập API key vào biểu mẫu cấu hình nhà cung cấp trên CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.55.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=37caaae4e1ccd895dbe089f656e55751) 4. Quay lại màn hình chính, chọn "harogo" trong danh sách nhà cung cấp và nhấp "Sử dụng" (Use). ![Chọn harogo và nhấn Use trên màn hình chính của CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.00.16.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=78acb5f499057ae22c6e97c4d770f499) > ![Kiểm tra cấu hình mô hình bằng lệnh status và models trong terminal Claude Code](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.03.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=192f4da074881e069682f2c9da8b3cd9) > > ![I Shot 2026 08 07 17 04 52](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.04.52.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=a8f4c213e6115c8c874979a1d7b0c388) > > Mẹo: khi Claude Code đã mở trong terminal, gõ /status để kiểm tra ID mô hình, hoặc /models để chọn một mô hình khác đã cấu hình. > [!WARNING] > > Nếu CC Switch hiển thị "Phát hiện xung đột biến môi trường hệ thống" (System environment variable conflict detected), hãy xử lý `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` và `ANTHROPIC_MODEL` trước. Các biến toàn cục này ghi đè cấu hình nhà cung cấp hiện tại — một giá trị giữ chỗ như `ANTHROPIC_AUTH_TOKEN=` sẽ khiến xác thực thất bại ngay. Khi chắc chắn không còn cần các biến toàn cục đó, hãy xóa các mục xung đột trong CC Switch, hoặc tự xóa biến môi trường cấp hệ thống/người dùng rồi khởi động lại terminal. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.