English | 日本語 | Español

ai-agent-camp

AI Agent Training for Non-Engineers - Complete Guide to Claude Code / Cursor / Codex

⚠️ Before you clone

Official repository (maintained by the authors):

• https://github.com/minicoohei/ai-agent-camp

Running AI agents from this repo grants them shell, file-write, and external-API permissions on your machine. Forks and mirrors can silently alter lessons or skills. Before running any lesson, verify your clone:

python3 tools/scripts/verify_integrity.py

If the check reports a fork or missing files, review git diff upstream/main -- .claude/ skills/ tools/ scripts/ before proceeding. See docs/security-guardrails.md.

Releases & Downloads

Releases are cut from main as tags matching v* (semver). A single tag produces three language-specific zip archives, all attached to the same GitHub Release.

Download URL pattern (pinned, never moves once published):

https://github.com/minicoohei/ai-agent-camp/releases/download/{tag}/ai-agent-camp-{lang}-{tag}.zip

| Language | Asset | Checksum | |----------|-------|----------| | 日本語 | ai-agent-camp-ja-{tag}.zip | ai-agent-camp-ja-{tag}.zip.sha256 | | English | ai-agent-camp-en-{tag}.zip | ai-agent-camp-en-{tag}.zip.sha256 | | Español | ai-agent-camp-es-{tag}.zip | ai-agent-camp-es-{tag}.zip.sha256 |

Each zip contains courses/, skills/, .claude/, .cursor/, docs/ with language suffixes already stripped, plus a CHECKSUMS.txt covering every file inside.

For humans

# Latest release, any language
gh release download --repo minicoohei/ai-agent-camp --pattern 'ai-agent-camp-en-*.zip'

# Specific version
gh release download v0.1.0 --repo minicoohei/ai-agent-camp \
  --pattern 'ai-agent-camp-en-v0.1.0.zip'

For AI agents

Parse the <!-- AGENT-META v1 --> block above, then:

1. (optional) hit latest_tag_api to resolve the current tag
2. fill release_asset_pattern with {tag} and {lang}
3. download, verify against the matching .sha256 asset, unzip

If you only need the lesson manifest, use manifest_raw_pattern with the lang_suffix map to fetch courses/lessons.manifest[.en|.es].yaml directly from a ref (branch, tag, or commit SHA).

See docs/release-process.md for the full specification, versioning policy, rollback procedure, and a Python parsing sample.

