DEV Community

Cover image for How to configure Claude CLI ACP for other compatible models, such as MiniMax M2.5
Hállan Costa
Hállan Costa

Posted on • Edited on

How to configure Claude CLI ACP for other compatible models, such as MiniMax M2.5

#claudecli #acp #bashrc #zshrc

Guide to configure the Claude Agent ACP with the MiniMax API using Fish Shell.

This tutorial is fully adaptable for users of .bashrc or .zshrc, with only minor changes to environment variable syntax and PATH configuration.

Prerequisites

  • Fish Shell installed
  • Node.js installed
  • MiniMax account with an API Key

1. Install Claude Agent ACP globally 

npm install -g @zed-industries/claude-agent-acp
Enter fullscreen mode Exit fullscreen mode

2. Configure environment variable

Add to your ~/.config/fish/config.fish file:

# Define node default on terminal (opcional)
# Check the node version that @zed-industries/claude-agent-acp was installed globally.
if type -q nvm
   nvm use 24 --silent
end

# MiniMax API Key
set -x MINIMAX_API_KEY "your-key-here"
Enter fullscreen mode Exit fullscreen mode

3. Create the claudem25-agent-acp script

Create the file cat > ~/.local/bin/claudem25-agent-acp:

#!/usr/bin/env fish
# Fish script to run ACP with MiniMax API
# Usage: claudem25-agent-acp

# Check if API key exists
if test -z "$MINIMAX_API_KEY"
    echo "Error: MINIMAX_API_KEY is not defined."
    return 1
end

# Clear existing Anthropic key
set -e ANTHROPIC_API_KEY

# Configure MiniMax as Anthropic-compatible
set -x ANTHROPIC_BASE_URL "https://api.minimax.io/anthropic"
set -x ANTHROPIC_AUTH_TOKEN "$MINIMAX_API_KEY"
set -x API_TIMEOUT_MS "3000000"
set -x CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1

set -x ANTHROPIC_MODEL "MiniMax-M2.5"
set -x ANTHROPIC_SMALL_FAST_MODEL "MiniMax-M2.5"
set -x ANTHROPIC_DEFAULT_SONNET_MODEL "MiniMax-M2.5"
set -x ANTHROPIC_DEFAULT_OPUS_MODEL "MiniMax-M2.5"
set -x ANTHROPIC_DEFAULT_HAIKU_MODEL "MiniMax-M2.5"

# Run ACP globally
claude-agent-acp "$argv"
Enter fullscreen mode Exit fullscreen mode

4. Make it executable 

chmod +x ~/.local/bin/claudem25-agent-acp
Enter fullscreen mode Exit fullscreen mode

5. Ensure ~/.local/bin is in PATH

Add to ~/.config/fish/config.fish:

fish_add_path ~/.local/bin
Enter fullscreen mode Exit fullscreen mode

6. Usage

Now you can run:

claudem25-agent-acp
claudem25-agent-acp --print-only --prompt "your task"
Enter fullscreen mode Exit fullscreen mode

Notes

  • claudem25-agent-acp uses the MiniMax API (M2.5 model)
  • The official claude-agent-acp continues to work with the Anthropic API
  • Both can coexist without interfering with each other

RELATED NOTES

How to Set Up Claude Code with Multiple AI Models
https://dev.to/hallancosta/how-to-set-up-claude-code-with-multiple-ai-models-4k6j

How to configure ACP agents in Zed
https://dev.to/hallancosta/how-to-configure-acp-agents-in-zed-521e

Top comments (0)