---

name: claude-code description: AI coding assistant powered by Claude Code. Reads codebases, edits files, runs commands, and automates coding workflows. Use for code reviews, refactoring, debugging, feature implementation, or any programming task.

Claude Code Skill

Claude Code is an agentic coding tool that understands your codebase, edits files, and runs commands. It works in your terminal, IDE, browser, and as a desktop app.

Quick Start

Interactive Mode (Default)

cd /path/to/project
claude

One-Time Tasks

claude -p "explain this function"
claude -p "fix the bug in auth.py"

Continue Previous Conversation

cd /path/to/project
claude -c

Common Use Cases

Code Understanding

# Explain a specific file
claude -p "explain the auth module"

# Understand the whole project
claude -p "what does this project do?"

# Find where a function is defined
claude -p "where is the login function defined?"

Code Changes

# Add new functionality
claude -p "add error handling to the API client"

# Refactor code
claude -p "refactor the database layer to use connection pooling"

# Fix bugs
claude -p "fix the memory leak in the cache module"

Git Operations

# Commit changes
claude -p "review my changes and create a commit"

# Review PR
claude -p "review this pull request for security issues"

# Resolve merge conflicts
claude -p "help me resolve these merge conflicts"

Advanced Workflows

Structured Output (JSON)

claude -p "list all API endpoints" --output-format json

Auto-Approve Tools

# Allow specific commands without prompting
claude -p "run tests and fix failures" --allowedTools "Bash(git test *),Read,Edit"

Streaming Output

claude -p "analyze the codebase" --output-format stream-json --verbose --include-partial-messages

CLI Flags Reference

Execution Mode

• claude - Interactive REPL (default)
• claude -p "query" - One-time query, then exit
• claude -c - Continue most recent conversation
• claude -r <session> - Resume specific session

Output Control

• --output-format text (default) - Plain text
• --output-format json - Structured JSON output
• --output-format stream-json - Streaming JSON for real-time parsing
• --json-schema '{...}' - Validate output against JSON Schema

Tool Control

• --allowedTools "Bash,Edit,Read" - Allow these tools without prompting
• --tools "Read,Edit" - Restrict to only these tools
• --disallowedTools "Bash" - Block specific tools

Customization

• --model sonnet - Use specific model
• --agent <name> - Use custom agent
• --append-system-prompt "..." - Add instructions to default prompt
• --system-prompt "..." - Replace entire system prompt

Session Management

• --no-session-persistence - Don't save session to disk
• --session-id <uuid> - Use specific session ID
• --fork-session - Create new session instead of reusing

Best Practices

1. Project Context

Always run claude from within your project directory so it has access to all relevant files.

cd /Users/wangyang/Documents/wwwroot/go/jdy-api
claude

2. Descriptive Prompts

Be specific about what you want. Instead of "help me," try:

• "Add input validation to user registration"
• "Refactor the auth module to use JWT tokens"
• "Fix the bug where users can submit empty forms"

3. Iterative Refinement

Start with broad questions, then refine:

1. "What does this code do?"
2. "Show me the main functions"
3. "Explain the authentication flow"

4. Using Auto-Approval

For trusted operations, pre-approve tools to avoid constant prompts:

# Read-only operations
claude -p "list all configuration files" --allowedTools "Read,Glob"

# Test execution in known project
claude -p "run the test suite" --allowedTools "Bash(git test *),Read,Edit"

# Git operations
claude -p "commit these changes" --allowedTools "Bash(git commit *),Bash(git diff *)"

5. Structured Outputs

Use --output-format json when parsing results programmatically:

result=$(claude -p "list all functions in main.go" --output-format json)
echo "$result" | jq '.result.functions'

6. Streaming for Long Tasks

Use streaming output to monitor long-running tasks:

claude -p "analyze the entire codebase" \
  --output-format stream-json \
  --verbose \
  --include-partial-messages | jq -r '.event.delta.text? // .text'

Examples

Debugging

# Find and explain errors
claude -p "find all TODO comments and check if they need attention"

# Debug a specific issue
claude -p "I'm getting a 500 error when calling the login endpoint"

Code Review

# Review changes before committing
claude -p "review the staged changes for security issues"

# Get diff explanation
claude -p "explain what this change does" --continue

Documentation

# Generate documentation
claude -p "generate API documentation for all endpoints"

# Update README
claude -p "update the README with installation instructions"

Refactoring

# Large refactoring with checkpoints
claude -p "refactor to use dependency injection" --max-turns 3
claude -p "continue refactoring to add interfaces" --continue

# Targeted refactoring
claude -p "simplify the authentication logic using middlewares"

Troubleshooting

Claude Code Not Found

# Install via Homebrew
brew install --cask claude-code

# Verify installation
which claude
claude --version

Session Issues

# List recent sessions
claude -c

# Clear history
claude /clear

# Start fresh
claude --no-session-persistence

API Connection Issues

# Check authentication
claude /login

# Verify account
claude --version

Advanced Features

Custom Agents

Define specialized subagents for specific tasks:

claude --agents '{
  "reviewer": {
    "description": "Code reviewer",
    "prompt": "You are a senior code reviewer. Focus on security and best practices."
  },
  "debugger": {
    "description": "Debugging specialist",
    "prompt": "You are an expert debugger. Analyze errors and provide fixes."
  }
}' -p "review the auth module"

Browser Integration

Enable Chrome for web automation and testing:

claude --chrome
claude -p "test the login form on https://example.com"

When to Use This Skill

Use Claude Code when:

• You need to read or edit code files
• Running commands in a codebase context
• Code reviews and refactoring
• Debugging and testing
• Git operations
• Any programming task that benefits from codebase understanding

Don't use Claude Code when:

• Simple text generation (use default model instead)
• Tasks that don't need code context
• Quick factual questions