Claude Code + Gemini 全步骤配置指南本文章意在记录自己在摸索Claude Code使用第三方模型Ge

前言

本文章意在记录 Claude Code 使用第三方模型的配置过程。

至本文章编写当日为止，AI 编程工具的名字已经是一大堆：Cursor、Claude Code、Codex、Antigravity、Trae CN、通义灵码... 很容易被绕晕。

考虑到工程能力的话，优先选择使用Claude Code。（当然，现在的Codex配置也挺啰嗦，还在摸索Codex + Gemini的配置，后续路子走通，会再整理新的文章。）

确认Node版本

node --version
# node版本要大于18.0

如果尚未安装，macOS执行命令行如下

brew install node

拿到Google API Key

打开: aistudio.google.com
点击 → Get API Key
点击 → Create API Key
复制下来 (像这样): AIzaSy........

最简单的方式：找你的领导直接申请一个API Key使用

安装所需工具

npm install -g @anthropic-ai/claude-code @musistudio/claude-code-router

创建配置文件夹

mkdir -p ~/.claude-code-router
mkdir -p ~/.claude

配置`claude-code-router`

CCR 的核心在于其配置文件。如果配置不当，容易遇到请求路径拼接错误（报 404）或者内部代码报错（如 Cannot read properties of undefined (reading 'image') ）。

两种方式二选一

方式一，需要创建文件，再编辑文件。

方式二，直接创建+编辑一次搞定。

touch ~/.claude-code-router/config.json
# 选择这种创建的方式，则需要将下面代码块car……EOF之间的内容，粘贴到config.json中
# 打开创建文件的命令行
open -a xcode ~/.claude-code-router/config.json

cat << 'EOF' > ~/.claude-code-router/config.json
{
  "LOG": true,
  "PORT": 3456,
  "Providers": [
    {
      "name": "gemini",
      "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
      "api_key": "$GOOGLE_API_KEY",
      "models": [
        "gemini-3.1-flash-lite"
      ],
      "transformer": {
        "use": ["gemini"]
      }
    }
  ],
  "Router": {
    "default": "gemini,gemini-3.1-flash-lite",
    "background": "gemini,gemini-3.1-flash-lite",
    "image": "gemini,gemini-3.1-flash-lite"
  }
}
EOF

设置API Key

echo 'export GOOGLE_API_KEY="你的_GEMINI_API_KEY"' >> ~/.zshrc
source ~/.zshrc
# 验证配置
echo $GOOGLE_API_KEY

验证配置

echo $GOOGLE_API_KEY
claude --version
ccr version

工作流程

启动路由服务

配置校验完成后，启动CCR服务。

ccr start

⚠️ 如果遇到 Failed to stop the service 或者端口被占用，使用以下命令确认或者强行杀掉进程，然后再启动：

# lsof -i :3456
# 上面注释掉的命令可以查看端口是否被占用。如果有输出（显示有 PID），说明后台有进程在运行占用着。
lsof -i :3456 | awk 'NR!=1 {print $2}' | xargs kill -9
ccr start

运行后没有报错退回终端 命令行，或者提示 Listening on...，或者如下图所示，则说明路由已经在后台正常运行。

启动 Claude Code

首先把 Claude Code 要发给 Anthropic 官方的请求，转到本地 3456 端口。

然后在终端App中逐条执行如下命令：

export ANTHROPIC_BASE_URL="http://localhost:3456"
export ANTHROPIC_API_KEY="your-gemini-key"
# 启动claude code
claude

(⚠️：your-gemini-key 这个随便填即可，仅仅是用来绕过 Claude 本地的强校验，真正的验证是由 CCR 使用配置的 Gemini Key 来完成的。)

一次启动服务和Claude

为避免每次启用claude都要重新敲一遍上面那些环境变量，可以把它们另外命名，封装成一个命令。

如果使用的是 iTerm2（三方终端）或者 zsh 终端（Mac 默认），只需在终端运行一次如下命令：

echo 'alias myclaude="ccr start && ANTHROPIC_BASE_URL="http://localhost:3456" ANTHROPIC_API_KEY="your-gemini-key" claude"' >> ~/.zshrc && source ~/.zshrc

配置完成，以后每次启用claude，只需要在终端输入如下命令：

myclaude

此时就会自动启动本地路由服务，配置好环境，并直接唤醒 Claude Code。

然后，你敲一个 hi，Claude Code就开始跟你互动。

具体工作

到实际工作开发中，当然是，先进入到具体工程项目文件夹，再执行 myclaude

Claude Code + Gemini 全步骤配置指南

前言