保姆级教程，通过GACCode在国内使用Claudecode、Codex！gaccode支持Claude Code +

gaccode支持Claude Code + Codex + Gemini Cli 三个工具，积分通用 • 支持两种使用方式：官方版本配合API方式和站内授权包安装方式，各位程序员可以按照自己合适方式使用。GAC订阅权限可发送任意邮件到gaccode@163.com邮箱获取。

1. 方案概览

GAC可以支持两种不同的使用方式，满足不同用户的需求。

方案A：改版客户端	方案B：原版+API
推荐用户：新手用户，希望简单上手	推荐用户：高级用户，希望使用官方原版
特点：	特点：
✓ 免翻墙使用，不封号	✓ 使用官方原版Claude Code
✓ 安装即用，无需配置	✓ 通过gaccode获得API Key
✓ 专用客户端，稳定性更好	✓ 灵活配置环境变量
✓ 自动适配路径，解决线路问题	✓ 保持与官方版本同步
✓ 告别5小时区间限制，享受1天内高强度持续工作	✓ 告别5小时区间限制，享受1天内高强度持续工作
✓ 不限制绑定终端数，可以给你的全部设备部署上Claude Code + Codex + Gemini Cli	✓ 不限制绑定终端数，可以给你的全部设备部署上Claude Code + Codex

📝 重要提醒： 两种使用方式都使用同一个gaccode账户，只需一次订阅，即可灵活切换使用。

🆕 新增功能： 现在gaccode订阅同时支持Claude Code、OpenAI Codex、Gemini CLI！积分在三个工具中通用扣除，让您的编程助手工具链更加完整。

1.1 Claude Code使用方案

方案A：站内包授权方案Claude Code客户端详细步骤

⚠️ 重要说明： 改版会自动适配路径，主要解决线路稳定性问题，请放心使用。

A.1 安装改版Claude Code客户端

npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com

A.2 启动与登录

⚠️ 网络问题解决： 如果遇到与cc链接的网络问题，请执行 claude --pick-relay 切换线路试下

# 进入项目目录
cd your-project-folder

# 启动 Claude Code

claude

浏览器登录并绑定账户：

注册账户 - 使用邀请链接注册gaccode账户
复制绑定地址 - 复制窗口中的绑定地址到浏览器中
完成绑定 - 点击授权完成绑定

🤖 模型选择： • 默认模型：Claude 4.6 • 可切换至 Claude 4.6 Opus，在设置中关闭强制Claude 4 然后输入 /model 切换

A.3 其他配置

此方式无需额外配置，安装后即可直接使用。

A.4 报错问题

运行Claude code若出现402报错“No Active Subscription **” 提示，请发生任意邮件至gaccode@163.com**获取权限。

方案B：原版Claude Code+API调用详细步骤

B.1 安装官方原版Claude Code

# 全局安装（更多用法见官方文档）
npm install -g @anthropic-ai/claude-code

⚠️ 如果已经安装过改版的需要卸载，可执行如下卸载：

npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude*

B.2 获得API Key

使用gaccode账户登录后，在账户页面获得API Key。

获取步骤：

注册账户 - 使用邀请链接注册gaccode账户
登录账户 - 登录gaccode网站获取API Key
配置使用 - 将API Key配置到环境变量中

B.3 配置环境变量

# 配置环境变量
export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_API_KEY=你的gaccode_api_key

export ANTHROPIC_BASE_URL=https://gaccode.com/claudecode

# Windows CMD 中
# setx ANTHROPIC_API_KEY "你的gaccode_api_key"
# setx ANTHROPIC_BASE_URL "https://gaccode.com/claudecode"

B.4 把 Anthropic API Key 的最后 20 位加入 `.claude.json` 中的 “approved” 列表，作为一个已允许的 key 标识

(cat ~/.claude.json 2>/dev/null || echo 'null') | jq --arg key "${ANTHROPIC_API_KEY: -20}" '(. // {}) | .customApiKeyResponses.approved |= ([.[]?, $key] | unique)' > ~/.claude.json.tmp && mv ~/.claude.json.tmp ~/.claude.json

B.5 启动与登录

# 进入项目目录
cd your-project-folder

# 启动 Claude Code

claude

说明： 使用官方原版 + API Key 时，通常无需浏览器授权；若终端提示登录，请按指引完成。

B.5.1 选择主题

B.5.2 直接按回车，表示已知悉

B.5.3 选择 1 接受推荐设置

B.5.4 选择 yes，相信这个文件夹

B.5.5 开始对话

B.6 报错问题

运行Claude code若出现402报错“No Active Subscription **” 提示，请发生任意邮件至gaccode@163.com**获取权限。

1.2 Codex 安装与使用

✨ 好消息： 现在您的gaccode订阅可以同时用于OpenAI Codex！积分在Claude Code和Codex之间通用扣除。

前置条件

使用Codex建议安装 Node.js 18 或更高版本，并保持系统包管理器更新至最新稳定版。

# 验证Node.js版本
node --version

npm --version

方案A：站内包授权方案一键安装启动（推荐）

适合想要快速上手的同学，自动完成程序下载、登录与配置。

A.1 安装 Codex（gaccode 版）

运行以下命令全局安装：

npm install -g https://gaccode.com/codex/install

A.2 启动与自动登录

安装完成后，运行：

codex

首次运行会自动：

