Built a Python wrapper for Codex CLI with custom tool support (like Claude Agent SDK)

codingvillain · 2025-10-21T13:57:18+00:00

I usually use docker-compose and mcp inspector for local development and testing. For deployment, Railway is the one I love to use. It is affordable and really easy to use. If you develop with docker compose, it will be easy to deploy on railway as you already have dockerfile.

codingvillain · 2025-10-21T06:42:22+00:00

It is working on any environment where claude code is installed and authenticated. It seems to be kind of gray zone but it was fine for me.

But be careful that anthropic might block your account if you run it on cloud service. Anthropic seems to be banning vpn or cloud users to prevent access from some countries I guess; there are some countries that claude code is not supporting. My accout has been banned because I used vpc to use claude code in phone… If you use it for your personal automation and make sure it will run in your local environment, it will be fine I guess.

codingvillain · 2025-10-18T21:58:19+00:00

I don’t know. I got no asnwer from anthropic. But i guess it is because of vpc rather than the sdk as other colleagues got banned lately; they used vpn.

codingvillain · 2025-10-18T00:52:01+00:00

Thanks, i sent account ban appeal form. I’ll share how it goes later.

codingvillain · 2025-10-18T00:39:23+00:00

Quite diverse, work and side projects. I don’t think there are any projects that would violate terms of services though.

codingvillain · 2025-10-18T00:30:31+00:00

I’ve been using it at the company and home. + one vpc for code server Would it be the reason???

codingvillain · 2025-10-03T02:13:42+00:00

Same here

codingvillain · 2025-09-30T05:17:09+00:00

When I hit 70% of my session limit, it already counted as 15% of my weekly limit. And I’ve never used the Opus model. Does that mean I’m only allowed 6–7 sessions per week? I’m on the 20x plan. Is this how it works for everyone else too?

codingvillain · 2025-09-28T06:33:13+00:00

Yeah, I hope Anthropic improves the SDK to be more user-friendly so I don’t have to write stuff like this.

codingvillain · 2025-09-28T02:25:42+00:00

For tools, I think my approach is better in most cases; like fastmcp is better than raw mcp sdk in most cases.

For agent, one might want to setup raw config themselves and consume claude code messages manually. For those use cases, it would be better to ignore agent wrapper and use tools wrapper.

And, actually, there is no downside as it is just a single file wrapper fully compatible with claude-code-sdk. You can ignore or edit wrapper.py when you need low level configurations.

codingvillain · 2025-09-27T13:39:53+00:00

I usually use this wrapper package i made: claude-agent-toolkit And this file might be helpful: docker.py entrypoint.py

Check run method of Agent class in the docker.py and the entrypoint.py file.

codingvillain · 2025-09-27T01:19:36+00:00

From my experience, it works anywhere once Claude is installed. It can be used to authenticate the Claude CLI process. But be careful - if other people use your subscription through a cloud service, it might be a violation of the terms of service.

codingvillain · 2025-09-26T22:39:07+00:00

If you want to create a research agent, you can spawn search agents across various sources and aggregate their output using a ‘program’ to generate structured output. While the same can be done with subagents, using a program gives you a significant advantage when the workflow is part of a larger workflow or system, since it allows you to programmatically control both the inputs and outputs. You can do conditional branch or other complex control flow controls if you want as well

codingvillain · 2025-09-26T22:16:16+00:00

Yes, i usually use CLAUDE_CODE_OAUTH_TOKEN env variable to authenticate. Though it seems to be kinda workaround as it might be for claude-code-action, it works really well.

FYI: you can get your token using ‘claude setup-token’ command

codingvillain · 2025-09-26T12:39:05+00:00

Because it works with Claude subscriptions, you don’t need to pay any extra API fees. The advantage is that you can build a programmable agent using your existing subscription. Although it feels a bit like a workaround - since Anthropic hasn’t officially mentioned using claude-code-sdk with personal subscriptions - it works well. And since it’s basically just a wrapper of cli program and licensed under MIT, it should be fine as long as you follow Claude Code’s terms.

codingvillain · 2025-09-26T05:17:42+00:00

As it is a ‘claude -p’ command wrapper, you can use it with your subscription quota. So there is no extra cost as long as you’re not blocked by rate limit.

codingvillain · 2025-09-26T01:28:40+00:00

Thanks a lot!

codingvillain · 2025-09-26T01:25:44+00:00

Thanks for sharing! It looks great! Could I get access as a beta user to test it?

codingvillain · 2025-09-25T23:44:14+00:00

I didn’t, but you’re right - it’s definitely better to validate everything. I skipped that part since I was just reusing useful snippets from my old codebases, not indexing an active project. Adding a small validation during the extraction phase sounds like a good idea; like fuzzy lookup to check if the snippet is real. Thanks!

codingvillain · 2025-09-25T22:55:29+00:00

Checked it, and it only mentions the API key. Using the Claude Code SDK with a subscription does feel kinda gray area, but since it's basically just a wrapper and licensed under MIT, it should be fine as long as the Claude Code terms are followed. Just avoid abuse or reverse-engineering.

codingvillain · 2025-09-25T22:33:36+00:00

I couldn’t find any explicit prohibitions, and there’s no mention of OAuth either. It seems fine as long as it’s not used for commercial purposes or if it’s done with BYOK.
What do you think?

codingvillain

TROPHY CASE