---
url: https://ain.hmgf.hxcn.space/ai/ai-custom-api-for-coding-tools.md
description: 在 Claude Code、Codex 与 Gemini CLI 中接入自定义 API 的跨平台安装与配置教程。
---

# 在AI编程工具中使用自定义API

本文演示如何在 `Claude Code`、`Codex`、`Gemini CLI` 中接入自定义 API（例如你自己的中转服务）。

> 将文中的 `https://your-relay.example.com` 和 `cr_xxxxxxxxxx` 替换为你的实际地址与密钥。

## Claude Code

```powershell
# 1) 安装 Node.js LTS（任选其一）
winget install OpenJS.NodeJS.LTS
# 或 choco install nodejs

# 2) 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 3) 验证
claude --version
```

```bash
# 1) 安装 Node.js（示例：Homebrew）
brew install node

# 2) 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 3) 验证
claude --version
```

```bash
# 1) 安装 Node.js（Ubuntu/Debian 示例）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 2) 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 3) 验证
claude --version
```

1. 编辑或新增 `settings.json`，新增或修改其中的 `env` 字段。

* Windows：`%USERPROFILE%\\.claude\\settings.json`
* macOS：`~/.claude/settings.json`
* Linux：`~/.claude/settings.json`

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "cr_xxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://your-relay.example.com",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}
```

2. 再编辑或新增 `.claude.json`，新增 `hasCompletedOnboarding` 参数。

* Windows：`%USERPROFILE%\\.claude.json`
* macOS：`~/.claude.json`
* Linux：`~/.claude.json`

```json
{
  "hasCompletedOnboarding": true
}
```

3. 注意：请将 `cr_xxxxxxxxxx` 替换为真实 API Key。环境变量 `ANTHROPIC_AUTH_TOKEN` 与 `ANTHROPIC_BASE_URL` 的优先级高于配置文件。

1) 安装 `cc-switch`（按系统选择一种方式）。
   * Windows：从 [cc-switch Releases](https://github.com/farion1231/cc-switch/releases) 下载并安装。
   * macOS：使用 Homebrew 安装（命令见下一步）。
   * Linux：从 [cc-switch Releases](https://github.com/farion1231/cc-switch/releases) 下载并安装。

2) 如果你是 macOS，执行以下命令安装 `cc-switch`。

```bash
brew tap farion1231/ccswitch
brew install --cask cc-switch
brew upgrade --cask cc-switch
```

3. 打开 cc-switch，点击右上角 `+` 新增供应商。
4. 供应商选择 `自定义API`，填写你的 Base URL 与 API Key。
5. 模型名称填写为 `gpt-5.3-codex`。
6. 启用配置后，确认 `.claude.json` 包含以下内容。
   * Windows：`%USERPROFILE%\\.claude.json`
   * macOS：`~/.claude.json`
   * Linux：`~/.claude.json`

```json
{
  "hasCompletedOnboarding": true
}
```

```bash
claude
```

如果能正常进入 CLI 并完成一次对话，说明配置已生效。

## Codex

```powershell
# 1) 安装 Node.js LTS
winget install OpenJS.NodeJS.LTS

# 2) 安装 Codex
npm install -g @openai/codex

# 3) 验证
codex --version
```

```bash
# 方式一：npm
npm install -g @openai/codex

# 方式二：Homebrew
brew install --cask codex

# 验证
codex --version
```

```bash
# 1) 安装 Node.js（示例）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# 2) 安装 Codex
npm install -g @openai/codex

