Cấu hình 5 phút (và vấn đề khó xử với hậu tố [1m])

Có 4 biến môi trường định tuyến Claude Code đến DeepSeek V4. Chi tiết thứ năm mà không ai ghi lại — hậu tố [1m] model-name — mở khóa cửa sổ ngữ cảnh 1M đầy đủ. Cấu hình hoạt động, đã được xác minh.

Từ số 0 đến hoạt động chỉ trong khoảng 5 phút

🔄 Từ bài học trước: Bạn đã xác nhận Claude Code được cài đặt (which claude). Bạn có API key DeepSeek trong clipboard. Bạn đã mở một codebase thực trong terminal.

Bài học này là cấu hình thực tế. Bốn biến môi trường. Một hậu tố quan trọng mà tài liệu chính thức bỏ qua. Một lần chạy xác minh. Sau đó, bạn đã sẵn sàng làm việc.

Những gì bạn sẽ học được

Đến cuối bài học này, bạn sẽ có Claude Code định tuyến đến DeepSeek V4-Pro với cửa sổ ngữ cảnh 1M đầy đủ được bật, các sub-agent định tuyến đến V4-Flash tự động và một lần chạy xác minh đã hoàn tất với codebase của riêng bạn để chứng minh rằng nó đang hoạt động.

4 biến môi trường (cộng thêm 4 tối ưu hóa)

Đây là cấu hình đầy đủ. Chúng ta sẽ xem xét từng dòng:

# Các thành phần cốt lõi bắt buộc (4 biến)
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-key-here
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]

# Các tối ưu hóa (thêm 4 biến — được khuyến nghị)
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

Cách sử dụng prompt:

1. Nơi dán: Mở file cấu hình shell (mở terminal trước) — ~/.zshrc cho zsh (mặc định trên Mac từ Catalina trở lên), ~/.bashrc cho bash. Hoặc dán trực tiếp các file này vào terminal hiện tại của bạn để kiểm tra trong một phiên trước khi lưu lại.
2. Cách sao chép: Nhấp vào block code, nhấn Cmd+A / Ctrl+A, sau đó Cmd+C / Ctrl+C.
3. Điền thông tin của bạn: Thay thế sk-your-deepseek-key-here bằng API key thực tế từ platform.deepseek.com/api_keys. Không đặt trong dấu ngoặc kép. Không thêm khoảng trắng ở cuối.
4. Những gì bạn sẽ thấy: Chưa có gì hiển thị trong terminal — đây là các biến môi trường được xuất, chúng sẽ im lặng trừ khi có lỗi xảy ra.
5. Cách xử lý kết quả: Khởi động lại shell: source ~/.zshrc hoặc mở một terminal mới. Sau đó xác minh bằng lệnh echo $ANTHROPIC_BASE_URL — lệnh này sẽ in ra URL của DeepSeek.
6. Nếu thấy không ổn: Nếu lệnh echo trả về kết quả trống, nghĩa là shell chưa được load lại. Hãy mở một cửa sổ terminal hoàn toàn mới và thử lại. Nếu API key có lỗi chính tả, bạn sẽ thấy lỗi xác thực khi chạy claude.

Từng dòng một:

ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic — Cho biết SDK Anthropic (mà Claude Code sử dụng nội bộ) gửi yêu cầu đến endpoint tương thích với Anthropic của DeepSeek thay vì api.anthropic.com. DeepSeek đã thiết kế API của mình để chấp nhận định dạng yêu cầu SDK Anthropic chính xác và trả về định dạng phản hồi SDK Anthropic chính xác. Claude Code không biết sự khác biệt.

ANTHROPIC_AUTH_TOKEN=<API key DeepSeek của bạn> — API key DeepSeek của bạn, được sử dụng làm token bearer. Tài khoản mới được tặng 5 USD credit miễn phí; chương trình khuyến mãi ra mắt kéo dài đến ngày 5 tháng 5 với mức giảm giá 75%, vì vậy đây là tuần thích hợp để thử nghiệm.

ANTHROPIC_MODEL=deepseek-v4-pro[1m] — Tên mô hình. Hậu tố [1m] là chi tiết quan trọng. Nếu không có nó, bạn sẽ nhận được 200K ngữ cảnh. Với nó, bạn sẽ nhận được đầy đủ 1 triệu token. Điều này không có trong tài liệu tương thích Anthropic chính thức của DeepSeek tính đến ngày 26 tháng 4 năm 2026 — nó được các nhà điều hành cộng đồng phát hiện trong 48 giờ đầu tiên

ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m] — Khi Claude Code hoặc bất kỳ yêu cầu SDK Anthropic nào yêu cầu mô hình "cấp Opus", hãy chuyển hướng nó đến V4-Pro. Một số quy trình làm việc trong Claude Code chỉ định nội bộ các cấp độ mô hình (Opus cho công việc khó, Sonnet cho công việc trung bình, Haiku cho công việc đơn giản). Dòng này bao gồm các yêu cầu cấp Opus.

