ClaudeToolingConfiguration class
Configuração do pacote de extensão de ferramentas claude. Herda todas as configurações de ferramentas e runtime.
Por que essa classe existe
Embora essa classe atualmente não adicione novas configurações além do que ToolingConfiguration fornece, ela existe por vários motivos importantes:
Segurança de Tipo: permite que os serviços específicos de Claude declarem sua dependência
IConfigurationProvider<ClaudeToolingConfiguration>, tornando o contrato de configuração explícito e habilitando a verificação de tempo de compilação.Ponto de Extensão: fornece um local claro para adicionar configurações específicas de Claude (por exemplo, tempos limite da API claude, preferências de modelo, políticas de repetição) sem quebrar o código existente quando essas necessidades surgirem.
Padrão Consistente: mantém a simetria com outros pacotes de extensão (LangChain, OpenAI), tornando o SDK mais fácil de entender e navegar.
Injeção de dependência: os serviços podem ser projetados para aceitar esse tipo de configuração específico, permitindo padrões de IoC adequados e testabilidade.
Exemplo
// Service declares explicit dependency on Claude configuration
class ClaudeService {
constructor(private configProvider: IConfigurationProvider<ClaudeToolingConfiguration>) {}
}
// Future: Add Claude-specific settings without breaking changes
class ClaudeToolingConfiguration extends ToolingConfiguration {
get claudeApiTimeout(): number { ... }
}
- Extends
Propriedades
| cluster |
|
| is |
Se o cluster é um ambiente de desenvolvimento (local ou dev). Com base em clusterCategory. |
| is |
Se NODE_ENV indica o modo de desenvolvimento. Retorna true quando NODE_ENV é "desenvolvimento" (não diferencia maiúsculas de minúsculas). Essa é a maneira padrão Node.js de indicar o modo de desenvolvimento. |
| mcp |
Obtém o escopo de autenticação da plataforma MCP. Usado por AgenticAuthenticationService para troca de tokens. Corta o espaço em branco para evitar falhas na troca de tokens. |
| mcp |
|
| use |
Se deve usar o arquivo ToolingManifest.json em vez da descoberta do gateway. Retorna true quando NODE_ENV é definido como "desenvolvimento" (não diferencia maiúsculas de minúsculas) ou quando explicitamente substituído por meio da configuração. |
Métodos herdados
| parse |
Analise uma variável de ambiente como um booliano. Reconhece 'true', '1', 'yes', 'on' (não diferencia maiúsculas de minúsculas) como true; todos os outros valores como false. |
| parse |
Analise uma variável de ambiente como um inteiro, retornando fallback se inválido ou não definido. |
Detalhes do construtor
ClaudeToolingConfiguration(ToolingConfigurationOptions)
new ClaudeToolingConfiguration(overrides?: ToolingConfigurationOptions)Parâmetros
- overrides
- ToolingConfigurationOptions
Detalhes da propriedade
clusterCategory
isDevelopmentEnvironment
Se o cluster é um ambiente de desenvolvimento (local ou dev). Com base em clusterCategory.
boolean isDevelopmentEnvironmentValor da propriedade
boolean
isNodeEnvDevelopment
Se NODE_ENV indica o modo de desenvolvimento. Retorna true quando NODE_ENV é "desenvolvimento" (não diferencia maiúsculas de minúsculas). Essa é a maneira padrão Node.js de indicar o modo de desenvolvimento.
boolean isNodeEnvDevelopmentValor da propriedade
boolean
mcpPlatformAuthenticationScope
Obtém o escopo de autenticação da plataforma MCP. Usado por AgenticAuthenticationService para troca de tokens. Corta o espaço em branco para evitar falhas na troca de tokens.
string mcpPlatformAuthenticationScopeValor da propriedade
string
mcpPlatformEndpoint
string mcpPlatformEndpointValor da propriedade
string
useToolingManifest
Se deve usar o arquivo ToolingManifest.json em vez da descoberta do gateway. Retorna true quando NODE_ENV é definido como "desenvolvimento" (não diferencia maiúsculas de minúsculas) ou quando explicitamente substituído por meio da configuração.
boolean useToolingManifestValor da propriedade
boolean
Detalhes do método herdado
parseEnvBoolean(undefined | string)
Analise uma variável de ambiente como um booliano. Reconhece 'true', '1', 'yes', 'on' (não diferencia maiúsculas de minúsculas) como true; todos os outros valores como false.
static function parseEnvBoolean(envValue: undefined | string): booleanParâmetros
- envValue
-
undefined | string
Retornos
boolean
Herdado de ToolingConfiguration.parseEnvBoolean
parseEnvInt(undefined | string, number)
Analise uma variável de ambiente como um inteiro, retornando fallback se inválido ou não definido.
static function parseEnvInt(envValue: undefined | string, fallback: number): numberParâmetros
- envValue
-
undefined | string
- fallback
-
number
Retornos
number
Herdado de ToolingConfiguration.parseEnvInt