Cách kết nối X với Claude Code

Hermoso là một máy chủ MCP tiếp thị: hơn 1.000 công cụ trên một endpoint OAuth duy nhất, cho phép một agent nghiên cứu các quảng cáo đang chạy trong một thị trường, tạo quảng cáo hình ảnh và video, đăng chúng, và xây dựng các chiến dịch trả phí phía sau chúng. Claude Code truy cập toàn bộ những thứ này qua một kết nối duy nhất. Trang này chỉ đề cập một phần: Claude Code thực sự làm được gì trên X, và X không cho phép Claude Code làm gì.

Kết nối Hermoso với Claude Code

1. Một lệnh, và không cần khóa.

   claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

   Đã ở trong một phiên? Gõ /plugin marketplace add hermoso-ai/hermoso, rồi /plugin install hermoso@hermoso. Nó cài năm kỹ năng Hermoso (research, ad-from-brand, generate, product-photoshoot và marketing) chạy lệnh hermoso qua npx, nên không có danh sách công cụ nào được nạp vào phiên của bạn và không có gì tốn ngữ cảnh cho đến khi nó chạy.
2. Đăng nhập một lần.

   npx -y hermoso auth login

   Lệnh này mở trình duyệt để đăng nhập qua loopback, giống cách gh làm, và lưu thông tin xác thực chỉ chủ sở hữu mới truy cập được vào ~/.hermoso/config.json. Claude Code sẽ chạy lệnh này giúp bạn ở lần đầu tiên cần đến Hermoso. Máy đó không có trình duyệt, chẳng hạn CI, máy từ xa hay container? Hãy tạo khóa trong MCP & CLI → Terminal & API keys rồi chạy npx -y hermoso auth login --token hmk_…. Khóa mang quyền chi tiêu thực sự, nên hãy coi nó như mật khẩu.
3. Tùy chọn: thêm máy chủ MCP. Nếu bạn cũng muốn các công cụ Hermoso nằm trong danh sách công cụ của Claude Code, hãy chạy claude mcp add hermoso -- npx -y hermoso mcp sau khi đăng nhập. Nó đọc cùng thông tin xác thực đã lưu, nên không có khóa nào được đưa vào .claude.json. Các kỹ năng tiếp cận mọi công cụ mà không cần nó.
4. Yêu cầu Claude Code làm gì đó. “Lấy những quảng cáo chạy lâu nhất của ba đối thủ gần nhất của tôi và phối lại hook tốt nhất thành video 9:16” hoặc “đăng bản render này lên kênh.” Agent tự chọn công cụ; bạn duyệt khoản chi tiêu.

Plugin và máy chủ MCP tùy chọn truy cập cùng các công cụ và cùng tài khoản. Khác biệt nằm ở ngữ cảnh: một danh sách công cụ được nạp vào mọi phiên trước khi bạn gõ bất cứ thứ gì, còn các kỹ năng không tốn gì cho đến khi một lệnh chạy.

Sau đó kết nối chính X, một lần, trong Settings → Connectors của Hermoso. Đây là màn hình đồng ý OAuth, nên là bước duy nhất cần trình duyệt. Mọi thứ sau đó là lệnh gọi công cụ.

Các công cụ X mà Claude Code có

• post_to_x: đăng văn bản, một hình ảnh hoặc video kèm alt text, cả một thread, một trả lời, một bài trích dẫn hoặc một khảo sát, và có thể giới hạn ai được phép trả lời.
• post_x_article: đăng một Article dài. Viết bằng Markdown và các tiêu đề, danh sách, trích dẫn, liên kết, khối mã và bảng sẽ được giữ nguyên.
• edit_x_post: viết lại một bài bạn đã đăng, trong khoảng một giờ mà X cho phép.
• schedule_post: xếp bài vào lịch chung.
• x_post_metrics: các số liệu công khai trên một bài.
• x_post_insights: số liệu ngang tầm nhà quảng cáo, chỉ cho 28 giờ gần nhất: lượt hiển thị, lượt nhấp liên kết, lượt xem hồ sơ, lượt xem video và các phân vị hoàn thành.
• x_post_insights_historical: cùng các số liệu đó cho bất kỳ khoảng ngày nào, tối đa 25 bài mỗi lần. Đây là công cụ cho câu hỏi “tháng trước thế nào”.
• x_mentions: ai đang nói về thương hiệu.
• delete_x_post: xóa một bài.

