Thiết lập phụ trợ tùy chỉnh claude-mem

Định tuyến trình xử lý nền claude-mem tới chương trình phụ trợ TokenHub Anthropic-compatible mà không thay đổi phiên Claude Code.

claude-mem là gì?

claude-mem là một hệ thống bộ nhớ liên tục chạy trình xử lý nền cùng với Claude Code và các công cụ mã hóa được hỗ trợ.

Hướng dẫn claude-mem này ghi điểm cuối Anthropic-compatible tùy chỉnh vào tệp môi trường dành riêng cho nhân viên, ghim mô hình chính xác trong cài đặt và khởi động lại nhân viên để cấu hình thực sự được tải. Nhân viên đọc các tệp cài đặt và môi trường của chính nó, do đó việc thay đổi xuất thiết bị đầu cuối hoặc cấu hình Claude Code chính có thể không có hiệu lực. Duy trì thông tin xác thực cổng trong tệp nhân viên được ghi lại, chọn mô hình Anthropic-compatible, khởi động lại nhân viên và nhân viên compare ghi nhật ký với các yêu cầu TokenHub sau chu kỳ xử lý tiếp theo.

Nhà cung cấp claude của claude-mem gửi yêu cầu thông qua Đại lý Claude SDK. Luồng Phần cuối tương thích với con người tùy chỉnh chính thức của nó chỉ thay đổi nhân viên quan sát lý lịch; nó không thay đổi phiên Mã Claude tương tác. Đặt cấu hình này trong thư mục riêng của claude-mem thay vì dựa vào xuất shell.

Bước 1: chỉnh sửa ~/.claude-mem/.env

Đối với cổng TokenHub Anthropic-compatible sử dụng mã thông báo Bearer, hãy thêm:

ANTHROPIC_AUTH_TOKEN=YOUR_TOKENHUB_API_KEY
ANTHROPIC_BASE_URL=__API_BASE_URL__

Hướng dẫn chính thức yêu cầu quyền 0600 đối với tệp này và 0700 trên thư mục của nó; nhân viên cũng thực thi các quyền đó trong lần viết tiếp theo. Đặc vụ Claude SDK đọc trực tiếp ANTHROPIC_BASE_URL và claude-mem không phân tích cú pháp hoặc viết lại nó.

Không dựa vào ANTHROPIC_BASE_URL trong thiết bị đầu cuối hiện tại. claude-mem xây dựng một môi trường công nhân biệt lập, do đó cài đặt phải tồn tại trong ~/.claude-mem/.env để tồn tại khi khởi động lại. Thay vào đó, chỉ sử dụng ANTHROPIC_API_KEY khi một cổng yêu cầu rõ ràng x-api-key thay vì xác thực Bearer.

Bước 2: ghim mô hình công nhân vào settings.json

Chỉnh sửa ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_PROVIDER": "claude",
  "CLAUDE_MEM_MODEL": "YOUR_TOKENHUB_ANTHROPIC_MODEL_ID"
}

CLAUDE_MEM_MODEL được chuyển tới SDK không thay đổi. claude-mem không dịch bí danh và không đọc ANTHROPIC_DEFAULT_HAIKU_MODEL của Claude Code, vì vậy hãy nhập ID mẫu Anthropic-compatible hoàn chỉnh được TokenHub chấp nhận.

Bước 3: khởi động lại bằng các lệnh chính thức và kiểm tra nhật ký

npm run worker:restart
npm run worker:logs

Chờ lần quan sát tiếp theo. Lần chạy thành công đầu tiên sẽ ghi lại SDK Starting SDK query và sau đó là Response received. Lỗi cổng được ghi vào worker-error.log; claude-mem không âm thầm quay trở lại điểm cuối công khai của Anthropic.

Khắc phục sự cố cấu hình nhân viên bị cô lập

  • Mã Claude sử dụng TokenHub nhưng claude-mem thì không: đây là các cài đặt riêng biệt; kiểm tra ~/.claude-mem/.envsettings.json.
  • URL cũ vẫn còn sau khi chỉnh sửa: chạy worker:restart; mở lại một thiết bị đầu cuối là không đủ.
  • Mô hình không tồn tại: CLAUDE_MEM_MODEL không có bản dịch bí danh, vì vậy hãy sao chép lại ID mô hình TokenHub.
  • Lỗi xác thực: sử dụng ANTHROPIC_AUTH_TOKEN để xác thực Người mang TokenHub; chỉ sử dụng ANTHROPIC_API_KEY khi được yêu cầu rõ ràng.
  • Điểm cuối TokenHub chỉ hiển thị OpenAI Chat Completions: nhà cung cấp claude không thể gọi trực tiếp; đặt một bộ chuyển đổi giao thức nhân loại như LiteLLM ở giữa.

Tài liệu tham khảo chính thức

Chọn mô hình

Khối lượng công việcLựa chọn mô hìnhLý do phù hợp
Tác vụ phức tạpMô hình suy luận hỗ trợ công cụPhù hợp với lập kế hoạch, nhiều bước và ngữ cảnh dài.
Sử dụng hằng ngàyMô hình cân bằngCân bằng chất lượng, tốc độ và chi phí.
Tóm tắt và tác vụ nhẹMô hình nhanh, chi phí thấpGiảm chi phí cho tóm tắt và lặp lại đơn giản.
Xem mô hình TokenHub

Phần phụ trợ tùy chỉnh claude-mem FAQ

Điều này có thay đổi phiên Claude Code của tôi không?

Không. claude-mem đọc môi trường riêng của nó, do đó, phần ghi đè được tách biệt khỏi các phiên Claude Code tương tác.

Tại sao nên sử dụng ANTHROPIC_AUTH_TOKEN?

Hướng dẫn phụ trợ tùy chỉnh claude-mem lưu ý rằng thông tin xác thực cổng thường sử dụng ANTHROPIC_AUTH_TOKEN. Sử dụng định dạng thông tin xác thực mà điểm cuối TokenHub của bạn yêu cầu.

Tôi có thể sử dụng điểm cuối mô hình chỉ dành cho OpenAI không?

Không trực tiếp với nhà cung cấp claude. Trước tiên hãy đặt một cổng Anthropic-compatible chẳng hạn như LiteLLM trước một cổng ngược dòng chỉ dành cho OpenAI.

Làm cách nào để xác minh nhân viên claude-mem sử dụng TokenHub?

Khởi động lại nhân viên, đợi chu kỳ xử lý quan sát tiếp theo và compare nhật ký nhân viên với yêu cầu Anthropic Messages trong nhật ký TokenHub.

Tại sao xuất shell không cập nhật claude-mem?

Một nhân viên nền hiện có có thể không kế thừa shell hiện tại. Giữ nguyên các giá trị trong ~/.claude-mem/.env và khởi động lại nhân viên.

Tài liệu tham khảo

Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-08。