切换主题
Claude Code · Windows 使用指南
Claude Code 可在原生 Windows PowerShell 或 WSL 中通过 Anthropic 兼容网关连接吉格api。
(一)安装 Claude Code
在 PowerShell 中运行官方安装命令:
powershell
irm https://claude.ai/install.ps1 | iex1
也可以使用 WinGet:
powershell
winget install Anthropic.ClaudeCode1
确认安装:
powershell
claude --version1
WSL
如果在 WSL 中使用 Claude Code,请按 Linux 指南配置。Windows 与 WSL 的主目录和环境变量彼此独立。
(二)接入吉格api
方法一:配置文件(推荐)
创建或编辑:
text
%USERPROFILE%\.claude\settings.json1
写入:
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
确认文件名是 settings.json,而不是被记事本保存成 settings.json.txt。
方法二:环境变量
当前 PowerShell 会话:
powershell
$env:ANTHROPIC_BASE_URL = "https://chickener.cc.cd"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "YOUR_MODEL_ID"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "YOUR_SMALL_MODEL_ID"1
2
3
4
2
3
4
写入用户环境变量:
powershell
setx ANTHROPIC_BASE_URL "https://chickener.cc.cd"
setx ANTHROPIC_AUTH_TOKEN "YOUR_API_KEY"
setx ANTHROPIC_MODEL "YOUR_MODEL_ID"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "YOUR_SMALL_MODEL_ID"1
2
3
4
2
3
4
setx 只对之后新开的终端生效。
指定模型(可选)
ANTHROPIC_MODEL:主模型。ANTHROPIC_DEFAULT_FABLE_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL:对应模型类别的映射。ANTHROPIC_DEFAULT_HAIKU_MODEL:后台轻量任务使用的模型映射。
旧变量 ANTHROPIC_SMALL_FAST_MODEL 已弃用。模型值统一从模型广场复制。
如需使用 x-api-key,可将 ANTHROPIC_AUTH_TOKEN 换成 ANTHROPIC_API_KEY,不要同时设置。
(三)开始使用
powershell
cd C:\path\to\project
claude1
2
2
进入后运行:
text
/status1
确认 Base URL、认证变量和模型符合当前配置,再发送一条普通消息。
Windows 常见问题
PowerShell 阻止脚本执行
只在安装或启动明确提示执行策略问题时运行:
powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned1
修改前请确认命令来源可信。
配置文件没有生效
检查路径是否为 %USERPROFILE%\.claude\settings.json,并在资源管理器中显示文件扩展名,排除 .txt 后缀。
setx 后仍读取不到变量
关闭当前终端并新开 PowerShell。setx 不会更新已经运行的进程。
WSL 中配置无效
WSL 使用自己的 Linux 主目录。请在 WSL 内编辑 ~/.claude/settings.json 或 shell 配置,而不是复用 Windows 文件路径。
返回 401
确认密钥有效,并检查 ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 是否被同时设置或被旧环境变量覆盖。
