ccchat 0.1.1

Chat with Claude AI from your favourite messenger
ccchat-0.1.1 is not a library.

ccchat - Claude Code Chat

Chat with Claude AI directly from your favourite messenger. Send a message, get an intelligent response — no browser or app switching required.

What is ccchat?

ccchat brings Claude AI into your messaging apps. Instead of opening a separate tool, just text your questions and Claude replies in the same chat.

  • Ask questions, get answers — right where you message
  • Each person gets their own private conversation that remembers context
  • Choose between different Claude models (Opus, Sonnet, Haiku)
  • Built-in cost tracking so you stay within budget

Supported Messengers

Messenger Status
Signal Supported

More messengers coming soon.

How it Works

You (messenger) → ccchat → Claude AI → ccchat → You (messenger)

You send a message. ccchat picks it up, asks Claude, and sends the answer back. That's it.

Quick Start (Signal)

What You Need

  1. A Signal account linked to signal-cli
  2. Claude Code installed and logged in

That's it. ccchat automatically installs and manages signal-cli-api for you.

Install

cargo install ccchat

Run

# Replace with your actual number
ccchat --account +447700000000
  • --account is the number ccchat listens on
  • By default, only messages from your own number are accepted (Note to Self)
  • Use --allowed to add other numbers: --allowed +447700000001,+447700000002

You can also use environment variables instead of flags:

export CCCHAT_ACCOUNT=+447700000000
export CCCHAT_ALLOWED=+447700000001
ccchat

Copy .env.example to .env for a template.

Using ccchat

Once running, just send a message to your ccchat number from your phone. Claude will respond in the same chat.

Commands

Type these in your chat to control ccchat:

Command What it Does
/reset Start a fresh conversation (clears memory)
/status Show how long ccchat has been running, message count, and total cost
/model sonnet Switch to a different Claude model (opus, sonnet, haiku)

Everything else you type gets sent to Claude.

Options

Setting Default What it Does
--account (required) Your account identifier
--allowed your own number Who's allowed to chat
--model opus Which Claude model to use
--max-budget $5.00 Maximum spend per message
--port 8080 Port for the messenger API (auto-selects if in use)
--api-url (auto-managed) Use an external messenger API instead of auto-managing

How Much Does it Cost?

ccchat itself is free. You pay for Claude API usage through your Anthropic subscription. Use /status to check your running total, and --max-budget to set a per-message spending cap.

Troubleshooting

ccchat starts but I don't get replies

  • Check that claude works on its own (claude -p "hello")
  • Verify your account number is correct

"Ignoring message from non-allowed sender"

  • The sender isn't in your --allowed list. Add their number with --allowed.

Messages are cut off

  • Long responses are automatically split into multiple messages. They should arrive in order.

License

MIT