Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agipower.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Guide to Using Codex CLI with AGIPower

Codex CLI is an open-source programming assistant from OpenAI that runs in your local terminal. It can read, modify, and run code within a directory you choose. Built with Rust, it is fast and efficient, and is continuously improved on GitHub. By integrating with AGIPower, you gain access to more model options instead of being limited to the official OpenAI API.
OpenAI has explicitly positioned Responses as the next-generation unified interface. Chat Completions is still available, but it is no longer the preferred choice for new projects. Codex will follow this direction as well—treating Chat Completions as a compatibility option and gradually migrating to Responses (the configuration in this article uses Responses).Note the OpenAI-compatible setting: base_url=“https://api.agipower.ai/v1”.

​
Configuration Options

​
Install Codex CLI

npm/pnpm
# Install with pnpm (recommended)
pnpm install -g @openai/codex

# Or install with npm
npm install -g @openai/codex

​
Configure Environment Variables

Add your AGIPower API Key to your shell configuration file: 
# Edit ~/.zshrc or ~/.bashrc depending on the terminal you use
export AGIPower_API_KEY="sk-xxx"
Make sure to replace sk-xxx with your actual AGIPower API Key. You can obtain an API Key in the AGIPower Console.

​
Configure Codex

Create or modify the Codex configuration file ~/.codex/config.toml: 
model_provider = "agipower"
model = "openai/gpt-5.2-codex"

[model_providers.agipower]  
name = "AGIPower"
base_url = "https://api.agipower.ai/v1"
env_key = "AGIPower_API_KEY"
wire_api = "responses"
  • model_provider: Use AGIPower as the model provider
  • model: The model to use; can be any model supported by AGIPower
  • base_url: The base URL of the AGIPower API
  • env_key: The name of the environment variable that stores the API Key
  • wire_api: Use the Responses protocol (recommended)

​
Start Using It Immediately

After configuration, reload your shell configuration and start Codex: 
# Reload configuration
source ~/.zshrc  # or source ~/.bashrc

# Enter your project directory
cd my-project

# Start Codex CLI
codex
After adding the environment variable to your shell configuration file, you won’t need to set it manually each time. The configuration will apply automatically every time you open a new terminal.

​
Supported Models

You can freely switch the model field in config.toml to any model supported by AGIPower.
Below are some recommended models with strong coding performance:
#Model slugHighlights
1openai/gpt-5.2-codexCoding-optimized
2openai/gpt-5.2Strong general capability
3anthropic/claude-sonnet-4.5Excellent reasoning
4anthropic/claude-opus-4.1Complex tasks
5google/gemini-2.5-proMultimodal support
6x-ai/grok-code-fast-1Fast responses
7x-ai/grok-4-fastEfficient coding
8deepseek/deepseek-chatCost-effective
9qwen/qwen3-coder-plusChinese-friendly coding
10moonshotai/kimi-k2-0905Long-context support
11z-ai/glm-4.6Balanced overall
12inclusionai/ring-1tStrong reasoning
For more models, see the AGIPower model list.

​
Responses-Compatible Models (Fetched on 2026-01-29)

The list below is fetched from the AGIPower model list (Responses filter). Use that link for the latest updates.

​
Model slug list (Responses)

