手动配置前必看

先检查环境，再安装命令行工具

很多“工具连不上”的问题，其实不是 6星中转令牌错了，而是终端、网络、代理、Node、配置文件路径或环境变量没有生效。手动配置前先按这篇走一遍。

预计阅读 6 分钟适合命令行工具安装前后要排查网络、代理和 PATH 的用户

终端检查网络环境变量配置文件

先跑快速检查看完成标准

10 分钟环境排查路线

按下面顺序排查，不要跳着改。前一层没通过时，后面配置再正确也可能失败。

先确认终端能执行基础命令

检查 curl、shell、PowerShell 或系统终端是否可用。命令本身不可用时，不要继续配置 API。

再确认终端能访问 6星中转

浏览器能打开不代表终端能打开。先用 curl -I "https://www.6xin.cc" 排除 DNS、代理和公司网络问题。

然后验证令牌和模型列表

用 /v1/models 区分认证问题和模型分组问题。401 先查令牌，403 或模型缺失再查分组。

最后才进入具体工具页

只有基础网络和令牌通过后，再去配置 Claude Code、Codex CLI、Gemini CLI、Cherry Studio 或 n8n。

本章先帮你排除什么

如果你是第一次接入命令行工具，先不要直接改 Claude、Codex 或 Gemini 的配置文件。用下面这张表判断问题在哪一层，再去对应教程继续。

你看到的现象	先检查	通过后下一步
终端里连 `curl` 都不能执行	终端和系统命令	安装缺失工具，或换 PowerShell / Terminal / Linux shell。
浏览器能打开 6星中转，终端请求失败	网络和 DNS、代理变量	确认终端也能访问 `https://www.6xin.cc`。
`/v1/models` 返回 401	API 认证与令牌	重新复制令牌，确认 Header 和环境变量。
`/v1/models` 有返回，但目标模型不可用	模型列表与可见性	确认模型 ID、令牌分组和接口能力匹配。
只有某个 CLI 工具失败	工具自己的版本、配置路径和 Base URL	进入对应工具页：Claude Code、Codex CLI、Gemini CLI。

一、确认终端可用

系统	推荐终端	检查方式
macOS	Terminal、iTerm2、Warp	执行 `echo $SHELL`，常见结果是 `/bin/zsh`。
Windows	PowerShell、Windows Terminal	确认能执行 `curl.exe --version`。
Linux	系统自带终端	确认能执行 `curl --version` 和 `which bash`。

复制下面命令做一次系统检查

先确认你正在使用的终端能执行基础命令。命令失败时，先解决终端环境，不要继续改 API Key。

# macOS / Linux
echo "$SHELL"
curl --version
which curl

# Windows PowerShell
$PSVersionTable.PSVersion
curl.exe --version
where.exe curl

Windows 上建议写 curl.exe，避免 PowerShell 把 curl 当成别名处理。macOS / Linux 上如果 which curl 没有结果，先安装系统工具。

二、确认能访问 6星中转

先用不带令牌的请求确认网络和 DNS 正常：

curl -I "https://www.6xin.cc"

返回结果	说明	下一步
`HTTP/2 200`、`301`、`302`	终端能连到 6星中转，网络层大体正常。	继续请求模型列表。
`Could not resolve host`	DNS 解析失败。	换网络、检查 DNS、确认域名没有拼错。
`Connection timed out`	网络或代理没有打通。	看代理和公司网络，必要时换网络再测。
证书相关错误	本机证书链或公司代理可能拦截了 HTTPS。	先用普通网络验证，不要为了省事关闭证书校验。

再用令牌请求模型列表，确认认证和分组基本可用：

curl "https://www.6xin.cc/v1/models" \
  -H "Authorization: Bearer sk-你的令牌"

如果第一条都连不上，先排查本地网络、代理、DNS 或公司网络限制；如果第一条能通、第二条 401，再排查令牌。

安全检查命令包

下面这些命令只检查环境是否存在，不会把完整令牌打印出来。复制给别人排障前，也要先确认输出里没有完整密钥。

# 基础网络
curl -I "https://www.6xin.cc"

# OpenAI 兼容令牌是否设置，只输出 set / empty
test -n "$OPENAI_API_KEY" && echo OPENAI_API_KEY=set || echo OPENAI_API_KEY=empty
printenv OPENAI_BASE_URL