Bộ tứ tối ưu hóa

ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m] — Ý tưởng tương tự như mặc định Opus. Chuyển hướng các yêu cầu cấp Sonnet đến V4-Pro. Bạn có thể chuyển hướng chúng đến V4-Flash để tiết kiệm hơn, nhưng Sonnet là cấp độ làm việc chính — hãy giữ nó ở chế độ Pro để có chất lượng tốt nhất.

ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash — Đây là dòng lệnh thực sự giúp bạn tiết kiệm tiền. Claude Code thực hiện rất nhiều lệnh gọi nội bộ ở cấp độ Haiku (đọc file, tóm tắt, điều phối). Việc chuyển hướng chúng đến V4-Flash với giá $0.14/triệu đầu vào rẻ hơn khoảng 89 lần so với giá của Opus. Trong một phiên làm việc dài với agent, đây là nơi bạn tiết kiệm được 60-80%.

CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash — Cụ thể, chỉ định cho trình điều phối sub-agent của Claude Code sử dụng V4-Flash. Nên sử dụng cả hai tùy chọn mặc định của Haiku để đảm bảo an toàn.

CLAUDE_CODE_EFFORT_LEVEL=max — Chỉ định cho DeepSeek bật chế độ tư duy xen kẽ ("Max Thinking") cho mô hình chính. Đây là một tính năng của V4: Ngữ cảnh suy luận được bảo toàn giữa các lần gọi công cụ. Bài học số 6 về chế độ Think-Max sẽ đi sâu hơn vào vấn đề này.

Quá trình xác minh

Khởi động lại shell. Điều hướng đến một dự án thực. Chạy claude.

source ~/.zshrc        # or: source ~/.bashrc
cd ~/code/your-project
claude

Nếu mọi thứ hoạt động:

• REPL của Claude Code mở bình thường
• Tiêu đề mô hình (hiển thị ở đầu REPL) hiển thị deepseek-v4-pro thay vì tên mô hình Anthropic thông thường
• Prompt đầu tiên bạn chạy (thử một cái gì đó như "giải thích kiến ​​trúc của codebase này trong 3 đoạn văn") trả về phản hồi trong vòng ~5–10 giây
• Hóa đơn tại platform.deepseek.com/usage hiển thị việc sử dụng token đến trong vòng ~30 giây kể từ truy vấn đầu tiên của bạn

Kiểm tra nhanh

Chạy vòng lặp agent đơn giản này như một quá trình xác minh thực sự:

Bạn đang xem xét một codebase nhỏ. Vui lòng thực hiện các bước sau theo thứ tự:
1. Đọc file tại đường dẫn tôi sẽ chỉ định
2. Tóm tắt chức năng của file trong 2-3 câu
3. Xác định một cải tiến bạn muốn thực hiện và lý do

Đường dẫn file: ./README.md (hoặc bất kỳ file nhỏ nào trong thư mục gốc dự án của bạn)

Cách sử dụng prompt này:

1. Nơi dán: Mở Claude Code (chạy claude) — dán vào REPL sau khi chạy claude trong dự án của bạn. Dán vào prompt.
2. Cách sao chép: Nhấn Cmd+A / Ctrl+A bên trong block code, sau đó nhấn Cmd+C / Ctrl+C.
3. Điền thông tin của bạn: Thay thế đường dẫn file nếu file README của bạn nằm ở vị trí không chuẩn.
4. Những gì bạn sẽ thấy: Claude Code sẽ thực hiện lệnh đọc (hiển thị trong đầu ra REPL), sau đó là tóm tắt, rồi đến đề xuất cải tiến. Tổng thời gian: 10–20 giây tùy thuộc vào kích thước file.
5. Cần làm gì với kết quả đầu ra: Nếu bạn thấy nội dung file được đọc và trả về bản tóm tắt mạch lạc, thì quá trình tích hợp đang hoạt động. Lưu ý thời gian phản hồi — V4-Pro thường nhanh hơn một chút so với Opus đối với loại đọc nhỏ này.
6. Nếu kết quả không đúng: Nếu bạn nhận được lỗi xác thực, API key bị sai. Nếu bạn nhận được lỗi không tìm thấy mô hình, hãy kiểm tra xem hậu tố [1m] có được bao gồm chính xác hay không. Nếu REPL bị treo ở "đang xử lý", ANTHROPIC_BASE_URL của bạn có thể có dấu gạch chéo ở cuối — phải chính xác là https://api.deepseek.com/anthropic mà không có dấu gạch chéo ở cuối.

