文档中心

主题

Linux/WSL2 配置说明 ​

本文介绍如何在 Linux 或 WSL2 系统上配置 Claude Code。

设置环境变量 ​

配置 Claude Code 环境变量，让 Claude Code 连接到你的中转服务。

方法一：通过 Shell 配置文件设置（推荐） ​

根据你使用的 Shell，编辑对应的配置文件。

Bash（最常用） ​

编辑 ~/.bashrc 文件：

bash
# 打开配置文件
vim ~/.bashrc

# 或使用 nano
nano ~/.bashrc

在文件末尾添加以下内容：

bash
# Claude Code 环境变量
export ANTHROPIC_BASE_URL="你的apiUrl"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

保存后，重新加载配置：

bash
source ~/.bashrc

Zsh ​

编辑 ~/.zshrc 文件：

bash
# 打开配置文件
vim ~/.zshrc

# 或使用 nano
nano ~/.zshrc

在文件末尾添加以下内容：

bash
# Claude Code 环境变量
export ANTHROPIC_BASE_URL="你的apiUrl"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

保存后，重新加载配置：

bash
source ~/.zshrc

Fish ​

编辑 ~/.config/fish/config.fish 文件：

bash
# 打开配置文件
vim ~/.config/fish/config.fish

在文件末尾添加以下内容：

fish
# Claude Code 环境变量
set -x ANTHROPIC_BASE_URL "你的apiUrl"
set -x ANTHROPIC_AUTH_TOKEN "你的API密钥"

保存后，重新加载配置：

bash
source ~/.config/fish/config.fish

方法二：使用 CC-switch 工具 ​

你也可以下载 CC-switch 工具来快速配置环境变量。

下载地址：CC-switch

验证配置 ​

设置完成后，重新打开终端，运行以下命令验证：

bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

如果显示了正确的值，说明配置成功。

重要提示 ​

  • 环境变量值中包含特殊字符时，请用引号包裹
  • 修改配置文件后需要重新打开终端或运行 source 命令
  • 确保变量名完全一致，区分大小写
  • 获取 apiUrl 和 API 密钥：导航栏 → 我的 → 账户信息概览 → Claude Code 配置

其他配置 ​

设置编辑器 ​

配置默认编辑器：

bash
claude config set editor "vim"

或使用 VS Code：

bash
claude config set editor "code"

在 WSL2 中，您可以使用 Windows 的 VS Code：

bash
claude config set editor "code-insiders"

设置模型 ​

选择使用的 Claude 模型：

bash
claude config set model "claude-sonnet-4-5"

配置文件位置 ​

Linux/WSL2 上的配置文件位于：

~/.claude/config.json

Shell 集成 ​

为了更好的体验，您可以将 Claude 集成到您的 shell 中。

对于 Bash：

bash
echo 'eval "$(claude shell-init bash)"' >> ~/.bashrc
source ~/.bashrc

对于 Zsh：

bash
echo 'eval "$(claude shell-init zsh)"' >> ~/.zshrc
source ~/.zshrc

对于 Fish：

bash
echo 'claude shell-init fish | source' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

WSL2 特殊配置 ​

访问 Windows 文件 ​

在 WSL2 中，您可以访问 Windows 文件系统：

bash
cd /mnt/c/Users/YourUsername/

Git 配置 ​

建议在 WSL2 中配置独立的 Git：

bash
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

常见问题 ​

如有问题，请查看 常见问题解答。