[Troubleshooting] Free-Claude-Code

2026-04-24 10:53:44   2026-04-24 10:53:44
Categories Troubleshooting
Tags

223 Words   |   1 Minutes

https://github.com/Alishahryar1/free-claude-code

实测 nvidia 的 api 反应极慢，最终买了 opencode go…

Prerequisites

1. Get an API key (or use LM Studio / llama.cpp locally):
   • NVIDIA NIM: build.nvidia.com/settings/api-keys
2. Install Claude Code and uv

brew install claude-code
brew install uv

Install as a Package (no clone needed)

uv tool install git+https://github.com/Alishahryar1/free-claude-code.git
uv tool update-shell
fcc-init        # creates ~/.config/free-claude-code/.env from the built-in template

Edit ~/.config/free-claude-code/.env with your API keys and model names:

NVIDIA_NIM_API_KEY="nvapi-your-key-here"

MODEL_OPUS="nvidia_nim/qwen/qwen3-next-80b-a3b-thinking"
MODEL_SONNET="nvidia_nim/qwen/qwen3-coder-480b-a35b-instruct"
MODEL_HAIKU="nvidia_nim/stepfun-ai/step-3.5-flash"
MODEL="nvidia_nim/z-ai/glm-5.1"

# Global switch for provider reasoning requests and Claude thinking blocks.
ENABLE_THINKING=true

ANTHROPIC_AUTH_TOKEN="your-auth-token"

Edit ~/.zshrc:

# Switch Claude Code

function cc-ecnu() {
    # ChatECNU Anthropic API Config
    export ANTHROPIC_BASE_URL="https://chat.ecnu.edu.cn/open/api/anthropic"
    export ANTHROPIC_AUTH_TOKEN="your-auth-token"
    echo "Switched to ChatECNU"
}

function cc-free() {
    export ANTHROPIC_BASE_URL="http://localhost:8082"
    export ANTHROPIC_AUTH_TOKEN="your-auth-token"
}

cc-free

then:

free-claude-code    # starts the server

To update:

uv tool upgrade free-claude-code