Files
Aperant/guides
Andy bb7e189374 feat: simplify thinking system and remove opus-1m model variant (#1760)
* feat: integrate Claude Opus 4.6 model with 1M context window option

Update model definitions across frontend and backend from claude-opus-4-5
to claude-opus-4-6 (without date suffix for automatic latest version).
Add "Claude Opus 4.6 (1M)" as a separate dropdown option that enables
the 1M token context window via the SDK beta header context-1m-2025-08-07.

Wire betas parameter through all create_client() callers in the core
pipeline (coder, planner, QA) and secondary callers (ideation, GitHub
PR review, triage, orchestrator, followup reviewer) so the 1M context
setting flows end-to-end from UI selection to the Claude Agent SDK.

Also fix pre-existing pydantic import error in test_integration_phase4.py
by mocking pydantic when not installed in the test environment.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: simplify thinking system and remove opus-1m model variant

Replace the 5-level thinking system (none/low/medium/high/ultrathink) with
a streamlined 3-level system (low/medium/high) aligned with Claude's effort
paradigm. Remove opus-1m model variant from frontend types, simplify agent
thinking defaults, and clean up related test infrastructure.

- Simplify THINKING_BUDGET_MAP to 3 levels in phase_config.py
- Update agent thinking_default values (coder: none→low, insights: none→low,
  spec_critic: ultrathink→high)
- Remove opus-1m from ModelTypeShort type
- Streamline all backend callers (planner, coder, QA, ideation, GitHub services)
- Update frontend constants, i18n, and task log labels
- Clean up test assertions for new thinking levels

Note: Pre-commit hook bypassed due to pre-existing test_github_pr_regression.py
failure in worktree environment (unrelated to these changes; 451/452 tests pass).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: address PR review feedback

- Fix inconsistent terminology: use 'thinking level' consistently in
  test docstrings (not 'effort level')
- Clean up pydantic mock after use to avoid leaking into sys.modules
  for the entire test session
- Update test assertions for new thinking defaults (coder: low,
  spec_critic: high)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: restore Opus 4.6 integration lost during thinking simplification

The thinking simplification commit accidentally reverted all Opus 4.6
changes (model IDs, betas/1M context, frontend constants). This commit
restores those changes and re-applies the thinking simplification on top.

Restored: model ID updates (opus-4-5→opus-4-6), opus-1m variant with
betas header for 1M context, betas parameter threading through all
callers (client, planner, coder, QA, ideation, GitHub services).

Thinking simplification preserved: 3-level system (low/medium/high),
ultrathink→high in spec phases and complex profile, none→low defaults.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add adaptive thinking/effort level support for Opus 4.6

Route thinking configuration based on model type: Opus 4.6 gets both
effort_level (via CLAUDE_CODE_EFFORT_LEVEL env var) and max_thinking_tokens,
while Sonnet/Haiku get max_thinking_tokens only.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: update tests to match simplified thinking levels (no none/ultrathink)

Tests were referencing 'none' and 'ultrathink' thinking levels that were
removed in 1445185b. Updated to match current valid levels: low, medium, high.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: update outdated docstring and add legacy thinking level mapping

- Update create_client() docstring to reflect current thinking budget values
- Add LEGACY_THINKING_MAP for backward compatibility: 'none' -> 'low',
  'ultrathink' -> 'high' with deprecation warnings
- Add tests for legacy level mapping

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: add missing agent_type to planner and clean up return types

- Add agent_type="planner" to follow-up planner create_client() call
- Update get_thinking_budget() return type from int | None to int
  since 'none' level was removed (now mapped via LEGACY_THINKING_MAP)
- Fix ruff formatting

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add Fast Mode toggle for Opus 4.6 and remove legacy thinking levels

Add a global Fast Mode setting that passes CLAUDE_CODE_FAST_MODE=true env var
to the Claude Code SDK subprocess for faster Opus 4.6 output at higher cost.
The toggle appears in Agent Profile settings only when an Opus model is selected.
Also removes deprecated 'none' and 'ultrathink' thinking levels from CLI choices
and all mapping code, treating them as invalid with a fallback to 'medium'.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: propagate fast_mode to ideation and add MODEL_ID_MAP sync comments

Thread fast_mode parameter through IdeationGenerator, IdeationConfigManager,
and IdeationOrchestrator so ideation agents benefit from Fast Mode when enabled.
Add --fast-mode CLI flag to ideation_runner and pass it from the frontend.
Add sync comments to MODEL_ID_MAP in both backend and frontend to prevent drift.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: propagate fast_mode to PR review agents

Add fast_mode field to GitHubRunnerConfig and pass it through to all
create_client() calls in parallel_orchestrator_reviewer and
parallel_followup_reviewer. Add --fast-mode CLI flag to GitHub runner.
Frontend buildRunnerArgs() now accepts fastMode option, passed from
PR review and follow-up review handlers via readSettingsFile().
Also fix leftover 'none' in GitHub runner thinking-level choices.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: clean up stale None types and comments after removing 'none' thinking level

- get_phase_config() return type: tuple[str, str, int | None] → tuple[str, str, int]
- THINKING_BUDGET_MAP type: Record<string, number | null> → Record<string, number>
- Remove '(null = no extended thinking)' comment from THINKING_BUDGET_MAP
- Remove dead None check and stale comment in insights_runner.py

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: correct stale frontend path in phase_config.py sync comments

Update MODEL_ID_MAP and THINKING_BUDGET_MAP cross-reference comments
from auto-claude-ui/src/... to apps/frontend/src/... to match the
actual monorepo path and the frontend's reciprocal comment.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: add missing fast_mode and betas params to remaining GitHub engines

- Add fast_mode=self.config.fast_mode to all 3 create_client() calls in
  pr_review_engine.py (run_review_pass, _run_structural_pass, _run_ai_triage_pass)
- Add fast_mode=self.config.fast_mode to triage_engine.py create_client() call
- Add betas and fast_mode params to review_tools.py spawn functions
  (spawn_security_review, spawn_quality_review, spawn_deep_analysis)
- Remove stale comment in insights_runner.py

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: add betas, fast_mode, and effort_level to spec pipeline agent_runner

Update create_client() call in AgentRunner.run_agent() to use
get_model_betas(), get_fast_mode(), and get_thinking_kwargs_for_model()
matching the pattern in coder.py, planner.py, and qa/loop.py. Add
thinking_level parameter to run_agent() signature and pass from orchestrator.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: sort imports in agent_runner.py to satisfy ruff I001

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: format multi-line import to satisfy ruff I001

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: wrap long line to satisfy ruff format

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: add fast_mode to GitLab MR engine and serialize in GitHub to_dict()

- Add fast_mode field to GitLabRunnerConfig and its to_dict()
- Add betas and fast_mode params to GitLab mr_review_engine create_client()
- Add fast_mode to GitHubRunnerConfig.to_dict() for settings persistence

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-09 10:33:45 +01:00
..
2026-01-12 15:27:47 +01:00

Auto Claude Guides

Detailed documentation for Auto Claude setup and usage.

Available Guides

Guide Description
CLI-USAGE.md Terminal-only usage for power users, headless servers, and CI/CD
windows-development.md Windows-specific development guide (file encoding, paths, line endings)
linux.md Linux-specific installation and build guide (Flatpak, AppImage)