Getting started - Teneo CLI x Claude Code
Install Teneo CLI toClaude Code
Use the Claude Code desktop app to install the Teneo CLI in under two minutes.
No prior coding experience is required.
Watch while you follow the steps below.
Time to complete
~10 min
Goal
Teneo CLI installed, ready to run
Requirements
Claude account
Difficulty Level
Beginner
In this tutorial
What you get
- Direct access to 50+ Teneo agents from inside Claude Code
- Scrape, swap, bridge, and query on-chain data in plain English
- A selection of free agents you can query right away, no wallet funding needed
An Anthropic account with access to Claude Code. No prior coding experience required. Claude handles the actual installation for you.
Resources
Docs, repos, and related tutorials
Everything referenced in this tutorial, plus a few adjacent paths if Claude Code isn't your preferred route.
Resources
Docs, repos, and related tutorials
Official docs
Related tutorials
Requirements
- Claude account with Claude Code access
- A local folder on your machine to install into
- (Later) a wallet + USDC for paid agent queries
Troubleshooting
- If the install stalls, check your internet connection and re-run the prompt
- If
npxcan't find the package, re-run with an internet connection - Never paste your seed phrase or private key into Claude or any chat
Step 1: Claude Code
Open Claude Code
We're using the Claude Code desktop app for this tutorial.
Step 1: Claude Code
Open Claude Code
In this tutorial we're using the Claude Code desktop app. It's the easiest way to follow along.
Claude Code also runs in the browser, on the mobile app, and in the terminal. If you already have one of those set up, the rest of the tutorial still applies with minor adjustments.
Downloading the Claude desktop app is easy. Grab it from the link below, install it, then open Claude Code from inside the app.
Step 2: Local folder
Create a local folder
A dedicated folder on your machine that Claude Code will use as its working directory.
Step 2: Local folder
Create a local folder
Before you install the Teneo CLI, you need a folder on your machine for it to live in. Claude Code will use this folder as its working directory when you run the install prompt.
Action 1: Create a local folder
Create a new folder on your computer. You can put it anywhere you like: Desktop, Documents, or any other location you can easily find again.
Creating a local folder in Windows Explorer
Creating a local folder in macOS Finder
Action 2: Name the folder
Name the folder whatever you like. We recommend Teneo CLI so it's obvious what's inside when you come back to it later.
Step 3: Install CLI
Install the Teneo CLI
Open Claude Code, point it at your folder, and send one prompt.
Step 3: Install CLI
Install the Teneo CLI
Action 1: Open Claude Code from the Claude desktop app
Launch the Claude desktop app and open Claude Code from inside it. In the left sidebar, click Code.
Opening Claude Code from the Claude desktop app
Action 2: Start a new session and select the folder you created
Start a new Claude Code session. In the folder picker, choose Open folder... and select the local folder you created in Step 2 (for example Teneo CLI). This tells Claude Code where to install the Teneo CLI files.
Selecting the local folder you created in Step 2
Action 3: Send the install prompt
With Claude Code pointed at your folder, paste the following prompt and send it:
install this: npx @teneo-protocol/cliClaude will run the install command, set up the CLI binaries, and confirm when it's done.
If you're using Claude Code in the terminal, you can also run the install command directly in your shell:
npx @teneo-protocol/cliAction 4: Wait for the install to complete
Claude will download the package, install the binaries, and display a confirmation. This typically takes under a minute depending on your connection.
Claude Code after successful Teneo CLI installation
Done. You can now query agents.
The Teneo CLI is installed. You now have access to the growing decentralised network of AI agents that make up Teneo Protocol.
Each agent is an AI endpoint. You send a query in natural language, the CLI routes it to live data sources, and your coding agent returns structured output.
Pricing is set per query by the agent builder and paid in USDC on our supported blockchain networks via x402.
Each agent can do things like scrape social media, pull crypto analytics, access prediction markets, and even execute token swaps. Try a free agent first to see the CLI in action.
Your CLI auto-generates its own wallet on install. You can fund that wallet later to query paid agents on Teneo Protocol. We'll cover funding your wallet and walking through specific agents in follow-up tutorials.
Reference
What got installed
When you run npx @teneo-protocol/cli, these files land in ~/teneo-skill/.
Reference
What got installed
| File | Purpose |
|---|---|
| teneo | Bash wrapper script (4 lines). Sets a 24h daemon idle timeout and runs teneo.mjs via Node |
| teneo.mjs | The actual CLI (~1.4 MB JavaScript bundle) |
| daemon.mjs | Background WebSocket daemon (~3.9 MB) that maintains a persistent connection to the Teneo backend |
| greetings.install.md | The greeting text shown during install |
What happens when you install the Teneo CLI: file structure
What happens when you install the Teneo CLI: daemon and wallet
What happens when you install the Teneo CLI: agent list
Important
Before you start querying
Wallet setup, funding, and safety.
Important
Before you start querying
What to know
- Installing the CLI auto-generates a wallet for you
- You can fund the wallet to interact with pay-per-query agents via x402 micropayments (USDC on PEAQ, Base, or Avalanche)
- Some agents are free to query. No funding needed to start exploring
- Fund your wallet in small increments to cover query fees. There is no minimum.
Never share your seed phrase. This wallet holds real funds. Fund it in small increments. Only what you need to cover query fees. Treat it like cash. Teneo cannot recover lost or compromised wallets.
A follow-up tutorial will cover querying specific agents live on Teneo Protocol, checking agent directories, and understanding query pricing. In the meantime, try running a query against one of the free agents to see the CLI in action.