🔄 程序下载： 自动下载必要的程序文件
🔐 OAuth 登录： 打开浏览器完成 gaccode 账户登录
⚙️ 自动配置： 完成 API 配置与环境设置

🎯 简单易用： 只需运行 codex，无需手动配置任何环境变量。

A.3 报错问题

运行Claude code若出现402报错“No Active Subscription **” 提示，请发生任意邮件至gaccode@163.com**获取权限。

方案B：官方 Codex 客户端 + gaccode API

适合希望使用官方 Codex 客户端的同学，通过配置自定义模型提供商对接 gaccode API。

B.1 配置 `~/.codex/config.toml`

新增 gac 配置并将默认 profile 指向它：

profile = "gac"

[model_providers.gac]
name = "gac"
base_url = "https://gaccode.com/codex/v1"
wire_api = "responses"
env_key = "CODEX_API_KEY"

[profiles.gac]
model_provider = "gac"
model = "gpt-5"
model_reasoning_effort = "medium"
approval_policy = "on-request"

B.2 设置环境变量

在 Shell 中导入从 gaccode 获取的 API Key：

# 到此页面获取 API Key
# https://gaccode.com/api-keys

export CODEX_API_KEY="你的Key字符串"

B.3 启动官方 Codex

直接运行官方客户端，使用 gac 配置档：

codex

提示： 如你在 config.toml 中未将 profile 设为 gac，也可通过命令行切换：codex --profile gac。

说明： 采用官方 Codex + API Key 方式通常无需浏览器授权，直接使用即可。

故障排除

如果安装或启动过程中遇到问题，可以尝试以下方案：

权限错误： 使用 sudo（macOS/Linux）或以管理员身份运行（Windows）
找不到命令： 重启终端或检查 PATH 环境变量
连接问题： 检查防火墙、代理或网络设置

💡 使用说明： 无论使用方案A或方案B，Codex 都会使用你的 gaccode 账户积分，且与 Claude Code 共享扣费额度。

B.4 报错问题

运行Claude code若出现402报错“No Active Subscription **” 提示，请发生任意邮件至gaccode@163.com**获取权限。

1.3 Gemini CLI 安装和使用

方案A: 改版 Gemini CLI 客户端详细步骤

Gemini CLI 安装

通过 npm 安装 Gemini CLI，开始使用 AI 进行编程。

前置条件

Node.js

Gemini CLI 需要 Node.js 18 或更高版本。

安装步骤

安装 Node.js

从官方网站下载并安装 Node.js。

官网地址: nodejs.org/en/download…

验证安装：

# 验证安装
node --version
npm --version

安装 Gemini CLI

运行以下命令全局安装 Gemini CLI：

npm install -g https://gaccode.com/gemini/install

该命令会从配置的源下载并安装程序包。

运行 Gemini CLI

运行以下命令进入Gemini CLI ：

gemini

模型切换

模型切换您可以覆盖默认模型（gemini-2.5-pro）以使用不同的 Gemini 模型：

例如：使用 gemini-3-pro-preview 在进来gemini cli 之前执行

gemini --set-model gemini-3-pro-preview

清除模型覆盖（使用默认）

gemini --set-model

模型覆盖保存在 ~/.gemini/model_override 文件中，会在会话之间保持。

报错问题

运行Claude code若出现402报错“No Active Subscription **” 提示，请发生任意邮件至gaccode@163.com**获取权限。

静默模式

如果您觉得启动器的输出过于繁琐，可以设置环境变量来启用静默模式，这样就能获得类似官方客户端的体验：

设置环境变量

export GEMINI_LAUNCHER_QUIET=1

启动 Gemini CLI

gemini

这将提供更简洁、更安静的体验，类似于官方 Gemini CLI 客户端。

升级 Gemini CLI

已经安装过？重新运行相同命令即可升级到最新版本：

npm install -g https://gaccode.com/gemini/install

此命令会全局重新安装 Gemini CLI 并升级到最新版本。

故障排除

常见问题：

权限错误：尝试使用 sudo（macOS/Linux）或以管理员身份运行（Windows）
找不到命令：重启终端或检查 PATH 环境变量
连接问题：检查防火墙和代理设置

保姆级教程，通过GACCode在国内使用Claudecode、Codex！

1. 方案概览

1.1 Claude Code使用方案

方案A：站内包授权方案Claude Code客户端详细步骤

A.1 安装改版Claude Code客户端

A.2 启动与登录

A.3 其他配置

A.4 报错问题

方案B：原版Claude Code+API调用详细步骤

B.1 安装官方原版Claude Code

B.2 获得API Key

B.3 配置环境变量

B.4 把 Anthropic API Key 的最后 20 位加入 .claude.json 中的 “approved” 列表，作为一个已允许的 key 标识

B.5 启动与登录

B.6 报错问题

1.2 Codex 安装与使用

方案A：站内包授权方案一键安装启动（推荐）

A.1 安装 Codex（gaccode 版）

A.2 启动与自动登录

A.3 报错问题

方案B：官方 Codex 客户端 + gaccode API

B.1 配置 ~/.codex/config.toml

B.2 设置环境变量

B.3 启动官方 Codex

B.4 报错问题

1.3 Gemini CLI 安装和使用

方案A: 改版 Gemini CLI 客户端详细步骤

报错问题

B.4 把 Anthropic API Key 的最后 20 位加入 `.claude.json` 中的 “approved” 列表，作为一个已允许的 key 标识

B.1 配置 `~/.codex/config.toml`