GCGCODE 中转站 · CLI 接入教程

PREREQUISITE

📦开始前须知

两款 CLI 都提供官方原生安装方式，无需预先安装 Node.js（npm 仅为可选途径）。准备好你在本站控制台领取的 API 密钥即可。

下文示例中：

请将 API 密钥 sk-xxxxxx 替换成你在本站控制台生成的真实密钥。
Codex CLI 的 Base URL 填 https://api.gcgcode.cc/v1，Claude Code 填 https://api.gcgcode.cc。

还没有密钥？前往控制台领取 →

01 / OPENAI CODEX CLI

Codex CLI 接入

通过 config.toml 把 Codex CLI 指向本站，密钥单独写入 auth.json。

1安装 Codex CLI

PowerShell 原生安装

PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

官方安装脚本

bash

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Homebrew / npm（任选其一）

shell

# macOS Homebrew
brew install --cask codex

# 需要 Node.js 18+
npm install -g @openai/codex

安装后验证

shell

$ codex --version

2创建配置目录

安装后 ~/.codex/ 目录及下面的 config.toml、auth.json 默认不会自动生成，需自行创建。配置目录：~/.codex/（Windows 为 %userprofile%\.codex\）。

macOS / Linux：运行 mkdir -p ~/.codex（目录已存在也不会报错）。
Windows：按 Win+R，输入 %userprofile%\.codex 打开；目录不存在则手动新建。

3写入 config.toml

打开（没有则新建）~/.codex/config.toml，在文件开头加入以下内容：

~/.codex/config.toml

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.gcgcode.cc/v1"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

4写入 auth.json（放置密钥）

在同目录新建 ~/.codex/auth.json，填入你的本站密钥：

~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-xxxxxx"
}

5验证接入

直接启动 Codex 进入交互界面，输入一句话发送，能正常对话即说明接入成功：

shell

$ codex
# 进入界面后输入下面这句并回车
> 用一句话介绍你自己

能正常返回模型回复 → 接入成功。
报 401 / invalid api key → 检查 auth.json 里的密钥。
报连接 / 404 错误 → 检查 config.toml 的 base_url 是否为 https://api.gcgcode.cc/v1。

02 / CLAUDE CODE

Claude Code 接入

通过环境变量或 settings.json 把 Claude Code 指向本站。

1安装 Claude Code

PowerShell

irm https://claude.ai/install.ps1 | iex

CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

bash

curl -fsSL https://claude.ai/install.sh | bash

winget / Homebrew / npm（任选其一）

shell

# Windows
winget install Anthropic.ClaudeCode

# macOS Homebrew
brew install --cask claude-code

# 需要 Node.js 18+
npm install -g @anthropic-ai/claude-code

安装后验证

shell

$ claude --version

2配置本站密钥

两种方式任选其一。方式 A 用环境变量（即时生效）；方式 B 写入配置文件（持久、推荐）。

方式 A · 环境变量

bash / zsh

export ANTHROPIC_BASE_URL="https://api.gcgcode.cc"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxx"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

CMD

set ANTHROPIC_BASE_URL=https://api.gcgcode.cc
set ANTHROPIC_AUTH_TOKEN=sk-xxxxxx
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

PowerShell

$env:ANTHROPIC_BASE_URL="https://api.gcgcode.cc"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxxx"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

环境变量只在当前终端会话生效。如需永久配置，请把它们写入 ~/.bashrc、~/.zshrc 或对应的配置文件。

方式 B · settings.json（推荐）

打开（没有则新建）~/.claude/settings.json（Windows 为 %userprofile%\.claude\settings.json）。该文件安装后默认不存在，目录或文件缺失时需自行创建：

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.gcgcode.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxx",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

注意：请使用 ANTHROPIC_AUTH_TOKEN（作为 Bearer token 发送），不要用 ANTHROPIC_API_KEY，后者若有残留会抢占优先级导致接入失败。

3验证接入

直接启动 Claude Code 进入交互界面，发送一句话并用斜杠命令查看当前线路：

shell

$ claude
# 进入界面后输入下面这句并回车
> 用一句话介绍你自己
# 再用斜杠命令查看当前线路
> /status

能正常返回回复，且 /status 显示地址为 https://api.gcgcode.cc → 接入成功。
报鉴权错误 → 检查 ANTHROPIC_AUTH_TOKEN 是否填对、是否误设了 ANTHROPIC_API_KEY。

03 / CHEAT SHEET

速查对比

对比项	Codex CLI	Claude Code
原生安装 (免 Node)	`irm .../codex/install.ps1 \| iex`	`irm https://claude.ai/install.ps1 \| iex`
接入本站	✓ 支持	✓ 支持
配置位置	`~/.codex/config.toml` `~/.codex/auth.json`	环境变量或 `~/.claude/settings.json`
Base URL 填法	config.toml 里 `base_url`	`ANTHROPIC_BASE_URL`
密钥填法	auth.json 里 `OPENAI_API_KEY`	`ANTHROPIC_AUTH_TOKEN`

⚠️ 安全提醒：API 密钥等同账号凭据，请妥善保管，不要提交到代码仓库或公开分享。