# Claude Code 常见变量，只确认是否设置
test -n "$ANTHROPIC_AUTH_TOKEN" && echo ANTHROPIC_AUTH_TOKEN=set || echo ANTHROPIC_AUTH_TOKEN=empty
printenv ANTHROPIC_BASE_URL

# Gemini CLI 常见变量，只确认模型名和 key 是否存在
test -n "$GEMINI_API_KEY" && echo GEMINI_API_KEY=set || echo GEMINI_API_KEY=empty
printenv GEMINI_MODEL

不要执行 echo "$OPENAI_API_KEY"、echo "$ANTHROPIC_AUTH_TOKEN" 或 echo "$GEMINI_API_KEY" 后截图发给别人。需要排障时只确认变量是否存在。

三、检查常见运行时

工具	检查命令	什么时候需要
Node.js	`node -v`	安装或运行部分命令行 AI 工具时常用。
npm / pnpm / bun	`npm -v`	通过包管理器安装 CLI 时需要。
Homebrew	`brew -v`	macOS 安装桌面工具或依赖时常用。
Git	`git --version`	代码类工具读取仓库、提交 diff 或切换分支时需要。

按目标工具决定是否继续安装

你要接的工具	至少确认	下一页
CC Switch 桌面版	浏览器能打开外部应用协议，系统允许应用写本机配置。	CC Switch 一键导入
ccs CLI	`cc-switch --version` 或 `ccs --version` 能输出版本。	ccs CLI 命令行版
Claude Code / Codex CLI / Gemini CLI	对应命令能执行 `--version`，且新开终端后仍能找到命令。	工具接入总览
n8n 或服务端脚本	Node、npm 或运行平台 Secret 能正常读取。	n8n 工作流、API 认证与令牌

四、确认环境变量真的生效

设置环境变量后，必须在同一个终端窗口启动工具。另开窗口时，如果没有写入 shell 配置文件，变量不会自动存在。

export OPENAI_API_KEY="sk-你的令牌"
test -n "$OPENAI_API_KEY" && echo OPENAI_API_KEY=set || echo OPENAI_API_KEY=empty

临时变量和长期变量怎么选

方式	适合场景	注意事项
当前终端临时设置	一次性测试、排障、短时间验证。	关闭窗口后失效；适合先跑最小请求。
写入 `~/.zshrc`、`~/.bashrc` 或 PowerShell Profile	个人电脑长期使用。	文件不要提交到仓库；改完要新开终端。
部署平台 Secret	服务器、n8n、CI/CD、后端服务。	更新后通常要重新部署或重启服务才能读取新值。
CC Switch / ccs Provider	命令行工具切换后端。	Provider 里已经保存 Key；脚本里不要再写死完整令牌。

检查时只确认变量存在，不要把完整令牌截图给别人。需要排障时只提供前 6 位和后 4 位。

五、代理和公司网络

如果你所在网络需要代理，命令行工具不一定会自动读取浏览器代理。可以先检查这些变量：

echo "$HTTPS_PROXY"
echo "$HTTP_PROXY"
echo "$ALL_PROXY"

现象	可能原因	处理方式
浏览器能打开，终端 curl 失败	终端没有代理环境变量。	给当前 shell 设置代理，或换网络测试。
curl 证书错误	公司代理替换证书或系统证书链异常。	先用普通网络验证，不要轻易关闭证书校验。
偶发超时	网络质量或线路临时波动。	查看状态页，降低并发并重试。

临时代理变量示例

下面只展示变量写法，代理地址以你自己的网络环境为准。不要套用不存在的端口。

# macOS / Linux
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

# Windows PowerShell
$env:HTTPS_PROXY="http://127.0.0.1:7890"
$env:HTTP_PROXY="http://127.0.0.1:7890"

如果公司网络会替换证书，优先找 IT 或网络管理员确认正确做法。不要把 -k 或关闭证书校验写进长期脚本里。

排查时的停止点

如果命中下面任意一项，先把这一层解决掉，再继续工具配置。这样比反复重装 CLI 更快。