Before the first tag is cut: there are no Release assets yet, so the URL pattern above will 404 until v0.1.0 ships. Until then, clone the repo directly (git clone https://github.com/minicoohei/ai-agent-camp.git) or fetch individual files via raw.githubusercontent.com/.../main/....

Table of Contents

• Project Overview
• Key Features
• Quick Start
• Web Course (Recommended)
• Tool Comparison
• Learning Path
• Directory Structure
• Skill Matrix
• Required APIs
• Releases & Downloads
• Documentation
• FAQ
• Contributing
• Support

Project Overview

ai-agent-camp is a comprehensive training resource for non-engineering roles such as marketing, sales, planning, and administration to automate and streamline their work using AI agents like Claude Code, Cursor, and Codex.

Target Audience

• People with no programming experience
• Those who want to use AI tools in their daily work
• Anyone interested in automation and data analysis
• Teams looking to improve their overall AI literacy

Vision

Democratize AI agents from "tools for specialists" to "tools everyone can use," boosting productivity across the entire organization.

Key Features

• Optimized for Non-Engineers

  • No programming knowledge required
  • Step-by-step tutorials
  • Materials based on real business scenarios

• Practical Skill Set

  • 80+ ready-to-use commands
  • 42+ implemented skills (including marketing and LP/HP creation)
  • Business-specific workflow samples

• Comprehensive Curriculum

  • AI Fundamentals (Foundation) - 11 chapters
  • Environment Setup - 3 chapters
  • 20 core modules (Google Workspace, video production, requirements definition, marketing, and more)
  • CursorBootcamp YAML metadata support (all chapters)
  • Total study time: approx. 24 hours (30+ hours including exercises)

• Security and Best Practices

  • API key management guidelines
  • Secure data handling methods
  • Enterprise deployment guidance

• Business Workflow Templates

  • Customer support
  • Sales processes
  • Content marketing
  • Onboarding automation
  • Approval flow optimization

Quick Start

Prerequisites

• Git installed
• Python 3.9+
• Internet connection
• Cursor, Claude Code, or Codex available
• Windows users: WSL2 + Ubuntu is required. Native Windows (PowerShell / cmd) is not supported. See docs/terminal-guide.md for WSL2 setup.

Which tool should I choose? Run /start-0-8 (Tool Selection Guide) to compare Cursor / Claude Code / Codex and find the best fit.

Quickest Way to Begin

1. Clone this repo
2. Read the entry point for your tool:
   • Codex: AGENTS.md
   • Claude Code: CLAUDE.md
   • Cursor: .cursor/commands/lesson/start-0-1.md and other files in .cursor/commands/*
3. Review the safety rules:
   • Codex: docs/codex-safety.md
   • Claude Code / Cursor: docs/security-guardrails.md
4. Run setup verification:
   • Codex: aiagent-check-setup
   • Cursor: /check-setup
5. Start the first lesson with start-0-1

Create Your Own Repository

Copy this repository as your own private repo using one of these methods:

Method 1: Import Repository (GUI - Easy)

This can be done entirely through the GitHub web interface.

1. Log in to GitHub and select "+" > "Import repository" in the top right
2. Enter:
   • Your old repository's clone URL: https://github.com/minicoohei/ai-agent-camp.git
   • Repository name: any name (e.g., my-aiagent)
   • Privacy: Select Private
3. Click "Begin import"
4. After import completes, clone your repository:

   git clone https://github.com/{your-username}/my-aiagent.git
   cd my-aiagent
   

Method 2: Clone & Push (Command Line)

For those comfortable with the terminal.

# 1. Create an empty Private repository on GitHub

# 2. Create a mirror clone
git clone --bare https://github.com/minicoohei/ai-agent-camp.git my-aiagent.git
cd my-aiagent.git

# 3. Set the new origin and push
git push --mirror https://github.com/{your-username}/my-aiagent.git

# 4. Clone again for regular use
cd ..
git clone https://github.com/{your-username}/my-aiagent.git

Pulling Updates from the Original Repository

When the source materials are updated, pull changes with:

# First time only: add the original repo as upstream
git remote add upstream https://github.com/minicoohei/ai-agent-camp.git

# Pull updates
git fetch upstream
git merge upstream/main

If you use Cursor, you can run /update-material in chat to do the same thing.

Note: If you have made local changes, merge conflicts may occur. Resolve them manually.

Installation Steps

1. Clone the Repository

git clone https://github.com/minicoohei/ai-agent-camp.git ~/ai-agent-camp
cd ~/ai-agent-camp

2. Set Up Environment Variables

# First, prepare the key entry in .env.local
uv run python tools/credential_manager.py prepare-dotenv GEMINI_API_KEY

# After saving, optionally migrate to the Credential Store
# uv run python tools/credential_manager.py import-dotenv GEMINI_API_KEY --delete

Do not paste API keys in chat. Save them in .env.local.

3. Install Python Dependencies

# Install dependencies with uv
uv sync

4. Start the Course

# Open the course in a browser
# macOS: open https://ai-agent.camp
# WSL2:  wslview https://ai-agent.camp   (or just open the URL in your Windows browser)

# Open the workspace in Cursor
cursor .

# Claude Code and Codex also work with the same repo
claude
codex

Getting Started by Tool

Cursor

/check-setup
/overview
/start-0-1

Claude Code

• Read CLAUDE.md
• Review docs/security-guardrails.md
• After setup verification, proceed to the lesson flow

Codex

• Read AGENTS.md
• Open docs/codex-guide.md
• Run aiagent-check-setup skill for environment verification
• Pass start-0-1 to the aiagent-lesson-runner skill to start the first lesson

Web Course (Recommended)

Want a guided, structured learning experience?

AI Agent Camp offers a comprehensive