Youyun API Youyun API Tài liệu

Hướng dẫn bắt đầu nhanh yycode × Codex

Điều kiện tiên quyết: cài đặt môi trường Node.js

Codex phụ thuộc vào môi trường chạy Node.js, vui lòng tham khảo Hướng dẫn cài đặt môi trường Node.js để hoàn tất cài đặt và xác minh.

Cách tiện hơn: cấu hình tự động

Nếu bạn không muốn cài đặt thủ công và viết từng cấu hình, khuyến nghị dùng trực tiếp công cụ cấu hình tự động.

1. Cài đặt Codex

# Windows
npm install -g @openai/codex@latest

# macOS / Linux
sudo npm install -g @openai/codex@latest

Xác minh cài đặt:

codex --version

Nếu xuất ra số phiên bản, tức là cài đặt thành công.

2. Tạo API Key

Đăng nhập bảng điều khiển yycode, vào trang Quản lý token, nhấp Thêm token.


Điền tên khóa, chọn nhóm Codex (mô hình và hệ số), cấu hình giới hạn IP, giới hạn hạn mức, giới hạn mô hình và thời hạn hiệu lực theo nhu cầu. Người mới nên dùng trực tiếp cấu hình mặc định.

Lưu ý bảo mật: API Key tương đương thông tin xác thực tài khoản, hãy bảo quản cẩn thận, tuyệt đối không commit vào kho mã hoặc chia sẻ công khai.

3. Nhập khóa vào Codex

Tạo thư mục cấu hình

# Windows (PowerShell)
if (Test-Path "$env:USERPROFILE\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" }
mkdir "$env:USERPROFILE\.codex"

# macOS / Linux
rm -rf ~/.codex && mkdir -p ~/.codex

Tạo config.toml

Tạo config.toml trong thư mục ~/.codex/ (trên Windows là %USERPROFILE%\.codex\):

model = "gpt-5.5"
model_provider = "yycode"

[model_providers.yycode]
name = "yycode New API"
base_url = "https://yycode.net/v1"
wire_api = "responses"
requires_openai_auth = true

Tạo auth.json

Nhấp nút Sao chép cạnh khóa để lấy API Key:

Tạo auth.json trong cùng thư mục, thay YOUR_API_KEY bằng khóa bạn đã tạo trong bảng điều khiển:

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "这里填你在平台创建的 API Key"
}

4. Bắt đầu sử dụng

Vào bất kỳ thư mục dự án nào, chạy:

codex

Codex sẽ tự động phân tích mã trong thư mục hiện tại và cung cấp hỗ trợ lập trình thông minh. Cách dùng thêm vui lòng tham khảo tài liệu chính thức OpenAI.

Câu hỏi thường gặp (FAQ)

Q: Chạy npm install -g báo không đủ quyền?
A: macOS / Linux thêm sudo trước lệnh; Windows chạy PowerShell với quyền quản trị viên.

Q: codex --version báo không tìm thấy lệnh?
A: Xác nhận thư mục global của npm đã được thêm vào PATH hệ thống; có thể chạy npm bin -g để xem đường dẫn rồi thêm thủ công.

Q: Kết nối thất bại hoặc trả về lỗi 401?
A: Kiểm tra base_url trong config.toml có phải https://yycode.net không, và API Key trong auth.json có đúng và chưa hết hạn không.

Q: Làm sao chuyển mô hình hoặc hệ số khác?
A: Tạo khóa thuộc nhóm khác trong bảng điều khiển yycode, cập nhật Key trong auth.json, hoặc dùng CC Switch để nhanh chóng chuyển giữa nhiều cấu hình.

Đã sao chép toàn bộ trang