# 3) 验证
codex --version
```

在 `%USERPROFILE%\.codex\config.toml` 写入：

```toml
model_provider = "crs"
model = "gpt-5.1-codex-max"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://your-relay.example.com/openai"
wire_api = "responses"
requires_openai_auth = true
```

然后在 `%USERPROFILE%\.codex\auth.json` 写入：

```json
{
  "OPENAI_API_KEY": null
}
```

💡 将 `OPENAI_API_KEY` 保持为 `null`，并设置环境变量 `CRS_OAI_KEY` 为你的 API 密钥（例如 `cr_xxxxxxxxxx`）。

在 `~/.codex/config.toml` 写入：

```toml
model_provider = "crs"
model = "gpt-5.1-codex-max"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://your-relay.example.com/openai"
wire_api = "responses"
requires_openai_auth = true
```

然后在 `~/.codex/auth.json` 写入：

```json
{
  "OPENAI_API_KEY": null
}
```

💡 将 `OPENAI_API_KEY` 保持为 `null`，并设置环境变量 `CRS_OAI_KEY` 为你的 API 密钥（例如 `cr_xxxxxxxxxx`）。

在 `~/.codex/config.toml` 写入：

```toml
model_provider = "crs"
model = "gpt-5.1-codex-max"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://your-relay.example.com/openai"
wire_api = "responses"
requires_openai_auth = true
```

然后在 `~/.codex/auth.json` 写入：

```json
{
  "OPENAI_API_KEY": null
}
```

💡 将 `OPENAI_API_KEY` 保持为 `null`，并设置环境变量 `CRS_OAI_KEY` 为你的 API 密钥（例如 `cr_xxxxxxxxxx`）。

```powershell
# 提醒：将示例值改为你的真实 CRS API Key（格式如 cr_xxxxxxxxxx）
$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"
codex -c model_provider="crs"
```

```bash
# 提醒：将示例值改为你的真实 CRS API Key（格式如 cr_xxxxxxxxxx）
export CRS_OAI_KEY="cr_xxxxxxxxxx"
codex -c model_provider="crs"
```

```bash
# 提醒：将示例值改为你的真实 CRS API Key（格式如 cr_xxxxxxxxxx）
export CRS_OAI_KEY="cr_xxxxxxxxxx"
codex -c model_provider="crs"
```

若命令能进入交互界面并成功响应，说明配置可用。

## Gemini Cli

```powershell
# 1) 安装 Node.js LTS
winget install OpenJS.NodeJS.LTS

# 2) 安装 Gemini CLI
npm install -g @google/gemini-cli

# 3) 验证
gemini --version
```

```bash
# 方式一：npm
npm install -g @google/gemini-cli

# 方式二：Homebrew
brew install gemini-cli

# 验证
gemini --version
```

```bash
# 通过 npm 安装
npm install -g @google/gemini-cli

# 验证
gemini --version
```

推荐方式（Code Assist 兼容）：

```powershell
$env:CODE_ASSIST_ENDPOINT = "https://your-relay.example.com/gemini"
$env:GOOGLE_CLOUD_ACCESS_TOKEN = "cr_xxxxxxxxxx"
$env:GOOGLE_GENAI_USE_GCA = "true"
$env:GEMINI_MODEL = "gemini-2.5-pro"
```

备用方式（Gemini API 兼容）：

```powershell
$env:GOOGLE_GEMINI_BASE_URL = "https://your-relay.example.com/gemini"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-2.5-pro"
```

推荐方式（Code Assist 兼容）：

```bash
export CODE_ASSIST_ENDPOINT="https://your-relay.example.com/gemini"
export GOOGLE_CLOUD_ACCESS_TOKEN="cr_xxxxxxxxxx"
export GOOGLE_GENAI_USE_GCA="true"
export GEMINI_MODEL="gemini-2.5-pro"
```

备用方式（Gemini API 兼容）：

```bash
export GOOGLE_GEMINI_BASE_URL="https://your-relay.example.com/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

推荐方式（Code Assist 兼容）：

```bash
export CODE_ASSIST_ENDPOINT="https://your-relay.example.com/gemini"
export GOOGLE_CLOUD_ACCESS_TOKEN="cr_xxxxxxxxxx"
export GOOGLE_GENAI_USE_GCA="true"
export GEMINI_MODEL="gemini-2.5-pro"
```

备用方式（Gemini API 兼容）：

```bash
export GOOGLE_GEMINI_BASE_URL="https://your-relay.example.com/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

```bash
gemini
```

如果首次启动进入认证流程，按你所选方案完成认证即可。

## 常见问题

## 参考资料

* [Claude Relay Service README](https://github.com/Wei-Shaw/claude-relay-service/blob/main/README.md)
* [pincc.ai Claude Code 安装](https://pincc.ai/claude-code-install)
* [MiniMax Claude Code（含 cc-switch）](https://platform.minimaxi.com/docs/coding-plan/claude-code#%E4%BD%BF%E7%94%A8-cc-switch%EF%BC%88%E6%8E%A8%E8%8D%90%EF%BC%89)
* [OpenAI Codex CLI README](https://github.com/openai/codex)
* [Google Gemini CLI README](https://github.com/google-gemini/gemini-cli)