← Quay lại blog

Cách cấu hình proxy cho OpenAI Codex CLI ở các quốc gia không hỗ trợ OpenAI: hướng dẫn đầy đủ

Hướng dẫn từng bước để thiết lập proxy cho OpenAI Codex CLI và API ở các khu vực không hỗ trợ OpenAI - với ví dụ cấu hình và phân tích các lỗi thường gặp.

📅22 tháng 11, 2026

OpenAI chính thức không hỗ trợ hàng chục quốc gia — bao gồm Nga, Belarus, Iran và một số khu vực khác. Khi cố gắng khởi động codex từ những vị trí như vậy, bạn sẽ nhận được hoặc là một sự chặn trực tiếp theo địa lý, hoặc từ chối cấp API key, hoặc kết nối không ổn định với những đứt quãng liên tục khi thực hiện các tác vụ đám mây. Điều này có thể được giải quyết bằng một máy chủ proxy được chọn và cấu hình đúng — nhưng ở đây có những điểm quan trọng: không phải loại proxy nào cũng phù hợp cho các công cụ CLI và các quy trình nền dài hạn.

Tại sao Codex bị chặn ở quốc gia của bạn

OpenAI áp dụng chặn địa lý ở nhiều cấp độ cùng một lúc. Đầu tiên, địa chỉ IP được kiểm tra khi mỗi yêu cầu đến API — nếu nó thuộc về quốc gia trong danh sách không được hỗ trợ, máy chủ sẽ trả về lỗi 403 Country, region, or territory not supported. Thứ hai, khi đăng ký tài khoản và liên kết thẻ thanh toán, hệ thống kiểm tra địa lý IP, địa chỉ thanh toán của thẻ và múi giờ của thiết bị — sự khác biệt làm tăng nguy cơ bị chặn tài khoản. Thứ ba, ngay cả sau khi đăng ký thành công, các phiên CLI có thể bị ngắt quãng nếu IP đột ngột thay đổi địa lý giữa nhiệm vụ — điều này thường xảy ra với IP động của các nhà mạng di động hoặc khi sử dụng VPN miễn phí với bể địa chỉ không ổn định.

Đối với các nhà phát triển sử dụng Codex CLI kết hợp với tự động hóa — viết mã, xem xét pull request, tạo test trong pipeline CI — bất kỳ sự ngắt kết nối nào cũng có nghĩa là nhiệm vụ bị rơi giữa chừng. Do đó, điều quan trọng không chỉ là "vượt qua chặn", mà còn đảm bảo một IP ổn định với địa lý chính xác trong suốt thời gian làm việc.

Loại proxy nào cần cho Codex CLI

Để làm việc với API OpenAI và các công cụ CLI dựa trên nó, ba tham số rất quan trọng: tính ổn định của phiên (IP không nên nhảy giữa các yêu cầu), tốc độ phản hồi và độ sạch của danh tiếng địa chỉ (không nằm trong danh sách đen của các dịch vụ lạm dụng). Hãy xem xét các tùy chọn:

Loại proxy Cho Codex CLI Tính ổn định của phiên Tốc độ
Proxy dân cư Có, lựa chọn chính Cao (phiên sticky) Trung bình-cao
Proxy trung tâm dữ liệu Phù hợp cho CI/CD và phân tích Rất cao (IP cố định) Tối đa
Proxy di động Thừa cho các tác vụ API Trung bình (xoay vòng nhà mạng) Trung bình

Đối với hầu hết các kịch bản — phát triển cục bộ, CLI cá nhân, yêu cầu không thường xuyên đến API — tốt nhất là sử dụng proxy dân cư với gán một IP cho mỗi phiên (phiên sticky). Chúng cung cấp IP thực từ các nhà cung cấp địa phương ở quốc gia đã chọn, điều này giảm thiểu rủi ro bị lọt vào các bộ lọc phát hiện lạm dụng của OpenAI. Nếu Codex được khởi động trong một pipeline đám mây với nhiều tác vụ song song — chẳng hạn, tự động xem xét hàng chục kho mã — thì có lợi hơn khi sử dụng proxy trung tâm dữ liệu: chúng nhanh hơn và ổn định hơn trong việc giữ các kết nối dài hạn mà không bị gián đoạn.

Cấu hình proxy trong Codex CLI qua biến môi trường

Codex CLI, giống như hầu hết các công cụ Node.js và Python hiện đại, tôn trọng các biến môi trường tiêu chuẩn HTTP_PROXY và HTTPS_PROXY. Đây là cách đơn giản nhất để chuyển toàn bộ lưu lượng CLI qua proxy mà không cần chỉnh sửa cấu hình ứng dụng.

