FAQ
General
What is ccode?
ccode is a third-party launcher for Claude Code that adds profile management. It lets you switch between different model providers (Anthropic, DeepSeek, OpenRouter, Bedrock, etc.) with a single flag.
Is ccode affiliated with Anthropic?
No. ccode is not affiliated with or endorsed by Anthropic. It’s an independent, source-available tool.
Why not just use OpenCode (or similar)?
Other harnesses like OpenCode are lovely, but some people are more familiar with Claude Code, and it also has good support for various models on a per-task basis (e.g. sub-agents), permission controls etc.
You can even do something like launch it with ccode --deepseek remote-control and view the session either in your browser or the Claude Desktop app on any of your devices, even if the underlying model is different!
So with this tool you get both the Claude Code user experience that you enjoy, as well as pricing from other providers that you may enjoy more. See also Similar Software for alternatives.
Does ccode collect any data?
No. There’s no analytics or telemetry in ccode itself. Your prompts, API keys, and usage data stay between you and your chosen model provider.
Does ccode modify Claude Code?
No. ccode is a launcher, not a patch. It sets environment variables and then runs the standard claude binary. Claude Code itself is unchanged.
Configuration
Where is my config file?
| Platform | Path |
|---|---|
| Windows | %APPDATA%\ccode\config.yaml |
| Linux / macOS | ~/.config/ccode/config.yaml |
Run ccode profiles to see the exact path, or ccode edit-config to open it directly.
What’s the difference between the full and minimal config?
The full config (ccode init-config) includes commented-out examples for every supported provider: cloud providers (Bedrock, Vertex, Foundry), third-party providers (DeepSeek, OpenRouter, Z.AI, Kimi, Qwen, MiniMax), and local models. It’s 350+ lines.
The minimal config (ccode init-config --minimal) includes only the top-level settings and Anthropic direct profiles. It’s about 100 lines, and is useful for quick setup or project-level configs.
Can I use a project-level config?
Yes. Place a ccode.yaml (or .claude/ccode.yaml) in your project root. It merges with your user config at the field level, so you can put model settings in the project config and keep API keys in your user config. See Configuration for details.
How do I add a provider that isn’t in the default config?
Any provider that exposes an Anthropic-compatible API endpoint (/v1/messages) works. Set anthropic_base_url to the provider’s endpoint and anthropic_auth_token to your API key. See Providers for examples.
Profiles
How do profile shortcuts work?
Every profile name automatically becomes a --<name> CLI shortcut. If you have a profile called deepseek, then ccode --deepseek is equivalent to ccode --profile deepseek.
If a profile name collides with a Claude Code flag (e.g. you named a profile model), the shortcut is disabled and you’ll need to use --profile model instead.
Can I use multiple profiles at once?
No. Only one profile is active per session. However, you can set a different default_profile in a project-level config, so different projects can use different providers automatically.
How do I set a default profile?
Set default_profile in your config:
default_profile: deepseek
This profile is used when you run ccode without specifying one.
Troubleshooting
“No configuration found” on first run
This is normal. ccode creates a default config automatically on first run and tells you where it is. Edit the file to add your API keys, then run ccode again.
My profile shows “[no auth]”
This means the profile is missing authentication credentials. For third-party providers, you need anthropic_auth_token. For Anthropic API, you need anthropic_api_key. Run ccode profiles to see which profiles have this warning.
Claude Code flags aren’t working
Make sure you’re putting ccode flags before Claude Code flags:
# Correct
ccode --deepseek --continue
# Also correct (-- forces everything after it to pass through)
ccode --deepseek -- --some-flag
All flags that aren’t recognized by ccode are passed through to Claude Code automatically.
Licensing and pricing
Why source available license, not open source? Why not develop on GitHub?
A source available license was picked, so people wouldn’t just resell this app or sidestep the distribution method.
The limitation on no distribution of binaries is there so people also can’t just put something in the app that might be malicious or problematic, like telemetry. You are allowed to make forks and even make them available to others, but it must be a source distribution - so people can inspect the code and compile it themselves.
The source is not on GitHub, because I’m not really interested in the social aspects of development and providing free support. You can e-mail me, just don’t be mean.
Why charge money for this at all? Why allow 0 USD prices (free downloads)? Why Itch.io?
Someone has to pay for the Apple Developer account license, so I can sign the software and not have to ask people to work around quarantine restrictions.
At the same time, if someone doesn’t want to pay, they can still download the program for free, since that’s probably a bit safer than something like torrenting. Treat it like a WinRAR trial if you please.
I also chose Itch.io for the pay-what-you-want features, so it meets people’s needs better, given how many with different circumstances there are. If this shows that people will just download it for free and not pay, then so be it.
Frankly I’m helping a friend with their medical expenses, so I don’t really get to bad about trying to earn a buck in addition to my job with this.
What about updates? Do I have to pay if I only want the source?
I mostly ask for money for the prebuilt binaries and even that is optional.
If you feel like throwing a few dollars my way for the source, then that’s nice, if not, then that’s okay.
If updates come out and you’ve bought an older version, I don’t see an issue of you downloading the new version for free.
Can’t this be replicated in an evening?
Sure, probably in a few days. I just made something that I wanted to use. No reason why I couldn’t make it more widely available.
There was some annoying stuff around changing env variables and just multi-OS support in general, and OpenRouter seems to not work too well with claude -p and needs workarounds.
Development questions
I found a bug, how do I report it?
You can just send me an e-mail, the details are on my homepage.
Alternatively, Itch.io should also let you leave comments, probably easier.
Past that, I can’t commit to an SLA, since my job takes up most of my time.
Is there a roadmap?
Not quite, I’ll add whatever features seem nice.
I’m currently thinking about commands to add configuration interactively like:
ccode add-profile- and
ccode remove-profile my-custom-profile.
I’m also considering that it’d be nice to be able to add profiles from URLs where they are hosted:
ccode add-profile --from-url https://my-company.com/ccode/deepseek.yml
or thereabout.
Maybe it’d be nice to include an optional Anthropic API –> OpenAI API proxy to run locally, to support additional providers, but that might bloat the binary a little bit.
I’ve done something similar already internally for a company project, but I don’t want to bloat this app too much.
Will other harnesses like OpenCode be supported?
I was thinking about this, but that’d kind of bloat the config - and there’d probably be some confusion over that, managing just Claude Code is simpler.
OpenCode already has some settings files and while they’re not too comfy to manage, they seem to work already. I’ll just develop this well first.
How much of this is vibe coded?
A bunch. Then again, I’m not handling high volume financial transactions with that code, I’m just writing a convenience tool, so there’s not a lot of reason not to.
What is the site running on?
It’s a tool called mdBook, I really like it!
You input Markdown, it gives you a static HTML site that you can host wherever (I personally still like the Apache2 web server in a Docker container).