停止点	说明	下一步
`curl -I` 访问 6星中转失败	本机终端网络还没通。	先处理 DNS、代理、公司网络或本机证书。
`/v1/models` 返回 401	令牌或 Authorization 写法不对。	回到 API 认证错误检查 Header 和令牌复制。
`/v1/models` 正常但工具失败	基础令牌可用，问题可能在工具配置、Base URL 或项目覆盖。	进入对应工具页的“覆盖来源”或“失败排查”。
只有某个项目失败	通常是项目 `.env`、配置文件或脚本覆盖。	先检查项目级配置，再改全局配置。
6星中转用量日志没有记录	请求可能没有进入 6星中转。	检查工具是否还在走旧地址、旧令牌或旧终端进程。

环境变量或代理配置异常后，先回到干净终端

环境排障时最容易把临时变量、shell 配置、项目 .env 和代理变量混在一起。出现“刚才能用、现在不能用”时，先退回干净终端，再逐项加回。

刚才改了什么	先退回到什么状态	回退后怎么确认
当前终端临时变量	新开一个终端窗口，不加载刚才手动 export 的值。	用安全命令只确认变量是否存在，不打印完整令牌。
`~/.zshrc`、`~/.bashrc` 或 PowerShell Profile	先注释刚新增的 6星中转相关变量，只保留你确认正确的一组。	重新打开终端，再检查 Base URL 和 key 是否来自同一套配置。
代理变量	临时清掉 `HTTPS_PROXY`、`HTTP_PROXY`、`ALL_PROXY`，或换到无代理网络测试。	`curl -I "https://www.6xin.cc"` 能返回 HTTP 头；如果无代理失败，再按你的网络环境加回代理。
项目级 `.env`	先不要改全局配置，只检查当前项目是否覆盖了 Base URL、模型或 API Key。	同一条命令在项目目录内外结果一致，说明不是项目级覆盖导致。
CLI Provider 或桌面工具配置	先回到工具里已验证过的 Provider，关闭刚新增的临时配置。	用短请求和 6星中转用量日志确认请求确实走当前 Provider。

# macOS / Linux：只清理当前终端里的临时代理变量
unset HTTPS_PROXY HTTP_PROXY ALL_PROXY

# 只确认密钥变量是否存在，不打印完整值
test -n "$OPENAI_API_KEY" && echo OPENAI_API_KEY=set || echo OPENAI_API_KEY=empty

回退时不要把完整 OPENAI_API_KEY、ANTHROPIC_AUTH_TOKEN 或 GEMINI_API_KEY 打印出来。需要求助时，只提供变量是否存在、Base URL、错误码和脱敏令牌片段。

检查完成后做什么

如果上面的检查都通过，你可以继续选择工具教程：

CC Switch

最适合新手，减少手写配置。

Claude Code

使用根地址，重点避免 /v1。

Codex CLI

OpenAI 兼容配置，通常使用 /v1。

完成标准

检查项	应该看到什么	不满足时先处理
终端可用	能执行 `curl --version` 或对应系统的 curl 检查。	安装终端工具或换一个终端应用。
6星中转域名可达	`curl -I "https://www.6xin.cc"` 能返回 HTTP 头。	网络、代理、DNS、公司网络策略。
令牌基本可用	`/v1/models` 能返回模型列表或明确的权限错误。	令牌格式、分组、余额。
环境变量生效	在启动工具的同一终端里能读到对应变量。	shell 配置文件、终端窗口、项目级覆盖。
知道下一步	能根据工具选择 CC Switch、Claude Code、Codex CLI 或 Cherry Studio 教程。	工具接入总览。

环境检查仍然失败时，提交这些定位信息

环境问题最怕把浏览器、终端、代理和工具配置混在一起。提交问题前，先按下面格式整理结果，完整令牌只保留脱敏片段。

信息	怎么收集	说明
系统与终端	系统版本、终端名称、shell 类型，外加 `curl --version` 是否成功。	用于判断是命令缺失、Shell 配置还是系统证书问题。
网络结果	`curl -I "https://www.6xin.cc"` 的状态码或错误摘要。	只贴状态码和错误行，不需要贴完整证书链。
代理变量	`HTTPS_PROXY`、`HTTP_PROXY`、`ALL_PROXY` 是否设置。	代理地址可保留主机和端口，涉及内部网络时先脱敏。
令牌预检	`/v1/models` 的 HTTP 状态码、目标模型是否出现在列表里。	令牌只提供前 6 位和后 4 位，不能贴完整值。
失败范围	浏览器失败、终端失败、某个 CLI 失败，还是只有某个项目失败。	范围越清楚，越容易判断是本机网络、项目覆盖还是工具配置。