Đổi provider cho Claude Code, Codex, Gemini CLI: sửa file nào

Đang refactor dở thì API chính thức rate-limit, hoặc model báo "at capacity". Bạn mở ~/.claude/settings.json, dán Base URL của provider khác vào, và nửa tiếng sau mới nhận ra mình vừa ghi đè luôn phần permissions và hooks cũ.

Bài này gom lại đúng file cần sửa cho từng AI coding CLI, bốn kiểu hỏng hay gặp khi sửa tay, và thứ tự thao tác để lần nào cũng quay về được.

Mỗi CLI giữ cấu hình kết nối ở một chỗ khác nhau

Một bài hướng dẫn đăng ngày 19/10/2026 liệt kê vị trí cấu hình của sáu công cụ phổ biến:

Công cụ	File	Thứ phải đổi
Claude Code	~/.claude/settings.json	Base URL, và đúng loại credential (auth token hay API key)
Codex	~/.codex/config.toml	Một custom model provider block; login ChatGPT OAuth nằm ngay cạnh
Gemini CLI	~/.gemini/.env + ~/.gemini/settings.json	Env vars và auth method, phải khớp nhau
Aider	~/.aider.conf.yml	Model name và API endpoint
OpenCode	~/.config/opencode/	Provider mapping + key
Kimi CLI	~/.kimi-code hoặc ~/.kimi	Tùy phiên bản CLI

Điểm đau nằm ở chỗ: "Every tool uses a different format: JSON, TOML, YAML, dotenv." Không có một file chung nào để đổi một lần cho tất cả.

Bốn kiểu hỏng khi sửa tay

• Ghi đè mất thứ không liên quan. Dán đè một file settings.json "đã chạy tốt" lên file của bạn sẽ "wipes permissions, hooks and model preferences".
• Hai field lệch nhau. Gemini CLI cần cả .env lẫn auth type trong settings.json đồng ý với nhau; đổi một bên thì "you get confusing auth errors" — lỗi auth khó lần ra nguyên nhân.
• Codex quên bạn là ai. Tác giả bài viết kể rằng trỏ Codex sang provider thứ ba rồi quay lại thường phải làm lại toàn bộ luồng ChatGPT OAuth trên trình duyệt. Đây là trải nghiệm cá nhân của tác giả, không phải hành vi được Codex ghi trong tài liệu.
• Mất mạch giữa task. Provider trả 502, bạn rời terminal đi sửa file, restart CLI — và quay lại thì không nhớ đang làm dở đến đâu.

Thứ tự thao tác để lần nào cũng quay về được

Phần này là khuyến nghị vận hành, không trích từ nguồn. Bốn bước tối thiểu:

1. Commit hoặc copy file cấu hình vào một thư mục backup trước khi sửa — tên file kèm ngày.
2. Chỉ sửa đúng các field kết nối (Base URL, key, auth type). Không dán đè cả file.
3. Với Gemini CLI, sửa cả hai file trong cùng một lần rồi mới mở lại CLI.
4. Giữ một profile "về nhà" trỏ lại endpoint chính thức, để rollback chỉ mất một thao tác.

Nếu bạn quen dotfiles, một shell alias đổi biến ANTHROPIC_BASE_URL có thể đã đủ cho nhu cầu của bạn — bài gốc cũng nói vậy trước khi giới thiệu công cụ của chính tác giả.

Đổi provider để tiết kiệm: đáng bao nhiêu?

Chênh lệch giá niêm yết giữa các model tier rẻ hiện không lớn. Một phép đo đăng ngày 19/10/2026 liệt kê giá mỗi triệu token: Claude Haiku 5.5 ở $0.10 input / $0.50 output, DeepSeek V4.1 Flash 1017 ở $0.155 / $0.62, MiniMax M3.1 Flash ở $0.165 / $0.66.

Nhưng cũng trong phép đo đó, cùng một bug fix tốn "about $0.70" cho 1.000 lần với Haiku và "about $4.45 at default" với M3.1 Flash — khác biệt đến từ số thinking token mặc định, không phải giá token. Trước khi đổi provider vì giá, hãy đo số reasoning token mỗi call của chính workload bạn đang chạy.

Việc đáng làm tuần này: backup ba file cấu hình ở trên, rồi thử rollback một lần khi không có task gấp.