# Linux / macOS (bash, zsh)
export HTTP_PROXY="http://login:password@proxy_host:port"
export HTTPS_PROXY="http://login:password@proxy_host:port"
export NO_PROXY="localhost,127.0.0.1"

# Kiểm tra trước khi khởi động Codex
curl -x $HTTPS_PROXY https://api.openai.com/v1/models

# Khởi động CLI
codex "viết unit-test cho hàm validateEmail"
# Windows PowerShell
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"

# Kiểm tra kết nối
Invoke-WebRequest -Uri "https://api.openai.com/v1/models" -Proxy $env:HTTPS_PROXY

codex "refactor module này"

Nếu proxy yêu cầu xác thực bằng tên đăng nhập và mật khẩu (hầu hết các nhà cung cấp hoạt động như vậy), hãy chỉ định chúng ngay trong URL proxy theo định dạng http://user:pass@host:port. Đối với proxy SOCKS5, hãy sử dụng giao thức socks5:// thay vì http:// — điều này rất quan trọng, vì một số công cụ CLI phân biệt các giao thức và có thể bỏ qua các sơ đồ không chính xác.

Proxy qua tệp cấu hình và bọc Python

Nếu bạn viết các script riêng xung quanh OpenAI API (ví dụ, xử lý hàng loạt các tác vụ qua openai-python SDK), các biến môi trường có thể không đủ — đôi khi tiện hơn khi truyền proxy một cách rõ ràng vào client.

import httpx
from openai import OpenAI

proxy_url = "http://login:password@proxy_host:port"

client = OpenAI(
    api_key="sk-...",
    http_client=httpx.Client(proxies=proxy_url, timeout=60.0)
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Tạo một migration cho cơ sở dữ liệu"}]
)

print(response.choices[0].message.content)

Đối với các bọc Node.js (nếu pipeline Codex của bạn được xây dựng trên JS), logic tương tự thông qua https-proxy-agent:

const { HttpsProxyAgent } = require('https-proxy-agent');
const OpenAI = require('openai');

const agent = new HttpsProxyAgent('http://login:password@proxy_host:port');

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  httpAgent: agent,
});

const run = async () => {
  const res = await client.chat.completions.create({
    model: 'gpt-4o',
    messages: [{ role: 'user', content: 'Kiểm tra mã cho các lỗ hổng' }],
  });
  console.log(res.choices[0].message.content);
};

run();

Việc truyền proxy một cách rõ ràng trong mã là hữu ích khi một phần yêu cầu trong ứng dụng của bạn cần đi trực tiếp (các dịch vụ nội bộ), trong khi phần khác — qua proxy (các yêu cầu đến OpenAI). Như vậy, bạn không làm hỏng logic mạng còn lại của ứng dụng bằng các biến môi trường toàn cục.

Proxy cho các tác vụ đám mây: Docker, CI/CD, GitHub Actions

Nếu Codex được sử dụng không cục bộ, mà trong một pipeline tự động — xem xét mã trong mỗi pull request, tạo tài liệu vào ban đêm, tái cấu trúc tự động — proxy cần được thiết lập ở cấp độ môi trường thực thi nhiệm vụ, không chỉ trong terminal của nhà phát triển.

# Dockerfile
FROM node:20-slim

ENV HTTP_PROXY="http://login:password@proxy_host:port"
ENV HTTPS_PROXY="http://login:password@proxy_host:port"
ENV NO_PROXY="localhost,127.0.0.1"

RUN npm install -g @openai/codex
WORKDIR /app
COPY . .
CMD ["codex", "run", "review"]
# .github/workflows/codex-review.yml
name: Codex Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    env:
      HTTPS_PROXY: ${{ secrets.PROXY_URL }}
      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
    steps:
      - uses: actions/checkout@v4
      - name: Cài đặt Codex
        run: npm install -g @openai/codex
      - name: Chạy xem xét Codex
        run: codex review --diff origin/main

Đối với CI/CD, IP tĩnh cố định là ưu tiên hơn — đây chính là kịch bản mà proxy trung tâm dữ liệu thể hiện tốt hơn proxy dân cư: độ trễ thấp hơn, kết nối không bị ngắt quãng trong các công việc dài, và chi phí lưu lượng khi có khối lượng yêu cầu lớn thì thấp hơn đáng kể. Hãy chắc chắn rằng các bí mật của proxy (tên đăng nhập, mật khẩu, máy chủ) được lưu trữ trong Secrets của kho lưu trữ, không phải trong tệp workflow.

Xoay IP và tính ổn định của các phiên dài hạn