X là connector duy nhất tốn tiền theo mỗi lệnh gọi, và các con số được công bố chứ không bị che giấu. Meta, TikTok, LinkedIn, YouTube, Threads và Drive không tốn phí theo mỗi yêu cầu; X tính phí chúng tôi, nên các lệnh gọi đó bị tính một lượng nhỏ credit mỗi lần. Một bài thường được tính $0.015 mỗi yêu cầu, còn một bài có chứa liên kết là $0.200, đắt hơn khoảng 13 lần. Xóa, đọc và ghi metadata alt text mỗi thao tác có giá riêng, còn insight tính phí theo số bài được trả về. Việc phát hiện liên kết cố ý nghiêng về giả định là có liên kết, vì đoán sai theo chiều kia khiến chúng tôi tốn gấp 13 lần. Hệ quả thực tế: trên X, một bài tốt đánh bại năm bài, và agent của bạn được báo giá trước khi đăng. Độ dài là của tài khoản đăng bài, không phải cố định 280. Hermoso đọc gói đăng ký X của chính tài khoản và cho phép tối đa 25,000 ký tự khi Premium cho phép, nên một bài dài được đăng nguyên vẹn thay vì bị từ chối, và không có gì bị cắt. Đó cũng tình cờ là hình dạng rẻ nhất: một bài dài là một lệnh gọi X được tính phí, còn cùng những chữ đó chia thành năm bài là năm lệnh gọi. X Premium cũng mở khóa hai thứ Hermoso đăng hộ bạn: một Article dài, viết bằng Markdown với tiêu đề, danh sách, trích dẫn, khối mã và bảng còn nguyên vẹn, và một lần sửa bài đã đăng, trong khoảng một giờ mà X cho phép.

Các giới hạn của X cần biết trước khi bạn tự động hóa bất cứ thứ gì

Thử trong Claude Code

Hãy yêu cầu bằng ngôn ngữ thông thường. Đây là những câu thông thường, không phải DSL:

“Biến ./notes/launch.md thành một thread X không quá năm bài, chỉ giữ liên kết ở bài cuối, và cho tôi biết chi phí trước khi đăng.”

Chuỗi này đi qua get_brand → generate_text → post_to_x → x_post_insights_historical. Claude Code hỏi trước khi chạy một công cụ, và bản ghi nằm ngay trong terminal, nên một bước đăng là một dòng bạn có thể đọc trước khi nhấn y.

Claude Code trên X: phần gây khó khăn

Đặt liên kết vào một bài, không phải năm bài. Một bài có chứa liên kết được tính giá khoảng 13 lần so với bài thường, nên một thread mà mỗi bài đều có liên kết là hình dạng đắt đỏ, và việc phát hiện liên kết cố ý nghiêng về giả định là có liên kết. Nội dung vượt độ dài bị từ chối chứ không bị cắt, kèm phần vượt quá được đếm sẵn. Trong một script điều đó nghĩa là một lỗi gọn gàng mà bạn có thể xử lý, thay vì một bài bị gửi dở dang.

Plugin không mang manifest công cụ nào, điều này quan trọng nhất trong một lần chạy dài không có người giám sát: agent gọi lệnh hermoso cho mỗi bước, và --json trên bất kỳ lệnh nào cho nó đầu ra máy để kiểm tra.

Nghiên cứu X trước khi đăng

Không có thư viện quảng cáo X để tìm kiếm, vì X không công bố thư viện nào. Nghiên cứu X ở đây là về chính tài khoản của bạn: lượt nhắc đến, số liệu bài đăng và các con số lịch sử dành cho nhà quảng cáo. Mọi thứ khác trong bề mặt nghiên cứu không bị ảnh hưởng: thư viện quảng cáo Meta, Google và LinkedIn, cùng TikTok, Instagram, YouTube, Reddit và Threads tự nhiên.

Phần trả phí

X Ads đã ra mắt vào tháng 8 năm 2026, nên X giờ có cả hai nửa. API X Ads là một sản phẩm riêng, trên một host riêng với chữ ký OAuth 1.0a riêng, đó là lý do nó đến sau các phần còn lại. Hermoso giờ xây dựng toàn bộ cây bài quảng cáo được tăng cường trên nó: chiến dịch, line item (tên của X cho một ad group), promoted tweet, nhắm mục tiêu, ngân sách, trạng thái và báo cáo. Một quảng cáo X quảng bá một bài đăng, nên creative chính là một bài, cùng bài mà Hermoso đăng tự nhiên. Công tắc khiến tiền thật chạy sẽ từ chối nếu không có xác nhận rõ ràng, giống hệt trên mười một nền tảng còn lại. Một điều cần biết trước khi lên ngân sách: X cấp quyền truy cập Ads API theo từng tài khoản quảng cáo chứ không theo ứng dụng, nên không có nút OAuth cho nó: bạn thêm người dùng X của Hermoso vào tài khoản quảng cáo của mình tại business.x.com → Account access, và nó xuất hiện trong list_x_ads_accounts với quyền hạn mà X đã cấp.

Những gì Claude Code không tự làm được

