Tiện ích Claude Code cho VS Code với API bên thứ ba: thiết lập environmentVariables

Wokey Team · 2026-09-24

Trả lời ngắn: để trỏ tiện ích Claude Code cho VS Code đến một API bên thứ ba, hãy đặt ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN trong claudeCode.environmentVariables ở thiết lập người dùng của VS Code, và bật claudeCode.disableLoginPrompt. Các biến được export trong terminal hầu như không đến được tiện ích. ~/.claude/settings.json cũng không đủ: bước kiểm tra đăng nhập trước khi khởi chạy của tiện ích không đọc được tệp này, nên bạn cứ gặp màn hình đăng nhập.

Thiết lập

1. Cài tiện ích. Cần VS Code 1.94.0 trở lên. Tìm "Claude Code" (nhà phát hành: Anthropic) trong chế độ xem Extensions (Cmd/Ctrl+Shift+X). Cursor có thể cài cùng tiện ích này, còn các trình soạn thảo như VSCodium có thể lấy từ Open VSX.
2. Mở thiết lập người dùng. Nhấn Cmd/Ctrl+Shift+P và chạy Preferences: Open User Settings (JSON).
3. Thêm thiết lập. Bên trong cặp {} ngoài cùng, thêm:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" }
  ],
  "claudeCode.disableLoginPrompt": true
}

4. Tải lại. Chạy Developer: Reload Window từ command palette, rồi mở bảng Claude Code.

Ba điều cần lưu ý:

• ANTHROPIC_BASE_URL chỉ gồm tên miền, không kèm /v1; tiện ích tự nối thêm /v1/messages.
• Các thiết lập này đặt trong thiết lập người dùng, không phải .vscode/settings.json của workspace, tệp vốn thường được commit vào repository.
• disableLoginPrompt bỏ qua lời nhắc đăng nhập. Mô tả chính thức cho biết nó dành "for third-party provider setups".

Vì sao export và settings.json không đủ

Trước khi khởi chạy tiến trình Claude, tiện ích kiểm tra xem có thông tin xác thực hay không. Bước kiểm tra đó chỉ đọc claudeCode.environmentVariables:

• VS Code mở từ Dock, menu Start hoặc biểu tượng trên desktop không nhận các biến bạn export trong ~/.zshrc.
• Khối env trong ~/.claude/settings.json đến được tiến trình Claude mà tiện ích khởi chạy, nhưng không đến được bước kiểm tra đăng nhập của chính tiện ích.

Vì vậy, khi chỉ có settings.json và disableLoginPrompt đang tắt, triệu chứng điển hình là tiện ích cứ yêu cầu bạn đăng nhập. Nếu muốn dùng biến shell cho một lần, hãy chạy code . từ terminal đã đặt các biến đó. Để dùng hằng ngày, thiết lập người dùng ở trên đáng tin cậy hơn.

Xác nhận yêu cầu đi qua Wokey

Chạy /status trong ô nhập prompt của tiện ích (cần Claude Code v2.1.280 trở lên). Dòng Anthropic base URL trong tab Status phải là https://api.wokey.ai.

Chọn mô hình

Chọn Switch model… từ menu lệnh, hoặc nhấn vào tên mô hình bên dưới ô nhập prompt. Để cố định mô hình cho từng cấp Opus, Sonnet và Haiku, hãy thêm các biến vào cùng danh sách:

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.wokey.ai" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your Wokey API key" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" }
  ]
}

Những gì không có khi dùng API bên thứ ba

Với API bên thứ ba, tiện ích không cung cấp các tính năng cần tài khoản claude.ai:

• Thanh mức sử dụng của gói, nhập liệu bằng giọng nói và tab Web cho các phiên đám mây.
• Không có mục Sign out trong menu.
• Gửi /bug sẽ hiện lỗi và không gửi gì cả.

Tài khoản claude.ai bạn từng đăng nhập bằng /login vẫn được lưu nhưng không được dùng.

So với CLI trong terminal, tiện ích cũng chỉ hỗ trợ một phần các lệnh, và không có phím tắt Bash ! hay tự hoàn thành bằng phím tab.

Khắc phục sự cố

Màn hình đăng nhập cứ xuất hiện. claudeCode.environmentVariables bị thiếu hoặc đặt sai chỗ (chẳng hạn trong thiết lập workspace), hoặc bạn chưa tải lại cửa sổ sau khi thay đổi. Hãy kiểm tra cả disableLoginPrompt đã là true chưa.

invalid x-api-key. Yêu cầu đã đi đến địa chỉ của chính Anthropic vì ANTHROPIC_BASE_URL chưa được áp dụng. Wokey không bao giờ trả về thông báo đó; xem hướng dẫn về invalid x-api-key.

Lỗi 404 có nhắc đến /v1/v1/messages. Base URL bị thừa /v1. Hãy đổi thành https://api.wokey.ai.

Không có phản hồi và cũng không có lỗi. Lời khuyên chính thức là chạy claude trong terminal để xem lỗi chi tiết hơn. Tiện ích có kèm CLI riêng nhưng không thêm claude vào PATH, nên hãy cài CLI riêng và đặt biến cho nó như trong hướng dẫn base URL cho Claude Code.

Người dùng JetBrains

Plugin JetBrains không kèm CLI. Nó chạy lệnh claude đã cài trên máy bạn trong terminal của IDE; bạn có thể đổi đường dẫn tại Settings → Tools → Claude Code [Beta] → Claude command. Vì vậy, bạn cấu hình JetBrains giống như CLI: đặt ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN trong khối env của ~/.claude/settings.json. Xem hướng dẫn base URL cho Claude Code.