Claude API Implementation Plan Documentation #408
Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
lukaszlenart
changed the title
- Add missing anthropic-version header requirement for authentication - Fix request/response models to match actual Claude API structure: * ContentBlock arrays instead of simple strings * System parameter support for Claude-specific system messages * Claude-specific tool calling format * Image content support via ContentBlock structure - Update build configuration with Scala 3 priority and projectMatrix integration - Refine testing strategy to focus on Claude-specific functionality - Update implementation phases with Claude-specific technical details - Add mandatory code formatting workflow documentation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
lukaszlenart
force-pushed
the
feature/claude-api-implementation-plan-updates
branch
from
3026ba6 to
586a943
Compare
lukaszlenart
added a commit
that referenced
this pull request
Sep 22, 2025
Add native Claude API support per issue #390, implementing Phase 1 of the implementation plan from PR #408. Core Implementation: - New `claude/` module with Scala 3 priority (3.3.6 + 2.13.16 cross-compilation) - ClaudeClient trait and ClaudeSyncClient for API operations - Messages API (/v1/messages) and Models API (/v1/models) support - Proper authentication with x-api-key and anthropic-version headers Claude-Specific Features: - ContentBlock architecture for messages (vs simple strings) - System parameter support (vs role-based system messages) - Image support via ContentBlock with base64 encoding - Tool calling foundation models (Tool, ToolInputSchema, PropertySchema) Models & Configuration: - ClaudeConfig with environment variable support - Claude model enums (Claude 3.5 Sonnet, Haiku, Opus, etc.) - Comprehensive error handling with ClaudeException hierarchy - JSON serialization using uPickle with proper ReadWriter instances Testing: - Unit tests for models, config, and core functionality - All tests passing (ContentBlockSpec, ClaudeModelSpec, MessageSpec) - Code formatted with sbt scalafmt as per project requirements This foundation enables future phases including streaming support (Phase 2) and advanced features (Phase 3+). 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
23 tasks
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds comprehensive documentation for Claude API implementation to support issue #390.
Files Added
📋
docs/plans/claude-api-implementation-plan.mdComplete technical implementation plan for native Claude API support including:
📚 Enhanced
CLAUDE.mdAdded critical code formatting workflow documentation to prevent CI failures during implementation.
Key Technical Corrections
✅ Authentication Configuration
anthropic-versionheader requirementClaudeConfigto include both required headers✅ Request/Response Models
StringtoList[ContentBlock]ContentBlockstructure✅ Build Configuration
✅ Implementation Strategy
Reference
This PR provides the documentation foundation for implementing issue #390 - Support Claude native API.
The detailed plan has also been added as a comment to the original issue for easy reference.
Ready for implementation team assignment.