inclusionai/llada2.0-flash-cap
z-ai/glm-4.7
minimax/minimax-m2.1
volcengine/doubao-seed-1.8
google/gemini-3-flash-preview
google/gemini-3-flash-preview-free
xiaomi/mimo-v2-flash
xiaomi/mimo-v2-flash-free
openai/gpt-5.2-codex
openai/gpt-5.2-pro
openai/gpt-5.2
openai/gpt-5.2-chat
z-ai/glm-4.6v
z-ai/glm-4.6v-flash-free
z-ai/glm-4.6v-flash
deepseek/deepseek-v3.2
mistralai/mistral-large-2512
deepseek/deepseek-chat
deepseek/deepseek-reasoner
anthropic/claude-opus-4.5
google/gemini-3-pro-image-preview
x-ai/grok-4.1-fast
x-ai/grok-4.1-fast-non-reasoning
google/gemini-3-pro-preview
openai/gpt-5.1
openai/gpt-5.1-chat
openai/gpt-5.1-codex
openai/gpt-5.1-codex-mini
baidu/ernie-5.0-thinking-preview
volcengine/doubao-seed-code
moonshotai/kimi-k2-thinking
moonshotai/kimi-k2-thinking-turbo
qwen/qwen3-max-preview
inclusionai/ming-flash-omni-preview
minimax/minimax-m2
kuaishou/kat-coder-pro-v1
kuaishou/kat-coder-pro-v1-free
anthropic/claude-haiku-4.5
inclusionai/ring-1t
inclusionai/ling-1t
google/gemini-2.5-flash-image
openai/gpt-5-pro
z-ai/glm-4.6
anthropic/claude-sonnet-4.5
deepseek/deepseek-v3.2-exp
openai/gpt-5-codex
qwen/qwen3-max
qwen/qwen3-vl-plus
x-ai/grok-4-fast
x-ai/grok-4-fast-non-reasoning
inclusionai/ling-flash-2.0
inclusionai/ring-flash-2.0
baidu/ernie-x1.1-preview
moonshotai/kimi-k2-0905
inclusionai/ling-mini-2.0
inclusionai/ring-mini-2.0
x-ai/grok-code-fast-1
deepseek/deepseek-chat-v3.1
volcengine/doubao-seed-1-6-vision
openai/gpt-5
openai/gpt-5-chat
openai/gpt-5-mini
openai/gpt-5-nano
anthropic/claude-opus-4.1
stepfun/step-3
z-ai/glm-4.5
z-ai/glm-4.5-air
qwen/qwen3-coder-plus
google/gemini-2.5-flash-lite
qwen/qwen3-235b-a22b-2507
qwen/qwen3-235b-a22b-thinking-2507
qwen/qwen3-coder
moonshotai/kimi-k2-0711
x-ai/grok-4
google/gemini-2.5-flash
google/gemini-2.5-pro
deepseek/deepseek-r1-0528
anthropic/claude-opus-4
anthropic/claude-sonnet-4
google/gemma-3-12b-it
qwen/qwen3-14b
openai/o4-mini
openai/gpt-4.1
openai/gpt-4.1-mini
openai/gpt-4.1-nano
meta/llama-4-scout-17b-16e-instruct
google/gemini-2.0-flash-lite-001
anthropic/claude-3.7-sonnet
google/gemini-2.0-flash
meta/llama-3.3-70b-instruct
anthropic/claude-3.5-haiku
anthropic/claude-3.5-sonnet
openai/gpt-4o-mini
openai/gpt-4o

​
Troubleshooting

​
Common Issues

​
API Key Error

Issue: You are told the API Key is invalid or unauthorized. Solutions:
  • Check whether the environment variable AGIPower_API_KEY is set correctly
  • Use echo $AGIPower_API_KEY to verify the environment variable value
  • Confirm the API Key is active and that you have sufficient balance
  • Verify the API Key format starts with sk-

​
Connection Failure

Issue: Codex CLI cannot connect to the AGIPower service. Solutions:
  • Check that your network connection is working
  • Verify that base_url in config.toml is correctly set to https://api.agipower.ai/v1
  • Confirm your firewall settings are not blocking outbound connections
  • Try curl https://api.agipower.ai/v1/models to test connectivity

​
Environment Variable Not Taking Effect

Issue: Even after setting the API Key, it still says it is not configured. Solutions:
  • Reopen the terminal window, or run source ~/.zshrc or source ~/.bashrc to reload the configuration
  • Confirm the environment variable is set correctly: echo $AGIPower_API_KEY
  • Make sure you added it to the correct shell configuration file (.zshrc for zsh, .bashrc for bash)

​
Configuration File Path Issue

Issue: Changes to the configuration file do not take effect. Solutions:
  • Confirm the configuration file path is ~/.codex/config.toml
  • If the directory does not exist, create it first: mkdir -p ~/.codex
  • Check that the configuration file syntax is correct (TOML format)
  • Use cat ~/.codex/config.toml to verify the file contents

​
Model Unavailable

Issue: A model is reported as unavailable or unsupported. Solutions:
  • Visit the AGIPower model list to confirm the model is available
  • Check that the model slug is spelled correctly
  • Try another recommended model to test
  • Confirm your account has permission to access the model

​
Advanced Configuration

​
Configure Models of Different Sizes

You can switch between different model sizes in config.toml based on your task requirements:
Balanced Setup
# Model choice that balances performance and cost
model_provider = "agipower"
model = "anthropic/claude-sonnet-4.5"

[model_providers.agipower]
name = "AGIPower"
base_url = "https://api.agipower.ai/v1"
env_key = "AGIPower_API_KEY"
wire_api = "responses"
Performance-First Setup
# Model choice optimized for performance
model_provider = "agipower"
model = "openai/gpt-5.2-codex"

[model_providers.agipower]
name = "AGIPower"
base_url = "https://api.agipower.ai/v1"
env_key = "AGIPower_API_KEY"
wire_api = "responses"
Cost-Optimized Setup
# Model choice optimized for cost efficiency
model_provider = "agipower"
model = "deepseek/deepseek-chat"

[model_providers.agipower]
name = "AGIPower"
base_url = "https://api.agipower.ai/v1"
env_key = "AGIPower_API_KEY"
wire_api = "responses"
If you run into any issues during use, or if you have suggestions or feedback, feel free to contact us via:For more contact methods and details, please visit our Contact page.