Giải pháp thay thế cho cc Switch (dựa trên UI)

Nếu chỉnh sửa các file ẩn không phải là quy trình làm việc của bạn, tiêu chuẩn cộng đồng là cc Switch — một công cụ chuyển đổi nhà cung cấp Claude Code với giao diện người dùng. Từ @bozhou_ai vào ngày 24 tháng 4 (149 lượt thích, 21K lượt xem):

"Bước 1: Tạo API key tại platform.deepseek.com/api_keys. Bước 2: Trong cc Switch, tạo một nhà cung cấp — URL yêu cầu là https://api.deepseek.com/anthropic, API key là khóa bạn vừa tạo. Bước 3: Thay đổi mô hình — chính là deepseek-v4-pro, Haiku là deepseek-v4-flash."

Nhiều nhà phát triển đã lưu ý rằng DeepSeek đã tồn tại dưới dạng cài đặt sẵn trong cc Switch ("预设里有 DeepSeek" — "DeepSeek đã có trong các cài đặt sẵn"). Tải xuống cc Switch từ trang phát hành GitHub của nó, chọn cài đặt sẵn DeepSeek, dán key của bạn. Ba cú nhấp chuột. Kết quả tương tự.

Đường dẫn dotfiles rõ ràng hơn và có thể tái tạo trên nhiều máy (các biến môi trường của bạn được lưu trữ trong kho dotfiles của bạn). Đường dẫn cc Switch nhanh hơn để kiểm tra và dễ dàng chuyển đổi lại. Cả hai đều hợp lệ. Chúng ta sẽ sử dụng đường dẫn dotfiles cho phần còn lại của khóa học vì dù sao thì cc Switch cũng được xây dựng dựa trên nền tảng đó.

Các lỗi thường gặp khi chạy lần đầu

Nếu bạn gặp sự cố không có trong danh sách này, bản sao lưu cài đặt của @koffuxu là một tài liệu tham khảo tốt — file settings.ds.json hoạt động đầy đủ cho Claude Code với tất cả 8 biến đã được thiết lập.

Chuyển lại sang Opus theo yêu cầu

Bạn không mất quyền truy cập Opus của mình. Để chuyển lại sang Anthropic, hãy hủy thiết lập các biến môi trường (hoặc bình luận chúng trong cấu hình shell của bạn và load lại):

unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_MODEL
# (leave the OPUS/SONNET/HAIKU defaults — they're fine to keep)

Bạn cũng có thể giữ cả hai hoạt động đồng thời bằng cách sử dụng shell alias:

alias claude-deepseek='ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic ANTHROPIC_AUTH_TOKEN=$DEEPSEEK_KEY ANTHROPIC_MODEL=deepseek-v4-pro[1m] claude'
alias claude-opus='ANTHROPIC_BASE_URL="" ANTHROPIC_AUTH_TOKEN=$ANTHROPIC_KEY claude'

Bây giờ, cả claude-deepseek và claude-opus đều có sẵn, và bạn chọn một trong hai cho mỗi phiên. Bài học 8 đề cập đến thiết lập kết hợp này như là cấu hình cuối cùng được khuyến nghị.

Những điểm chính cần ghi nhớ

• Cấu hình cốt lõi 4 dòng: ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL
• Bộ tứ tối ưu hóa 4 dòng: SONNET, HAIKU, SUBAGENT_MODEL, EFFORT_LEVEL=max
• Hậu tố [1m] rất quan trọng — nếu không có nó, bạn sẽ bị giới hạn ở 200K ngữ cảnh và mất đi toàn bộ lý do để chuyển đổi
• HAIKU_MODEL=deepseek-v4-flash là nơi thực sự tiết kiệm được 60-80% chi phí phiên
• Xác minh: Chạy một vòng lặp đọc và tóm tắt thực tế trên README của riêng bạn; Kiểm tra platform.deepseek.com/usage để biết thông tin về các token đến.
• cc Switch là lựa chọn thay thế dựa trên giao diện người dùng nếu bạn không muốn chỉnh sửa các file cấu hình.