Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手（CLI 工具），直接在终端中提供代码补全、代码审查、架构分析等能力。但默认情况下 Claude Code 直连 Anthropic 官方 API，对于国内用户来说，网络延迟高、支付不便、模型选择受限。
通过接入 m1f API 中转网关，你可以让 Claude Code 使用你自己的 API 通道访问 Claude 模型，享受更低的延迟、更灵活的计费方式，以及更丰富的模型选择。
前置条件
在开始之前，请确保你已经：
- 注册并登录 apio.m1f.cn，获取一个有效的 API Key
- 安装了 Claude Code CLI（npm install -g @anthropic-ai/claude-code）
- 了解你的 m1f API 支持哪些 Claude 模型（如 claude-sonnet-5、claude-opus-4-8、claude-haiku-4-5 等）
💡 还没有 API Key？查看 m1f API 使用指南 快速上手。
配置方法一：环境变量（快速上手）
这是最简单的配置方式，设置两个环境变量后直接启动 Claude Code 即可：
Linux / macOS
# 设置 API 网关地址（不要加 /v1 后缀！）
export ANTHROPIC_BASE_URL="https://apio.m1f.cn"
# 设置你的 m1f API Key（两种方式任选其一）
# 方式 A：使用 ANTHROPIC_AUTH_TOKEN（推荐，Claude Code v2+ 首选）
export ANTHROPIC_AUTH_TOKEN="your-m1f-api-key-here"
# 方式 B：使用 ANTHROPIC_API_KEY（兼容旧版本）
export ANTHROPIC_API_KEY="your-m1f-api-key-here"
# 启动 Claude Code
claudeWindows（PowerShell）
$env:ANTHROPIC_BASE_URL = "https://apio.m1f.cn"
$env:ANTHROPIC_AUTH_TOKEN = "your-m1f-api-key-here"
claudeWindows（CMD 永久设置）
setx ANTHROPIC_BASE_URL "https://apio.m1f.cn"
setx ANTHROPIC_AUTH_TOKEN "your-m1f-api-key-here"
setx ANTHROPIC_MODEL "claude-sonnet-5"
claude⚠️ 注意： ANTHROPIC_BASE_URL 不要包含 /v1 路径！Claude Code 会自动追加 /v1/messages。如果设置为 https://apio.m1f.cn/v1，实际请求会变成 /v1/v1/messages，导致 404 错误。
配置方法二：settings.json（持久化配置）
如果你希望配置持久化保存，不用每次设置环境变量，可以编辑 Claude Code 的配置文件：
# 配置文件路径
# Linux/macOS: ~/.claude/settings.json
# Windows: %USERPROFILE%\.claude\settings.json{
"env": {
"ANTHROPIC_BASE_URL": "https://apio.m1f.cn",
"ANTHROPIC_AUTH_TOKEN": "your-m1f-api-key-here",
"ANTHROPIC_MODEL": "claude-sonnet-5",
"CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "190000",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "65536"
}
}配置完成后直接运行 claude 即可生效。环境变量会覆盖 settings.json 中的配置。
模型映射配置
Claude Code 内部会按能力层级请求不同的模型（Sonnet / Haiku / Opus）。要让 Claude Code 正确使用你想要的模型，需要通过环境变量指定模型映射：
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"
export ANTHROPIC_MODEL="claude-sonnet-5" # 主模型
export CLAUDE_CODE_SUBAGENT_MODEL="claude-haiku-4-5" # 子代理模型💡 你可以在 m1f API 后台查看当前可用的 Claude 模型列表。如果模型名称映射到了自定义别名（如 claude-sonnet），同样可以直接使用。
配置文件进阶：多 Profile 管理
Claude Code 支持多 Profile 配置，适合在不同项目中使用不同的模型或 API 密钥：
# 创建 profile 目录
mkdir -p ~/.claude/profiles/m1f-api
# 创建 profile 配置
cat > ~/.claude/profiles/m1f-api/settings.json << 'EOF'
{
"model": "claude-sonnet-5",
"env": {
"ANTHROPIC_BASE_URL": "https://apio.m1f.cn",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
"CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
}
}
EOF
# 使用 profile 启动
claude --profile m1f-api注意：API Key 不要保存在 profile 的 settings.json 中，应通过环境变量传入以确保安全：
export ANTHROPIC_AUTH_TOKEN="your-m1f-api-key-here"
claude --profile m1f-api完整配置示例
以下是一个开箱即用的完整配置脚本（Linux/macOS）：
#!/bin/bash
# m1f-api-claude.sh - 一键配置 Claude Code 使用 m1f API
export ANTHROPIC_BASE_URL="https://apio.m1f.cn"
export ANTHROPIC_AUTH_TOKEN="your-m1f-api-key-here"
# 模型映射
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"
export CLAUDE_CODE_SUBAGENT_MODEL="claude-haiku-4-5"
# 功能开关
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW="190000"
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="65536"
echo "🚀 启动 Claude Code（通过 m1f API）..."
claude "$@"OpenAI Codex CLI 配置方法
除了 Claude Code，OpenAI Codex CLI 是另一个非常流行的终端 AI 编程助手，同样可以通过 m1f API 中转网关来路由请求。Codex CLI 支持多种配置方式：
方式一：环境变量（快速上手）
设置 OPENAI_BASE_URL 和 OPENAI_API_KEY 即可将 Codex 指向 m1f API：
# 注意：Codex 的 base URL 需要包含 /v1 后缀（与 Claude Code 不同！）
export OPENAI_BASE_URL="https://apio.m1f.cn/v1"
export OPENAI_API_KEY="your-m1f-api-key-here"
# 启动 Codex
codex⚠️ 关键区别： Claude Code 的 ANTHROPIC_BASE_URL 不要加 /v1，而 Codex CLI 的 OPENAI_BASE_URL 必须加 /v1！两个工具的 base URL 格式完全不同，千万别搞混了！
方式二：.env 文件（项目级配置）
在项目根目录创建 .env 文件，Codex CLI 启动时会自动加载：
# .env
OPENAI_BASE_URL=https://apio.m1f.cn/v1
OPENAI_API_KEY=your-m1f-api-key-here方式三：config.toml 配置文件（推荐）
Codex CLI 使用 ~/.codex/config.toml 进行持久化配置，支持自定义 Provider：
# ~/.codex/config.toml
model = "gpt-4o-mini"
model_provider = "m1f-api"
[model_providers.m1f-api]
name = "m1f API"
base_url = "https://apio.m1f.cn/v1"
env_key = "M1F_API_KEY"
wire_api = "responses"然后设置环境变量（密钥不要写在配置文件中！）：
export M1F_API_KEY="your-m1f-api-key-here"
codex方式四：--provider 参数（临时切换）
也可以通过 --provider 参数快速切换不同的 API 后端：
# 使用自定义 provider
export M1F_API_KEY="your-m1f-api-key-here"
export M1F_BASE_URL="https://apio.m1f.cn/v1"
codex --provider m1f-api "写一个 Python 脚本"Codex CLI 支持的模型
通过 m1f API 接入后，你可以在 Codex CLI 中使用 m1f 支持的任意模型，包括：
- GPT-4o、GPT-4o-mini —— OpenAI 主力模型，适合日常编码
- o3、o4-mini —— OpenAI 推理模型，适合复杂任务
- Claude-Sonnet-5、Claude-Haiku-4-5 —— Anthropic 高质量模型
- DeepSeek-V4-Flash、DeepSeek-V4-Pro —— 高性价比选择
- Gemini-2.0-Flash、Gemini-2.5-Pro —— Google 模型
在 config.toml 中修改 model 字段即可切换模型，无需重启。
常见问题排查
Q: 启动后提示 "API Key 无效"
检查以下几点：
- 确认 m1f API Key 没有过期，可以在 apio.m1f.cn 后台重新生成
- 确认环境变量名正确：推荐使用
ANTHROPIC_AUTH_TOKEN（部分 Claude Code 版本不支持ANTHROPIC_API_KEY） - 如果之前登录过 Anthropic 账号，先运行
claude /logout清除旧认证
Q: 请求返回 404
最常见的错误：ANTHROPIC_BASE_URL 包含了 /v1 后缀。Claude Code 会自动追加 /v1/messages，所以正确的值是 https://apio.m1f.cn（不要加 /v1）。
Q: 提示 "Model not found"
你指定的模型在当前 m1f API 账户中不可用。登录后台查看可用模型列表，并更新 ANTHROPIC_MODEL 环境变量。
Q: 环境变量不生效
环境变量在 Claude Code 启动时读取一次，修改后需要重新启动 claude 才能生效。同时，环境变量的优先级高于 settings.json 中的配置。
Q: 如何验证配置是否正确？
在 Claude Code 中运行 /settings 命令查看当前使用的 API 地址和模型名。如果 API URL 显示为 https://apio.m1f.cn/v1/messages，说明配置成功。
总结
通过 m1f API 接入 Claude Code，你可以：
- ✅ 在国内流畅使用 Claude Code，无需特殊网络环境
- ✅ 按量计费，灵活充值，无需绑定海外支付方式
- ✅ 自由选择模型版本，随时切换 Sonnet / Haiku / Opus
- ✅ 通过 settings.json 实现持久化配置，团队统一管理
- ✅ 支持多 Profile，不同项目使用不同模型和密钥
立即体验：apio.m1f.cn → 获取 API Key → 配置 Claude Code → 开始编码！
相关文章
📖 m1f API —— AI API 中转网关服务使用指南 —— 了解 m1f API 的完整功能和使用方法
Comments NOTHING