AI Credentials Setup Best Practices: Utilizing Optimization Mode

Introduction

DevLoop Runner supports multiple AI providers (OpenAI, Claude Code, Anthropic). By configuring multiple credentials, you can enable optimization mode for more stable execution.

Supported Credentials

1. OpenAI API Key

OpenAI's API key. Required to use GPT models.

How to obtain:

1. Visit OpenAI Platform
2. Generate a new key in the API Keys section

2. Codex auth.json

OpenAI Codex authentication file.

How to configure:

• Drag and drop the auth.json file
• Or paste the JSON content directly

3. Claude Code Credentials

OAuth credentials for Claude Code.

Features:

• Has expiration date, requires regular updates
• Warning displayed 90 minutes before expiration

4. Anthropic API Key

Anthropic's API key. Directly uses Claude models.

How to obtain:

1. Visit Anthropic Console
2. Generate a new key in the API Keys section

What is Optimization Mode?

When both OpenAI/Codex type and Claude/Anthropic type are configured, optimization mode is enabled.

Features of Optimization Mode

1. Automatic Failover

   • If one AI returns an error, automatically switches to the other

2. Optimal Selection per Phase

   • Automatically selects the best AI for each phase

3. Improved Stability

   • More resilient to temporary API failures

Configuration Best Practices

Minimum Configuration

At least one of the following:

• OpenAI API Key
• Claude Code Credentials

Recommended Configuration

Configure both types to enable optimization mode:

• OpenAI type: OpenAI API Key or Codex auth.json
• Claude type: Claude Code Credentials or Anthropic API Key

Temporarily Disabling Credentials

You can temporarily disable specific credentials when reaching usage limits:

1. Find the credential on the Settings page
2. Toggle the switch to disable
3. The credential is preserved but won't be used during job execution

Updating Claude Code Credentials

Claude Code Credentials have an expiration date. How to update:

Update from Run page

1. Click "Update" link when expiration warning is displayed
2. Paste or drag-and-drop new credentials

Update from Settings page

1. Navigate to Settings page
2. Find Claude Code Credentials section
3. Enter new credentials

Troubleshooting

"Authentication Error" occurs

• Verify API key is copied correctly
• Check API key expiration date
• Check if usage limits have been reached

Optimization Mode not enabled

• Verify both OpenAI/Codex type and Claude/Anthropic type are configured
• Check if either is disabled

Summary

• Configure multiple credentials: Improve stability with optimization mode
• Configure both types: OpenAI type + Claude type for automatic failover
• Regular updates: Pay attention to expiration, especially for Claude Code Credentials
• Temporary disable: Use toggle to pause when reaching usage limits

Achieve an uninterrupted development experience with proper credential management.