Công cụ & IDE

Cấu hình Continue

Continue là AI coding assistant cho VS Code và JetBrains, hỗ trợ cấu hình model qua config.yaml. Tài liệu này hướng dẫn cấu hình Continue dùng ShopAIKey cho cả OpenAI-compatible và Anthropic-compatible provider.

Endpoint

OpenAI-compatible:

code
https://api.shopaikey.com/v1

Claude trong Continue cũng dùng endpoint:

code
https://api.shopaikey.com/v1

1. Cài đặt Continue

VS Code

  1. Mở VS Code.
  2. Vào Extensions.
  3. Tìm Continue.
  4. Cài extension chính thức.

JetBrains

  1. Mở IDE JetBrains.
  2. Vào Settings → Plugins.
  3. Tìm Continue.
  4. Cài plugin và restart IDE nếu được yêu cầu.

2. Mở thư mục cấu hình

Continue đọc cấu hình global tại:

macOS / Linux

code
~/.continue

Windows

code
%USERPROFILE%\.continue

Tạo hoặc mở file:

code
config.yaml

Nếu config.yaml tồn tại, Continue sẽ ưu tiên dùng file này thay cho config.json.

3. Cấu hình cơ bản

Dán nội dung sau vào config.yaml:

code
name: ShopAIKey
version: 1.0.0
schema: v1

models:
  - name: GPT-5.2
    provider: openai
    model: gpt-5.2
    apiKey: sk-your-api-key
    apiBase: https://api.shopaikey.com/v1
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use
      - image_input

  - name: Claude Sonnet 4.5
    provider: anthropic
    model: claude-sonnet-4-5
    apiKey: sk-your-api-key
    apiBase: https://api.shopaikey.com/v1
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use
      - image_input

Thay sk-your-api-key bằng API key ShopAIKey của bạn.

4. Sample config.yaml tối giản cho Claude

Nếu bạn chỉ muốn dùng Claude qua Continue, có thể bắt đầu bằng cấu hình tối giản sau:

code
name: Local Config
version: 1.0.0
schema: v1

models:
  - name: Claude Opus 4.6
    provider: anthropic
    model: claude-opus-4-6
    apiKey: sk-your-api-key
    apiBase: https://api.shopaikey.com/v1

Với Continue, giữ apiBase: https://api.shopaikey.com/v1 cho cả provider: openai và provider: anthropic.

5. Khuyến nghị dùng biến môi trường

Không nên lưu API key trực tiếp trong file cấu hình nếu bạn chia sẻ máy hoặc đồng bộ dotfiles.

macOS / Linux

code
export SHOPAIKEY_API_KEY="sk-your-api-key"

Windows PowerShell

code
$env:SHOPAIKEY_API_KEY = "sk-your-api-key"

Sau đó dùng cấu hình:

code
name: ShopAIKey
version: 1.0.0
schema: v1

models:
  - name: GPT-5.2
    provider: openai
    model: gpt-5.2
    apiKey: ${{ env.SHOPAIKEY_API_KEY }}
    apiBase: https://api.shopaikey.com/v1
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use
      - image_input

  - name: GPT-5.3 Codex
    provider: openai
    model: gpt-5.3-codex
    apiKey: ${{ env.SHOPAIKEY_API_KEY }}
    apiBase: https://api.shopaikey.com/v1
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use

  - name: Claude Sonnet 4.5
    provider: anthropic
    model: claude-sonnet-4-5
    apiKey: ${{ env.SHOPAIKEY_API_KEY }}
    apiBase: https://api.shopaikey.com/v1
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use
      - image_input

6. Autocomplete

Nếu muốn dùng tab autocomplete, thêm một model nhẹ hơn và gán role autocomplete:

code
  - name: Qwen Coder Autocomplete
    provider: openai
    model: qwen3-coder-plus
    apiKey: ${{ env.SHOPAIKEY_API_KEY }}
    apiBase: https://api.shopaikey.com/v1
    roles:
      - autocomplete
    autocompleteOptions:
      debounceDelay: 350
      maxPromptTokens: 1024
      onlyMyCode: true

7. Khởi động lại Continue

Sau khi sửa config.yaml:

  1. Reload VS Code hoặc IDE.
  2. Mở Continue.
  3. Chọn model ShopAIKey trong danh sách.
  4. Gửi thử một yêu cầu.

Ví dụ:

code
Giải thích file hiện tại và đề xuất refactor nhỏ nhất.

8. Lưu ý

  • Model GPT/Qwen/OpenAI-compatible nên dùng provider: openai với apiBase: https://api.shopaikey.com/v1.
  • Model Claude nên dùng provider: anthropic với apiBase: https://api.shopaikey.com/v1.
  • Model id phải đúng với model ShopAIKey đang hỗ trợ.
  • Nếu Continue không thấy model mới, hãy reload IDE.
  • Không commit config.yaml có API key thật lên Git.

9. Khắc phục sự cố

Continue không nhận config mới

  • Kiểm tra file nằm đúng thư mục ~/.continue/config.yaml.
  • Kiểm tra YAML thụt dòng đúng.
  • Reload IDE.

Lỗi xác thực

  • Kiểm tra API key.
  • Kiểm tra biến môi trường đã được export trong shell/IDE session chưa.
  • Kiểm tra key còn credit.

Model không phản hồi

  • Thử đổi sang gpt-5.2.
  • Kiểm tra apiBase là https://api.shopaikey.com/v1.
  • Kiểm tra model còn được hỗ trợ trong trang Models.