docs: align claude setup references

This commit is contained in:
rob 2025-11-01 16:18:06 -03:00
parent d26c6c2210
commit e9cc23685d
3 changed files with 23 additions and 7 deletions

View File

@ -167,10 +167,26 @@ cat config/ai.yml
# Try environment variable override # Try environment variable override
CDEV_AI_COMMAND="claude -p '{prompt}'" git commit -m "test" CDEV_AI_COMMAND="claude -p '{prompt}'" git commit -m "test"
# Other provider notes # Setup Claude custom agents (recommended, one-time)
# codex-cli --stdin --model gpt-4.1-mini (requires OPENAI_API_KEY) ./tools/setup_claude_agents.sh
# gemini-cli --model=gemini-1.5-pro --stdin (requires GEMINI_API_KEY or GOOGLE_API_KEY)
# customize claude with --model or --agent to select a saved persona # Other provider authentication (one-time setup):
# Claude: Run 'claude' and follow authentication prompts
# OpenAI: Run 'codex' and sign in with ChatGPT account
# Gemini: Run 'gemini' and sign in with Google account (free tier available)
```
**Speed Optimization:**
The config uses fast models by default (Claude Haiku via custom subagent, GPT-5, Gemini 2.5 Flash). For complex changes, you can temporarily use quality models:
```bash
# One-time quality override with Claude Sonnet subagent
CDEV_AI_COMMAND="claude -p" git commit -m "complex refactor" # Uses ~/.claude/agents/cdev-patch-quality.md
# Or use OpenAI's full GPT-5 with deeper reasoning
CDEV_AI_COMMAND="codex --model gpt-5" git commit -m "complex refactor"
# Or use Gemini 2.5 Pro for 1M context window
CDEV_AI_COMMAND="gemini --model gemini-2.5-pro" git commit -m "complex refactor"
``` ```
### Votes Not Updating ### Votes Not Updating

View File

@ -17,7 +17,7 @@ version: 1
runner: runner:
command_chain: command_chain:
# Anthropic Claude CLI with custom subagent (fast Haiku model) # Anthropic Claude CLI with custom subagent (fast Haiku model)
# Create ~/.claude/agents/cdev-patch.md once with: ./tools/setup-claude-agents.sh # Create ~/.claude/agents/cdev-patch.md once with: ./tools/setup_claude_agents.sh
- "claude -p" - "claude -p"
# OpenAI Codex CLI with GPT-5 (default model, good balance) # OpenAI Codex CLI with GPT-5 (default model, good balance)
# Authenticate once with: codex (follow prompts to sign in) # Authenticate once with: codex (follow prompts to sign in)

View File

@ -97,14 +97,14 @@ Common non-interactive setups:
| Provider | CLI Tool | Command Example | Authentication | Notes | | Provider | CLI Tool | Command Example | Authentication | Notes |
| --- | --- | --- | --- | --- | | --- | --- | --- | --- | --- |
| Claude | `claude` | `claude -p` | Run `claude` and follow prompts to sign in | Supports custom subagents in `~/.claude/agents/`. Create with `./tools/setup-claude-agents.sh`. Uses Haiku (fast) or Sonnet (quality). | | Claude | `claude` | `claude -p` | Run `claude` and follow prompts to sign in | Supports custom subagents in `~/.claude/agents/`. Create with `./tools/setup_claude_agents.sh`. Uses Haiku (fast) or Sonnet (quality). |
| OpenAI | `codex` | `codex --model gpt-5` | Run `codex` and sign in with ChatGPT account | Codex CLI is OpenAI's terminal coding agent. Default model: GPT-5. Use `gpt-5-mini` for faster, cheaper responses. | | OpenAI | `codex` | `codex --model gpt-5` | Run `codex` and sign in with ChatGPT account | Codex CLI is OpenAI's terminal coding agent. Default model: GPT-5. Use `gpt-5-mini` for faster, cheaper responses. |
| Google | `gemini` | `gemini --model gemini-2.5-flash` | Run `gemini` and sign in with Google account | Free tier: 60 req/min. Use `gemini-2.5-flash` (fast) or `gemini-2.5-pro` (1M context, quality). Open source (Apache 2.0). | | Google | `gemini` | `gemini --model gemini-2.5-flash` | Run `gemini` and sign in with Google account | Free tier: 60 req/min. Use `gemini-2.5-flash` (fast) or `gemini-2.5-pro` (1M context, quality). Open source (Apache 2.0). |
**Recommended Setup:** Use the provided setup script to create Claude subagents: **Recommended Setup:** Use the provided setup script to create Claude subagents:
```bash ```bash
# One-time setup (creates ~/.claude/agents/cdev-patch.md and cdev-patch-quality.md) # One-time setup (creates ~/.claude/agents/cdev-patch.md and cdev-patch-quality.md)
./tools/setup-claude-agents.sh ./tools/setup_claude_agents.sh
``` ```
This creates two subagent files: This creates two subagent files: