Contact us

Menu

ProductsModelsUse CasesAI AgentsAPI
Contact us
Back to AI Agents

Codex CLI Quick Switch to Cloudwise MaaS

Route Codex CLI through Cloudwise MaaS via cc-switch — single API endpoint for all compatible models

Codex CLI can route model traffic through Cloudwise MaaS with cc-switch. This guide shows a full workflow: create provider, switch provider, and validate by running a Codex command.

Table of Contents

Prerequisites

RequirementDetails
Codex CLIInstalled and executable in your shell.
cc-switchInstalled and ready to launch in interactive mode.
Cloudwise API KeyGenerate from Cloudwise Studio.
Endpointhttps://api.cloudwise.ai/api/v1

Configure Provider in cc-switch

Launch cc-switch and create a dedicated provider for Cloudwise MaaS.

1
Open Providers Menu

Start cc-switch interactive mode and focus Providers in the left menu.

cc-switch home view with Providers menu highlighted
2
Add a Provider

In the Providers panel, use the add action to create a new provider entry.

cc-switch providers panel ready for adding a provider
3
Set Provider Details

Use the following values:

FieldValue
IDcloudwise-maas
Namecloudwise maas
API URLhttps://api.cloudwise.ai/api/v1

After saving, switch to this provider so the top bar shows Provider: cloudwise maas.

cc-switch provider detail showing cloudwise maas and API URL

Important: Use the exact API base URL ending with /api/v1. If the base URL is wrong, Codex CLI calls will fail or target the wrong endpoint.

Verify in Codex CLI

Run a simple prompt to confirm Codex CLI is using the configured provider.

1
Run a Test Prompt
codex "hello"

You should see a normal response and model metadata in the session header.

Codex CLI test run showing successful hello response
2
Optional Follow-Up Prompt

Try another prompt such as Explain this codebase to validate ongoing interaction quality.

Configuration Reference

ScopeValue
Provider IDcloudwise-maas
Provider API URLhttps://api.cloudwise.ai/api/v1
Codex Validation Commandcodex "hello"
DocsCloudwise API Reference

Summary

You now have a complete configuration flow for Codex CLI with Cloudwise MaaS:

  • Create a provider in cc-switch
  • Set API URL to https://api.cloudwise.ai/api/v1
  • Switch to that provider
  • Run codex "hello" to verify end-to-end connectivity

For region-specific deployment, use the matching API domain. The US guide uses api-us.cloudwise.ai. Keep all screenshots and labels in English for consistency.