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

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

1. 方案概览

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

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

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

1.1 Claude Code使用方案

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

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

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

npm install -g  --registry=

A.2 启动与登录

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

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

# 启动 Claude Code

claude

浏览器登录并绑定账户：

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

模型选择： • 默认模型：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。

获取步骤：

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

B.3 配置环境变量

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

export ANTHROPIC_BASE_URL=

# 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
# 

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 或更高版本。

安装步骤

1. 安装 Node.js

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

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

验证安装：

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

1. 安装 Gemini CLI

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

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

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

1. 运行 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 环境变量
• 连接问题：检查防火墙和代理设置