Cấu hình hệ thống Linux/macOS

Tài liệu này hướng dẫn các cách phổ biến để cấu hình biến môi trường API bên thứ ba cho Claude Code trên Linux và macOS. Hãy thay sk-xxxx-uocode bằng API Key bạn đã tạo trong phần quản lý token của UoCode.

Cách 1: Tệp cấu hình Shell (thiết lập vĩnh viễn)

Bash (Linux và macOS phiên bản cũ)

Chỉnh sửa tệp ~/.bashrc:

nano ~/.bashrc

Hoặc dùng trình soạn thảo bạn quen dùng:

vim ~/.bashrc

Thêm các dòng sau vào cuối tệp:

# Cấu hình API bên thứ ba cho Claude Code
export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Sau khi lưu, chạy:

source ~/.bashrc

Kiểm tra cấu hình đã có hiệu lực:

echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

Zsh (mặc định trên macOS Catalina trở lên)

Chỉnh sửa tệp ~/.zshrc:

nano ~/.zshrc

Thêm vào cuối tệp:

# Cấu hình API bên thứ ba cho Claude Code
export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Sau khi lưu, chạy:

source ~/.zshrc

Fish Shell

Chỉnh sửa tệp ~/.config/fish/config.fish:

nano ~/.config/fish/config.fish

Thêm vào cuối tệp:

# Cấu hình API bên thứ ba cho Claude Code
set -gx ANTHROPIC_AUTH_TOKEN "sk-xxxx-uocode"
set -gx ANTHROPIC_BASE_URL "https://www.uocode.com"
set -gx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"

Sau khi lưu, khởi động lại Fish Shell.

Cách 2: Thiết lập tạm thời (phiên terminal hiện tại)

Nếu chỉ muốn dùng trong phiên terminal hiện tại:

export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

# Kiểm tra
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL

# Khởi động Claude Code
claude

Sau khi đóng terminal, các biến này sẽ mất hiệu lực.

Cách 3: Cấu hình theo dự án (.env + script khởi động)

Bước 1: Tạo tệp .env trong thư mục gốc dự án

cd your-awesome-project

cat > .env << 'EOF'
ANTHROPIC_AUTH_TOKEN=sk-xxxx-uocode
ANTHROPIC_BASE_URL=https://www.uocode.com
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF

Bước 2: Tạo run-claude.sh

cat > run-claude.sh << 'EOF'
#!/bin/bash

# Nạp biến môi trường từ .env
if [ -f .env ]; then
  echo "Đang nạp biến môi trường..."
  export $(cat .env | xargs)
  echo "Đã nạp biến môi trường"
else
  echo "Cảnh báo: không tìm thấy tệp .env"
fi

# Kiểm tra biến môi trường
echo "Cấu hình hiện tại:"
echo "ANTHROPIC_AUTH_TOKEN: $ANTHROPIC_AUTH_TOKEN"
echo "ANTHROPIC_BASE_URL: $ANTHROPIC_BASE_URL"

# Khởi động Claude Code
echo "Đang khởi động Claude Code..."
claude
EOF

Bước 3: Thêm quyền thực thi

chmod +x run-claude.sh

Bước 4: Chạy script

./run-claude.sh

Bước 5 (tùy chọn): Tạo lối tắt cấp hệ thống

# Tạo liên kết tượng trưng vào thư mục bin của người dùng
ln -s $(pwd)/run-claude.sh ~/bin/my-claude

# Kiểm tra
which my-claude

# Sau đó có thể dùng ở bất kỳ đâu
my-claude

Chỉnh sửa settings.json (khuyến nghị, trực quan hơn)

Nếu bạn dùng Claude Code trong VS Code, Cursor hoặc trình soạn thảo tương thích khác, bạn có thể cấu hình biến môi trường trong settings.json thay vì chỉnh tệp khởi động Shell.

Mở tệp settings JSON của trình soạn thảo, sau đó thêm hoặc cập nhật cấu hình sau:

{
  "claudeCode.allowDangerouslySkipPermissions": true,
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-xxxx-uocode"
    },
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://www.uocode.com"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC",
      "value": "1"
    }
  ],
  "claudeCode.preferredLocation": "panel",
  "claudeCode.initialPermissionMode": "bypassPermissions",
  "claudeCode.selectedModel": "claude-haiku-4-5-20251001"
}

Sau khi lưu, hãy khởi động lại trình soạn thảo và mở lại Claude Code.

Sử dụng CLI dòng lệnh

Nếu bạn dùng Claude Code trực tiếp trong terminal, hãy đặt biến môi trường trước rồi chạy claude:

export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"
export ANTHROPIC_BASE_URL="https://www.uocode.com"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

claude

Bạn cũng có thể chỉ định model khi khởi động:

ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode" ANTHROPIC_BASE_URL="https://www.uocode.com" CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1" claude -m claude-haiku-4-5-20251001

Kiểm tra CLI đã được cài đặt đúng:

claude --version
claude doctor

Bắt đầu nhanh

Nếu dùng Bash, bạn có thể chạy:

echo 'export ANTHROPIC_AUTH_TOKEN="sk-xxxx-uocode"' >> ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://www.uocode.com"' >> ~/.bashrc
echo 'export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"' >> ~/.bashrc
source ~/.bashrc
claude

Nếu dùng Zsh, hãy thay ~/.bashrc bằng ~/.zshrc.