mirror of
https://github.com/eyaltoledano/claude-task-master.git
synced 2025-07-04 15:41:26 +00:00
f7fbdd6755
* Feat: Implemented advanced settings for Claude Code AI provider - Added new 'claudeCode' property to default config - Added getters and validation functions to 'config-manager.js' - Added new 'isEmpty' utility to 'utils.js' - Added new constants file 'commands.js' for AI_COMMAND_NAMES - Updated Claude Code AI provider to use new config functions - Updated 'claude-code-usage.md' documentation - Added 'config-manager.test.js' tests to cover new settings * chore: run format --------- Co-authored-by: Ralph Khreish <35776126+Crunchyman-ralph@users.noreply.github.com>
150 lines
4.7 KiB
Markdown
150 lines
4.7 KiB
Markdown
# Claude Code Provider Usage Example
|
|
|
|
The Claude Code provider allows you to use Claude models through the Claude Code CLI without requiring an API key.
|
|
|
|
## Configuration
|
|
|
|
To use the Claude Code provider, update your `.taskmaster/config.json`:
|
|
|
|
```json
|
|
{
|
|
"models": {
|
|
"main": {
|
|
"provider": "claude-code",
|
|
"modelId": "sonnet",
|
|
"maxTokens": 64000,
|
|
"temperature": 0.2
|
|
},
|
|
"research": {
|
|
"provider": "claude-code",
|
|
"modelId": "opus",
|
|
"maxTokens": 32000,
|
|
"temperature": 0.1
|
|
},
|
|
"fallback": {
|
|
"provider": "claude-code",
|
|
"modelId": "sonnet",
|
|
"maxTokens": 64000,
|
|
"temperature": 0.2
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Available Models
|
|
|
|
- `opus` - Claude Opus model (SWE score: 0.725)
|
|
- `sonnet` - Claude Sonnet model (SWE score: 0.727)
|
|
|
|
## Usage
|
|
|
|
Once configured, you can use Claude Code with all Task Master commands:
|
|
|
|
```bash
|
|
# Generate tasks from a PRD
|
|
task-master parse-prd --input=prd.txt
|
|
|
|
# Analyze project complexity
|
|
task-master analyze-complexity
|
|
|
|
# Show the next task to work on
|
|
task-master next
|
|
|
|
# View a specific task
|
|
task-master show task-001
|
|
|
|
# Update task status
|
|
task-master set-status --id=task-001 --status=in-progress
|
|
```
|
|
|
|
## Requirements
|
|
|
|
1. Claude Code CLI must be installed and authenticated on your system
|
|
2. Install the optional `@anthropic-ai/claude-code` package if you enable this provider:
|
|
```bash
|
|
npm install @anthropic-ai/claude-code
|
|
```
|
|
3. Run Claude Code for the first time and authenticate with your Anthropic account:
|
|
```bash
|
|
claude
|
|
```
|
|
4. No API key is required in your environment variables or MCP configuration
|
|
|
|
## Advanced Settings
|
|
|
|
The Claude Code SDK supports additional settings that provide fine-grained control over Claude's behavior. These settings are implemented in the underlying SDK (`src/ai-providers/custom-sdk/claude-code/`), and can be managed through Task Master's configuration file.
|
|
|
|
### Advanced Settings Usage
|
|
|
|
To update settings for Claude Code, update your `.taskmaster/config.json`:
|
|
|
|
The Claude Code settings can be specified globally in the `claudeCode` section of the config, or on a per-command basis in the `commandSpecific` section:
|
|
|
|
```javascript
|
|
{
|
|
// "models" and "global" config...
|
|
|
|
"claudeCode": {
|
|
// Maximum conversation turns Claude can make in a single request
|
|
"maxTurns": 5,
|
|
|
|
// Custom system prompt to override Claude Code's default behavior
|
|
"customSystemPrompt": "You are a helpful assistant focused on code quality",
|
|
|
|
// Append additional content to the system prompt
|
|
"appendSystemPrompt": "Always follow coding best practices",
|
|
|
|
// Permission mode for file system operations
|
|
"permissionMode": "default", // Options: "default", "acceptEdits", "plan", "bypassPermissions"
|
|
|
|
// Explicitly allow only certain tools
|
|
"allowedTools": ["Read", "LS"], // Claude can only read files and list directories
|
|
|
|
// Explicitly disallow certain tools
|
|
"disallowedTools": ["Write", "Edit"], // Prevent Claude from modifying files
|
|
|
|
// MCP servers for additional tool integrations
|
|
"mcpServers": {
|
|
"mcp-server-name": {
|
|
"command": "npx",
|
|
"args": ["-y", "mcp-serve"],
|
|
"env": {
|
|
// ...
|
|
}
|
|
}
|
|
}
|
|
},
|
|
|
|
// Command-specific settings override global settings
|
|
"commandSpecific": {
|
|
"parse-prd": {
|
|
// Settings specific to the 'parse-prd' command
|
|
"maxTurns": 10,
|
|
"customSystemPrompt": "You are a task breakdown specialist"
|
|
},
|
|
"analyze-complexity": {
|
|
// Settings specific to the 'analyze-complexity' command
|
|
"maxTurns": 3,
|
|
"appendSystemPrompt": "Focus on identifying bottlenecks"
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
- For a full list of Cluaude Code settings, see the [Claude Code Settings documentation](https://docs.anthropic.com/en/docs/claude-code/settings).
|
|
- For a full list of AI powered command names, see this file: `src/constants/commands.js`
|
|
|
|
### Why These Settings Matter
|
|
|
|
- **maxTurns**: Useful for complex refactoring tasks that require multiple iterations
|
|
- **customSystemPrompt**: Allows specializing Claude for specific domains or coding standards
|
|
- **appendSystemPrompt**: Useful for enforcing coding standards or providing additional context
|
|
- **permissionMode**: Critical for security in production environments
|
|
- **allowedTools/disallowedTools**: Enable read-only analysis modes or restrict access to sensitive operations
|
|
- **mcpServers**: Future extensibility for custom tool integrations
|
|
|
|
## Notes
|
|
|
|
- The Claude Code provider doesn't track usage costs (shown as 0 in telemetry)
|
|
- Session management is handled automatically for conversation continuity
|
|
- Some AI SDK parameters (temperature, maxTokens) are not supported by Claude Code CLI and will be ignored |