Lỗi chính khi làm việc với Codex qua proxy — sử dụng IP với xoay vòng tự động cho mỗi yêu cầu trong một nhiệm vụ nhiều bước. OpenAI API hỗ trợ các phản hồi streaming dài và các gọi liên tiếp trong cùng một ngữ cảnh — nếu giữa những gọi này thay đổi IP xuất phát, dịch vụ có thể coi đây là hoạt động đáng ngờ hoặc đơn giản là ngắt kết nối streaming.

Giải pháp — các phiên sticky: proxy giữ một IP cố định cho kết nối của bạn trong khoảng thời gian chỉ định (thường từ 1 đến 30 phút, tùy thuộc vào cài đặt của nhà cung cấp), sau đó thay đổi nó thành một cái mới. Đối với Codex CLI, tốt nhất là đặt thời gian phiên không dưới thời gian của nhiệm vụ dài nhất của bạn — nếu việc tạo một PR lớn mất 5 phút, phiên cần sống ít nhất 10-15 phút với một khoảng dự phòng.

# Ví dụ về việc tạo phiên sticky qua tham số trong tên đăng nhập proxy
# (cú pháp phụ thuộc vào nhà cung cấp, ví dụ điển hình dưới đây)
export HTTPS_PROXY="http://user-session-abc123:password@proxy_host:port"

Nếu các nhiệm vụ được khởi động song song trong CI (chẳng hạn, xem xét ngay 10 pull request), mỗi công việc song song nên được cấp một session ID riêng — như vậy bạn sẽ tránh được tình huống khi nhiều quy trình cùng lúc "kéo" một IP giống nhau và gặp phải giới hạn tần suất API trước thời hạn.

Các lỗi thường gặp và cách khắc phục

Hãy cùng xem xét những vấn đề điển hình mà các nhà phát triển gặp phải khi thiết lập proxy cho Codex CLI và API OpenAI.

Lỗi Nguyên nhân Giải pháp
403 unsupported_country_region_territory Proxy không được áp dụng, yêu cầu đã đi với IP thực Kiểm tra các biến môi trường qua curl -x
Stream bị ngắt giữa chừng IP đã thay đổi giữa phiên (không có chế độ sticky) Bật phiên sticky, tăng thời gian sống của IP
Timeout / kết nối bị từ chối Cổng hoặc giao thức không chính xác (http thay vì socks5) Kiểm tra giao thức và cổng trong tài liệu của nhà cung cấp proxy
Giới hạn tần suất xảy ra quá nhanh Nhiều quy trình sử dụng một IP cùng lúc Cấp session ID riêng cho mỗi quy trình song song
Tài khoản nhận cảnh báo về hoạt động đáng ngờ IP trung tâm dữ liệu đã bị đưa vào cơ sở dữ liệu lạm dụng Chuyển sang IP dân cư với danh tiếng sạch

Danh sách kiểm tra trước khi khởi động

Trước khi giao nhiệm vụ thực tế cho Codex CLI qua proxy, hãy kiểm tra danh sách ngắn sau:

  • Đã kiểm tra khả năng truy cập api.openai.com qua curl -x với proxy của bạn
  • Địa lý của proxy trùng khớp với quốc gia được chỉ định trong hóa đơn của tài khoản OpenAI
  • Đã bật phiên sticky với thời gian sống lớn hơn thời gian của nhiệm vụ dài nhất
  • Đối với CI/CD, các bí mật của proxy đã được đưa vào Secrets, không được lưu trữ trong mã của workflow
  • Đối với các nhiệm vụ song song, đã sử dụng các session ID khác nhau, không phải một IP chung
  • Đã kiểm tra log của CLI để phát hiện các yêu cầu trực tiếp ẩn (ví dụ, từ các phụ thuộc bên ngoài)

Kết luận

Làm việc với OpenAI Codex CLI từ một quốc gia không có hỗ trợ chính thức yêu cầu không chỉ là một lần vượt qua chặn, mà còn là một cấu hình mạng hệ thống: loại proxy đúng, các phiên sticky cho các yêu cầu dài và tích hợp cẩn thận vào các biến môi trường hoặc mã của client. Đối với phát triển cục bộ và các tác vụ không thường xuyên, các IP dân cư với danh tiếng sạch là lựa chọn tốt hơn, trong khi cho các pipeline CI/CD tải nặng — các proxy trung tâm dữ liệu nhanh chóng và ổn định là lựa chọn hợp lý.

Nếu bạn dự định khởi động Codex và các công cụ khác dựa trên OpenAI API từ một khu vực không có hỗ trợ chính thức, chúng tôi khuyên bạn nên bắt đầu với proxy dân cư để có một hoạt động CLI ổn định, và cho các tác vụ tự động hóa quy mô lớn trên đám mây — với proxy trung tâm dữ liệu, sẽ cung cấp độ trễ thấp và chi phí dự đoán được khi có khối lượng yêu cầu lớn đến API.