Một agent có ngân sách chỉ hữu ích khi bán kính ảnh hưởng được giới hạn, nên hàng rào nằm trong máy chủ chứ không nằm trong prompt. Mọi chiến dịch, ad set, ad group và quảng cáo đều được tạo ở trạng thái tạm dừng, và các lệnh đổi trạng thái khiến tiền thật chạy sẽ từ chối nếu không có cờ xác nhận rõ ràng. Mọi bản render đều được báo giá trước (hermoso_capabilities công bố chi phí credit chính xác của từng mô hình trước khi có bất kỳ khoản nào được chi). Credit được giữ trước lệnh gọi nhà cung cấp đầu tiên và quyết toán theo chi phí chính xác sau đó, nên một lần gửi thất bại sẽ được hoàn lại thay vì để bạn bị tính phí cho không có gì. Thao tác xóa cũng cần xác nhận, và mọi cây chiến dịch đều được đọc lại từ nền tảng quảng cáo trước khi agent của bạn cho bạn biết nó đã dựng gì.

Một bước cố ý không thể làm không cần giao diện: liên kết tài khoản là một màn hình đồng ý OAuth, nên bạn kết nối kênh một lần trong trình duyệt. Mọi thứ sau đó là lệnh gọi công cụ.

Phần còn lại của ma trận

Từ Claude Code, đăng lên: Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram. Hoặc xem mọi thứ Claude Code có thể đăng.

Đăng lên X từ: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code marketing

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

Claude Code có thể đăng lên X không?

Có, với plugin Claude Code của Hermoso. Một lệnh: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, hoặc trong một phiên, /plugin marketplace add hermoso-ai/hermoso rồi /plugin install hermoso@hermoso. Nó cài năm kỹ năng Hermoso điều khiển CLI hermoso, nên không có danh sách công cụ nào được nạp vào phiên của bạn. Đăng nhập một lần bằng npx -y hermoso auth login, lệnh này mở trình duyệt và tự lưu thông tin xác thực, nên không có khóa nào cần tạo và không có khóa nào cần dán. Khi đó Claude Code có hơn 1.000 công cụ, bao gồm những công cụ đăng lên X, cùng những công cụ nghiên cứu quảng cáo đang chạy trong thị trường của bạn và dựng creative ngay từ đầu.

Làm sao để kết nối X với Claude Code?

Hai bước, mỗi bước làm một lần. Một lệnh: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, hoặc trong một phiên, /plugin marketplace add hermoso-ai/hermoso rồi /plugin install hermoso@hermoso. Nó cài năm kỹ năng Hermoso điều khiển CLI hermoso, nên không có danh sách công cụ nào được nạp vào phiên của bạn. Đăng nhập một lần bằng npx -y hermoso auth login, lệnh này mở trình duyệt và tự lưu thông tin xác thực, nên không có khóa nào cần tạo và không có khóa nào cần dán. Sau đó kết nối X trong Hermoso tại Workspace → Connectors, đây là màn hình đồng ý OAuth trên trình duyệt. Sau đó Claude Code đăng lên X như một lệnh gọi công cụ thông thường.

Claude Code có cần mật khẩu X của tôi không?

Không. Bạn kết nối X với Hermoso một lần qua màn hình đồng ý OAuth trên trình duyệt, và Claude Code sau đó truy cập nó như một lệnh gọi công cụ. Liên kết tài khoản là bước duy nhất không chạy không cần giao diện; mọi thứ sau đó không cần mật khẩu, và không có thông tin xác thực nào được giao cho mô hình.

Claude Code có thể lên lịch bài X để đăng sau không?

Có. schedule_post xếp bài vào một lịch chung với mọi kênh khác, kèm caption riêng cho từng kênh nếu nội dung cần khác, và list_scheduled cùng cancel_scheduled đọc và rút lại bài đó. X là một trong mười một kênh có thể xếp hàng.

Claude Code có thể đăng carousel lên X không?

Không. API của X đính kèm tối đa bốn phương tiện vào một bài và chúng hiển thị dưới dạng lưới, mọi ảnh đều thấy được cùng lúc và không có gì để vuốt, nên một bộ slide đánh số không thể đăng ở đó đúng như thiết kế. Claude Code gọi cùng một công cụ đăng trong cả hai trường hợp, và một kênh không thể mang carousel sẽ bị từ chối kèm lý do thực sự.

Đăng lên X từ Claude Code tốn bao nhiêu?

X là connector duy nhất tính credit theo mỗi lệnh gọi, vì X tính phí theo mỗi yêu cầu API: khoảng $0.015 cho một bài và $0.200 cho một bài có chứa liên kết, đắt hơn khoảng 13 lần. Agent của bạn được báo giá trước khi đăng. Các gói có giá $29, $69 và $149 mỗi tháng cho 1,300, 3,100 và 6,750 credit, và mọi tính năng đều có trong mọi gói kể cả Free. Ngoại lệ duy nhất là SSO doanh nghiệp.