切换主题
Claude Code · Linux 使用指南
Claude Code 可通过 Anthropic 兼容网关连接吉格api。本页同样适用于 WSL 中的 Linux 环境。
(一)安装 Claude Code
使用官方安装脚本:
bash
curl -fsSL https://claude.ai/install.sh | bash1
确认安装:
bash
claude --version1
(二)接入吉格api
方法一:配置文件(推荐)
创建或编辑 ~/.claude/settings.json:
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://chickener.cc.cd",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"ANTHROPIC_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_FABLE_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "YOUR_MODEL_ID",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "YOUR_SMALL_MODEL_ID"
}
}1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
用户级配置文件可能包含密钥,不要复制到项目仓库。
方法二:环境变量
Bash 用户将以下内容加入 ~/.bashrc:
bash
export ANTHROPIC_BASE_URL="https://chickener.cc.cd"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="YOUR_MODEL_ID"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="YOUR_SMALL_MODEL_ID"1
2
3
4
2
3
4
重新加载:
bash
source ~/.bashrc1
Zsh 用户写入 ~/.zshrc 并运行 source ~/.zshrc。
指定模型(可选)
ANTHROPIC_MODEL:主模型。ANTHROPIC_DEFAULT_FABLE_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL:对应模型类别的映射。ANTHROPIC_DEFAULT_HAIKU_MODEL:后台轻量任务使用的模型映射。
从模型广场复制真实模型 ID。旧变量 ANTHROPIC_SMALL_FAST_MODEL 已弃用。
如需 x-api-key 鉴权,可把 ANTHROPIC_AUTH_TOKEN 改为 ANTHROPIC_API_KEY,但不要同时配置。
(三)开始使用
bash
cd /path/to/project
claude1
2
2
进入后运行:
text
/status1
确认 Base URL 为 https://chickener.cc.cd,并检查认证变量和模型设置。
常见问题
安装后提示 claude: command not found
重新打开 shell,并根据安装器输出检查 PATH。不要直接假设 Claude Code 一定安装在某个固定目录。
环境变量没有生效
确认当前 shell 类型,并编辑对应的 ~/.bashrc 或 ~/.zshrc。运行 source 后再启动新的 Claude Code 进程。
WSL 中读取了错误配置
WSL 和 Windows 使用不同主目录。请在 WSL 内创建 ~/.claude/settings.json,并在 WSL 终端中设置环境变量。
返回 401
确认密钥有效,并检查是否同时存在 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY。保留错误中的 request id 便于排查。
自动模型列表中没有目标模型
Claude Code 的网关模型发现对模型 ID 有命名前缀限制。继续手工设置 ANTHROPIC_MODEL=YOUR_MODEL_ID 即可,不要据此判断模型一定不可用。
