Recommended action: Set EnvironmentID and EnvironmentKey (ANTHROPIC_ENVIRONMENT_KEY) for the worker; when dispatching items yourself, pass environment_key in HandleItemOptions. Option: Provide environment credentials [evidence: official_recommended_action] Steps: 1. export ANTHRO
Recommended action: Give realtime tools/handoffs unique names and remove outputSchema / programmatic allowedCallers from tools used by realtime agents. Option: Create realtime-specific tool definitions [evidence: documented_workaround] Steps: 1. Define separate tools without outp
Recommended action: Create a dedicated shadow database and set shadowDatabaseUrl (schema datasource in Prisma 6, prisma.config.ts datasource in Prisma 7); never point it at the same database as url. Option: Configure a dedicated shadow database [evidence: official_recommended_act
Recommended action: Set ANTHROPIC_API_KEY, or run `ant auth login`, or configure ANTHROPIC_FEDERATION_RULE_ID/ANTHROPIC_ORGANIZATION_ID/ANTHROPIC_IDENTITY_TOKEN_FILE; chmod 600 the credentials file and point ANTHROPIC_CREDENTIALS_PATH at the real (non-symlink) file. Option: Provi
Recommended action: Inspect the failed migration's logs column; if it made no/partial changes, revert them and run 'prisma migrate resolve --rolled-back <name>', fix and redeploy; if you completed it manually, run 'prisma migrate resolve --applied <name>'. migrate diff + db
Recommended action: Set mcpConfig.includeServerInToolNames: true on the agent to expose deterministic server-prefixed names, or filter tools per server. Option: Enable server-prefixed tool names [evidence: official_recommended_action] Steps: 1. agent: new Agent({ ..., mcpConfig:
Recommended action: Keep Files/Skills/models usage on the first-party Anthropic API client; on Bedrock/Vertex send content inline (base64/URL) in Messages instead of file_id references. Option: Route unsupported resources to first-party client [evidence: documented_workaround] St
Recommended action: Baseline: create an initial migration (prisma migrate diff --from-empty --to-schema ... --script > prisma/migrations/0_init/migration.sql) and mark it applied with 'prisma migrate resolve --applied 0_init', then run migrate deploy for subsequent migrations. Op
Recommended action: Set environment and dimensions on the Computer implementation, or target a GA computer model. Option: Provide display metadata or use GA model [evidence: documented_workaround] Steps: 1. Add environment (e.g. 'browser') and dimensions [w,h] to the Computer obj
Recommended action: Keep runArgs --cap-add=NET_ADMIN --cap-add=NET_RAW if using the script, ensure DNS/GitHub API reachable at start (or adapt allowlist for your proxy), or drop the script and rely on external network controls; for Node failure add ghcr.io/devcontainers/features/
Recommended action: Use HTTP responses.create/stream for provider or X.509 clients, or open the WebSocket from a client using a standard API key against api.openai.com. Option: Fall back to HTTP streaming [evidence: documented_workaround] Steps: 1. client.responses.stream(...) in
Recommended action: Make the certificate trusted (NODE_EXTRA_CA_CERTS with the provider CA, or node --use-openssl-ca), or explicitly pass ssl options to PrismaPg. Option: Trust the database CA in Node [evidence: official_recommended_action] Applies when: Managed Postgres with a p
Recommended action: Add toolSearchTool() to the same agent tools array and use an OpenAIResponsesModel. Option: Add toolSearchTool() [evidence: official_recommended_action] Steps: 1. tools: [toolSearchTool(), myDeferredTool] 2. Use a Responses model Expected: Request builds; mode
Recommended action: Update to v2.1.214+ via the install script (claude update itself hangs), or move the directory aside. Fix: Reinstall via script to get fixed version [evidence: released_fix] Applies when: see problem Steps: 1. ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_
Recommended action: Use OpenAI::BaseModel subclasses for streaming and tools, or keep Sorbet schemas to non-streaming create calls; add sorbet-runtime to the Gemfile and require 'openai/helpers/sorbet'. Option: Use BaseModel for streaming/tools [evidence: official_recommended_act
Recommended action: Keep write transactions short; set transaction_mode='IMMEDIATE' (Django 5.1+) or BEGIN IMMEDIATE; raise the timeout option; consider WAL journal mode via init_command PRAGMA; or move to a client-server database for real concurrency. Option: Use IMMEDIATE trans
Recommended action: Use the default HTTP Responses transport in those runtimes; use Node 22+ (global WebSocket) on servers. Option: Use HTTP Responses transport [evidence: official_recommended_action] Steps: 1. Turn off websocket transport for this runtime Expected: Model calls w
Recommended action: Rename newest %USERPROFILE%\.local\bin\claude.exe.old.* back to claude.exe, or reinstall; update Claude Desktop if it shadows the CLI. Option: Restore backup binary [evidence: official_recommended_action] Applies when: see problem Steps: 1. Get-ChildItem "$env