Claude Code is Anthropic’s official command-line interface for Claude, providing direct AI assistance from your terminal for software development, code analysis, and programming tasks.

LLM Model

We are using the GLM-5.2 model (by Z.AI) with a 1M context window — the latest generation. The API is served through our own gateway at https://claude.matsci.dev via Sub2API.

Installation

System Requirements

  • OS: macOS 10.15+, Ubuntu 20.04+/Debian 10+, or Windows 10+ (with WSL/Git for Windows)
  • Hardware: 4GB+ RAM
  • Software: Node.js 18+ (for NPM installation)
  • Network: Internet connection required

Standard Installation

macOS Installation

Homebrew (Recommended):

brew install --cask claude-code

curl Script:

curl -fsSL https://claude.ai/install.sh | bash

NPM Install (All Platforms)

npm install -g @anthropic-ai/claude-code

API Configuration

Claude Code uses our group’s Sub2API gateway for AI models (GLM and DeepSeek). See Model API Setup (Sub2API) for detailed instructions on getting your API key and configuring models.

Quick Configuration

After getting your API key from the Sub2API portal, add these to your ~/.bashrc or ~/.zshrc:

export ANTHROPIC_BASE_URL="https://claude.matsci.dev"
export ANTHROPIC_AUTH_TOKEN="API-KEY"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2[1m]"

Or set models in ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2[1m]"
  }
}

Enabling 1M Context

The [1m] suffix activates GLM-5.2’s 1M token context window. You also need to set CLAUDE_CODE_AUTO_COMPACT_WINDOW to 1000000.

Warning

Replace API-KEY with your actual Sub2API key.

See the Model API Setup page for the full model table and HPC network tunneling instructions.

# Using autossh (install it first if needed)
autossh -M 0 -f -N -o "ServerAliveInterval 30" -o "ServerAliveCountMax 3" \
  -R 13000:claude.matsci.dev:443 <user>@<bastion-host>

Tip

Contact the computer officer for the bastion host details and your SSH key setup.

Apply Changes

After adding the environment variables, restart your terminal or run:

# For bash
source ~/.bashrc
 
# For zsh
source ~/.zshrc

Verification

Verify your installation:

claude --version

Updates

  • Auto updates are enabled by default
  • Manual update: claude update

Basic Usage

# Start in your project directory
cd /path/to/your/project
claude

Best Practices

Project Setup

  • Create CLAUDE.md files for project context and instructions
  • Be specific in your requests and provide relevant context
  • Use /clear to manage conversation context when needed

Effective Workflows

  • Explore, plan, code, commit: Research first, then plan before implementing
  • Use screenshots for visual feedback and UI development
  • Iterative development: Start simple and refine gradually

Advanced Features

  • Git integration: Automatic commit messages and PR assistance
  • Multi-file operations: Work across your entire codebase
  • Custom commands: Create slash commands in .claude/commands/

Security

  • API credentials are provided by the computer officer for group members
  • Store environment variables securely and never share them
  • Do not commit credentials or .bashrc/.zshrc files to version control
  • Always review AI-generated code before committing

References

Next Steps

Ready for Advanced Features?

Once you’re comfortable with basic Claude Code usage, extend its capabilities with MCP (Model Context Protocol) tools:

  • Claude Code with MCP Tools - Add email, calendar, and document processing capabilities
  • Complete research automation workflows can be documented here later if the group develops a stable process.

Common Research Applications

  • Code debugging and optimization for Python scripts
  • Job script generation for HPC clusters
  • Container setup for Docker reproducible research
  • Automated testing and code review workflows
  • Git and Github - Version control integration
  • Conda - Python environment management
  • Docker - Container-based development
  • HPC - HPC job optimization