支持两种使用方式：官方版本配合API方式和站内授权包安装方式，各位程序员可以按照自己合适方式使用。
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。
官网地址: https://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 环境变量
- 连接问题：检查防火墙和代理设置
