2026年最新 Claude Code 国内直连教程:接入Gemini 3.5
Claude Code 是 Anthropic 推出的命令行 AI 编程助手,可以直接在终端中运行,并围绕当前项目目录进行代码级协作。它适合开发者阅读项目、修改代码、排查 Bug、生成文档和完成多轮开发任务。
如果你希望在国内环境中使用 Claude Code,同时又想调用 Gemini 3.5 Flash 这类速度快、成本更友好的模型,可以接入 Token173 中转网关(https://token173.com),支持国内直连调用 Claude、Gemini、GPT、DeepSeek、Grok 等主流模型。配置完成后,Claude Code 仍然在本地终端运行,但模型请求会通过 Token173 中转网关转发到指定模型 gemini-3.5-flash,你就能在 Claude Code 开发流程里借助 Gemini 3.5 Flash 写代码、排查故障、整理文档、分析项目架构。
一、为什么用 Claude Code 接入 Gemini 3.5 Flash?
Claude Code 最大优势是深度贴合真实开发流程,并非网页对话工具,可依托项目本地代码上下文实现连续迭代协作。
Gemini 3.5 Flash 适配这些开发场景:
- 追求模型响应速度,提升编码效率
- 想要控制API调用成本,高频使用也不耗费过多额度
- 日常代码注释、接口文档、需求方案整理撰写
- 快速梳理项目目录结构、业务接口逻辑
- 轻量脚本开发、批量代码优化、规则化代码修改
- 需要在 Claude Code 内灵活切换多款大模型
日常开发场景下,Gemini 3.5 Flash 是兼顾速度与性价比的编程模型,搭配 Claude Code 无需来回切换网页、客户端,全程在终端内完成项目开发全流程。
二、为什么建议通过 Token173 中转网关使用?
Claude Code 默认直连 Anthropic 官方接口,国内开发者直接访问极易遇到网络波动、访问超时、官方调用额度稀缺、可选模型单一等痛点。
接入 Token173 中转网关后,可将 Claude Code 的请求统一转发至中转服务,再调度调用目标大模型,核心优势如下:
- 国内网络稳定直连 Gemini、Claude、GPT 等海外主流大模型
- 单个API密钥统一管理全平台模型调用额度、调用日志
- 兼容 Claude Code、Cursor、OpenCode、Cherry Studio、Trae、Cline 等绝大多数AI开发工具
- 配置简单,仅需填写网关地址、API密钥、目标模型名称三步即可完成
- 支持自定义默认调用模型,一键将 Claude Code 默认模型设置为 gemini-3.5-flash
- 便于个人、团队统一管控API调用权限、用量消耗
三、使用前需要准备什么?
| 准备项 | 详细说明 |
|---|---|
| Node.js | Claude Code依托npm安装,必须提前部署Node.js环境 |
| npm | Node.js自带包管理工具,用于全局安装Claude Code CLI |
| Git | Windows系统推荐安装Git for Windows,适配各类项目代码管理 |
| Token173 API Key | 登录token173.com控制台,在密钥管理页面创建专属调用令牌 |
| Gemini 3.5 Flash模型权限 | 确认当前密钥所属分组已开通gemini-3.5-flash模型调用权限 |
| 本地项目目录 | Claude Code需要在具体项目文件夹内启动,才能读取代码上下文 |
Token173 API Key 创建步骤
- 打开官网:https://token173.com,完成注册并登录账号
- 左侧菜单栏进入「令牌管理」页面
- 点击「添加令牌」,新建用于Claude Code调用的API密钥
- 推荐配置:
- 令牌名称:Claude Code-Gemini
- 有效时长:可选择永不过期
- 调用额度:按需自定义设置,也可选择无限额度
- 分组:选择已开通Gemini系列模型权限的分组
- 可调用模型:勾选支持
gemini-3.5-flash
- 其余配置保持默认,创建后完整复制sk开头密钥妥善保存,切勿公开泄露
四、核心配置参数
Claude Code 接入 Gemini 3.5 Flash 关键配置参数如下:
| 参数 | 推荐填写值 | 配置说明 |
|---|---|---|
| ANTHROPIC_BASE_URL | https://token173.com | Token173中转网关地址,无需携带api前缀、不要拼接/v1路径 |
| ANTHROPIC_AUTH_TOKEN | sk-你的Token173密钥 | 平台后台生成的完整API Key |
| ANTHROPIC_MODEL | gemini-3.5-flash | 指定Claude Code默认调用模型 |
| API_TIMEOUT_MS | 300000 | 超时时间配置,规避网络偶发超时报错 |
五、Windows 安装和配置 Claude Code
Windows推荐使用PowerShell进行部署,无需依赖WSL、Ubuntu子系统。
1. 安装 Node.js
下载安装Node.js LTS长期支持版本,安装完成后重新打开PowerShell终端,执行命令验证:
node --version
npm --version
正常输出版本号即代表环境部署成功。
2. 安装 Git for Windows
未安装Git的用户建议部署,国内下载缓慢可使用清华镜像源下载安装包,安装时务必勾选Add Git to PATH,保证终端可全局调用Git命令。
3. 安装 Claude Code CLI
以管理员身份运行PowerShell,执行全局安装命令:
npm install -g @anthropic-ai/claude-code
安装完毕关闭当前终端,重新打开PowerShell,验证安装:
claude --version
输出版本号即为安装成功。
4. 配置Token173环境变量(永久生效)
setx ANTHROPIC_BASE_URL "https://token173.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Token173密钥"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
配置完成必须关闭当前终端,重新打开PowerShell,环境变量才能生效。
5. 启动 Claude Code
进入本地项目文件夹执行启动命令:
cd D:\你的项目文件夹
claude
按照终端指引完成初始化设置:选择终端主题、确认安全权限、信任当前工作目录,即可开始使用Gemini 3.5 Flash辅助开发。
六、Windows CMD 两种配置方式
方式1:当前窗口临时生效(关闭终端失效)
set ANTHROPIC_BASE_URL=https://token173.com
set ANTHROPIC_AUTH_TOKEN=sk-你的Token173密钥
set ANTHROPIC_MODEL=gemini-3.5-flash
set API_TIMEOUT_MS=300000
claude
方式2:全局永久环境变量
setx ANTHROPIC_BASE_URL "https://token173.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Token173密钥"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
配置后重启CMD终端,再执行claude启动程序。
七、macOS 安装和配置 Claude Code
1. 安装Homebrew(未安装则执行)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 安装Node.js
brew install node
node --version
npm --version
3. 全局安装Claude Code
npm install -g @anthropic-ai/claude-code
claude --version
4. 写入Token173永久配置文件
mkdir -p ~/.claude
nano ~/.claude/settings.json
粘贴以下配置内容,替换密钥:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的Token173密钥",
"ANTHROPIC_BASE_URL": "https://token173.com",
"ANTHROPIC_MODEL": "gemini-3.5-flash",
"API_TIMEOUT_MS": "300000"
}
}
保存退出编辑器,进入项目目录启动:
cd 你的项目文件夹
claude
八、Linux 安装和配置 Claude Code(Ubuntu/Debian)
1. 安装Node.js LTS
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
node --version
npm --version
2. 安装Claude Code CLI
sudo npm install -g @anthropic-ai/claude-code
claude --version
3. 配置中转网关参数
mkdir -p ~/.claude
nano ~/.claude/settings.json
填入配置:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的Token173密钥",
"ANTHROPIC_BASE_URL": "https://token173.com",
"ANTHROPIC_MODEL": "gemini-3.5-flash",
"API_TIMEOUT_MS": "300000"
}
}
保存后进入项目目录启动:
cd 项目路径
claude
九、如何确认已经成功调用 Gemini 3.5 Flash?
- 查看环境变量校验配置
macOS/Linux:
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_MODEL
Windows PowerShell:
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL
正常输出https://token173.com、gemini-3.5-flash代表基础配置生效。
- Claude Code内交互测试
启动后输入指令测试模型是否正常响应:
简单介绍下你擅长的代码开发工作,用列表形式输出
可以正常返回内容即代表中转调用成功。
- 平台控制台核对调用日志
登录token173.com后台,在调用记录页面查看是否存在gemini-3.5-flash的请求记录,确认模型调用生效。
十、Claude Code 高频开发提示词合集
- 项目结构分析:帮我梳理当前项目目录结构,说明各模块功能、项目入口文件
- 接口故障排查:分析这个500报错,结合路由、业务代码、日志定位问题并给出修复方案
- 新增业务功能:按照现有项目规范开发手机号验证码登录模块
- 代码重构优化:对当前组件做结构拆分,保留原有功能,优化代码可读性
- 部署文档生成:编写面向新手的项目部署文档,包含环境依赖、打包、启动命令与常见报错解决方案
- 安全漏洞巡检:排查项目内密钥泄露、跨域配置、接口权限校验等安全隐患
十一、常见问题处理方案
1. 提示Invalid API Key、请执行/login登录
- 检查密钥是否完整复制,必须以
sk-开头,无多余空格换行 - 确认Token173密钥未过期、未手动禁用,账号有可用调用额度
- 核对网关地址为
https://token173.com,禁止添加/v1、api前缀 - 修改配置后务必重启终端,同时校验settings.json格式为标准JSON
2. 模型配置不生效,依旧调用默认模型
- 确认环境变量
ANTHROPIC_MODEL值为gemini-3.5-flash - 关闭终端重新打开,清除原有会话配置
- 不要在启动命令加
--model参数、不要在会话内用/model切换其他模型 - 确认当前密钥分组已开通Gemini 3.5 Flash调用权限
- 检查项目目录下是否存在
.claude/settings.json,会覆盖用户全局配置
3. 请求报错fetch failed连接失败
- 完全退出Claude Code,重启终端后重新进入项目启动
- 逐项核对网关地址、API密钥、模型名称参数
- 确认本地网络可正常访问token173.com
- 保留
API_TIMEOUT_MS="300000"延长超时时间
4. Windows PowerShell无法加载claude.ps1脚本
执行命令临时放开执行策略:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
重启终端后重新校验claude --version。
5. 显示offline状态是否影响使用?
该状态仅为客户端联网检测提示,只要可以正常问答、处理代码任务,就不影响模型调用,可直接忽略。
6. Gemini 3.5 Flash适合所有开发场景吗?
该模型主打高响应速度、低成本调用,适合文档编写、代码解释、轻量开发、批量脚本处理;大型架构设计、超长篇代码重构、深度复杂逻辑推理场景,建议切换算力更强的大模型。
十二、极速精简配置步骤
Windows PowerShell一键配置
setx ANTHROPIC_BASE_URL "https://token173.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Token173密钥"
setx ANTHROPIC_MODEL "gemini-3.5-flash"
setx API_TIMEOUT_MS "300000"
重启终端,进入项目执行:claude
macOS / Linux 极简配置
编辑 ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的Token173密钥",
"ANTHROPIC_BASE_URL": "https://token173.com",
"ANTHROPIC_MODEL": "gemini-3.5-flash",
"API_TIMEOUT_MS": "300000"
}
}
执行claude启动使用。
十三、教程总结
Claude Code可以深度嵌入本地开发工作流,依托项目代码上下文完成代码分析、功能开发、Bug修复、项目重构、文档撰写等各类开发任务。国内开发者想要稳定低成本调用Gemini 3.5 Flash,最佳方案就是接入Token173中转网关。
核心配置要点:
- 网关地址固定填写:
https://token173.com,禁止添加api前缀与/v1后缀 - 填入平台后台生成的完整sk格式API密钥
- 默认模型指定为
gemini-3.5-flash,同时配置超时参数避免请求失败
一次配置即可在Windows、macOS、Linux多系统内稳定使用,依托Token173实现国内直连,一站式调用全球主流AI大模型,高效赋能程序员日常开发工作。
更多推荐

所有评论(0)